RVSAO -- An IRAF package to obtain radial velocities from spectra
 
The package RVSAO defined in this directory was developed by Doug Mink at
the Harvard-Smithsonian Center for Astrophysics from the redshift package
originally written by Gerard Kriss at Johns Hopkins University and modified
significantly by Steve Levine at the University of Wisconsin.  It obtains
radial velocities and velocity dispersions using cross-correlation methods
or emission line fits.  It consists of six tasks: XCSAO, EMSAO, BCVCORR,
SUMSPEC, LINESPEC, and EQWIDTH.  If you have any problems, please contact
Doug Mink, mink@cfa.harvard.edu.
A task, RELEARN, has been provided to aid in updating parameters.  Run it
instead of UNLEARN to keep your current parameters settings while adding
new parameters.

After the Revision Notes, you will find installation instructions.

A fairly complete description of this package has been published in the
August 1998 issue of the Publications of the Astronomical Society of the
Pacific.  For further updates, see http://tdc-www.harvard.edu/iraf/rvsao/

***************************************************************************

2.4.7 December 8, 2005

2.4.7 December 8 2005
EQWIDTH: Fix bug when computing flux with fit continuum
XCSAO,EMSAO:  Force renormalization if -1 < spectrum < 1, not if max < 1
getimage.x: Do not append aperture to name if =0

2.4.6 August 22, 2005
XCSAO,EMSAO: Print ZXC, ZEM, and Z in header

2.4.5 July 28, 2005
EQWIDTH: Print multiple output streams; print zeroes if no flux or offscale.

2.4.4 July 14, 2005
EMSAO: Fix two erroneous calls to mfree() which worked OK in Solaris, not Linux

2.4.3 May 19 2005
EMSAO: Add mode 11 to print line shifts in pixels
EMSAO: Print 3 decimal places in modes 3, 6, 9, 11
EMSAO,XCSAO,SUMSPEC: Add pixshift argument to rebin() and rebinl() for
calibration adjustments and compute needed wavelength vectors
rebin.x: Add pixshift argument to adjust calibration in rebin() and rebinl()
wlcon.x: Add wcs_pixshift() and wcs_getshift() and pixel shift in conversions

2.4.2 March 23, 2005
SUMSPEC: Add constant graph scaling

2.4.1 March 16, 2005
BCVCORR: Fix bug so decimal RA's are correctly converted to hours
compbcv.c: Fix bug so decimal RA's are correctly converted to hours

This is an *important* fix for anyone who cares about radial velocity
accuracy to better than 100 km/sec and has RA and DEC in decimal
degrees in their spectrum headers as the magnitude of the fix can be
over 40 km/sec.

2.4.0 February 23, 2005
EQWIDTH: Debug and add net flux and various possible ways to scale it
BCVCORR: Fix bug so keyword values for position and date can be used

See the NEWS file for the earlier history of the software.

***************************************************************************

To install this package in your local IRAF system, take the following steps:
 
1)	The package is distributed as a tar archive; IRAF is distributed
	with a tar reader.  The tar archive may be obtained by magnetic
	tape or anonymous ftp.  For magnetic tape go to step [2] and when
	reading the tar archive simply mount the tape and use the tape
	device name for the archive name in step [4].  To obtain the package
	via ftp (assuming a UNIX computer):

	    % ftp cfa-ftp.harvard.edu
	    login: anonymous
	    password: [your user name]
	    ftp> cd pub/iraf
	    ftp> get rvsao-2.4.6.readme
	    ftp> binary
	    ftp> get rvsao-2.4.6.tar.gz
	    ftp> quit
	    % ls -l
	    -rw-r--r--  1 mink          xxxx xxx xx xx:xx rvsao-2.4.6.readme
	    -rw-r--r--  1 mink        xxxxxx xxx xx xx:xx rvsao-2.4.6.tar.gz
	    %

2)	Create a directory to contain the RVSAO external package files.  This
	directory should be outside the IRAF directory tree and must be owned
	by the IRAF account.  In the following examples, this root directory
	is /local/rvsao/.  Make the appropriate file name substitutions for
        your site.
 
3)	Log in as IRAF and edit the extern.pkg file in the hlib directory to
	define the package to the CL.  From the IRAF account, outside the CL,
	you can move to this directory with the command:

            % cd $hlib

	Define the environment variable rvsao to be the pathname to the rvsao
	root directory.  UNIX pathnames must be terminated with a '/'.
	Edit extern.pkg to include:

            reset rvsao	= <directory>/rvsao-2.4.6/
            task  rvsao.pkg   = rvsao$rvsao.cl

	or, to avoid conflicts with earlier versions or the IRAF rv package,

            reset r2rvsao	= <directory>/rvsao-2.4.6/
            task  r2rvsao.pkg   = r2rvsao$r2rvsao.cl
 
	Near the end of the hlib$extern.pkg file, update the definition
	of helpdb so it includes the rvsao help database, copying the syntax
	already used in the string.  Add this line before the line containing
	a closing quote:
 
	    ,rvsao$lib/helpdb.mip\

	or, if using r2rvsao,
 
	    ,r2rvsao$lib/helpdb2.mip\
 
4)      Add to hlib$clpackage.men the package description:
 
            rvsao - Radial velocity package from SAO
 
	or, if using r2rvsao,
 
            r2rvsao - Radial velocity package from SAO
 
5)	Unpack the tar file into the RVSAO root directory.

	On a UNIX system, where ftpdir is the pathname of the directory
	into which the package was ftp'ed and rvsao is the RVSAO root
	directory:
	    % cd $rvsao (or $r2rvsao)
	    % cd ..
	    % zcat $ftpdir/rvsao-2.4.6.tar.gz | tar xvf -

	The archive file can be deleted once the package has been
	successfully installed.
 
6)      Restart IRAF and "cd rvsao" or "cd r2rvsao".

7)	Symbolically link the appropriate binary directory to bin.
	bin is originally linked to bin.generic for distribution.

        On a SPARCstation running SunOS 4.*, type
	    cl> mkpkg sparc

        On a PC running Redhat Linux, type
	    cl> mkpkg redhat

        On a DEC Alpha running Digital Unix, type
	    cl> mkpkg alpha

        On a PC running Linux, type
	    cl> mkpkg linux

	For other architectures, make a directory of the proper bin.{arch}
	name, and link it to bin

8)      Make the package by typing
	    cl> mkpkg update >&spool

	The spool file should be reviewed upon completion to make sure
	there were no errors.

9)	Up-to-date hypertext help is available on the World Wide Web at

	http://tdc-www.harvard.edu/iraf/rvsao/
