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 five tasks: XCSAO, EMSAO, BCVCORR, SUMSPEC, and LINESPEC. If you have any problems, please contact Doug Mink, mink@cfa.harvard.edu. This package has not been tested on a VMS system. 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.2.5 February 5, 2002 Ignore pixels with values less than MIN_PIXEL_VALUE at ends of spectra Replace pixels with values less than MIN_PIXEL_VALUE elsewhere in spectra In compbcv.x, allow use of new keywords OBS-LONG, OBS-LAT, and OBS-ELEV 2.2.4 September 19, 2001 Add 10th result reporting mode to EMSAO with line info only. Drop SPECDIR from file name in headings Fix units check in getimage() 2.2.3 July 31, 2001 Change cross-correlation velocity information in header when template changed interactively in EMSAO and XCSAO using the 't' cursor command. Fix pixel cross-correlation so it works. Add option to ignore zeroed pixels in continuum fit and removal Add option in SUMSPEC to remove continuum after rebinning (contout) Add option in SUMSPEC to write each input file to a separate output file (composite file name is "") Separate LINESPEC and SUMSPEC source directories from Makespec into Linespec and Sumspec, with shared tasks into Util 2.2.2 March 28, 2001 Fix EMSAO and plotspec.x in several places to deal with right-to-left spectra. Plot text info after spectrum in EMSAO so it all displays on xgterm. 2.2.1 February 9, 2001 Fix bug in EMSAO so emission line structures are always initialized correctly Fix bug in XCSAO to deal with right-to-left dispersion Print aperture separately in XCSAO mode 12 report and EMSAO one-line reports 2.2.0 September 13, 2000 Add options to XCSAO to cross-correlate in wavelength and pixel space by changing the "correlate" parameter into a string. Allow pixel or wavelength limits to be specified for templates in XCSAO so several pieces of a single template spectrum, such as emission lines, may be correlated against an object spectrum. Add two new reporting modes to EMSAO, 8 to print wavelength information about fit emission lines on one line and 9 to print only wavelength shifts on one line. See the Revisions 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.2.5.readme ftp> binary ftp> get rvsao-2.2.5.tar.Z ftp> quit % ls -l -rw-r--r-- 1 mink xxxx xxx xx xx:xx rvsao-2.2.5.readme -rw-r--r-- 1 mink xxxxxx xxx xx xx:xx rvsao-2.2.5.tar.Z % 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 named usr1:[rvsao] (VMS) or /local/rvsao/ (UNIX). 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 = /rvsao-2.2/ task rvsao.pkg = rvsao$rvsao.cl or, to avoid conflicts with earlier versions or the IRAF rv package, reset r2rvsao = /rvsao-2.2/ 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.2.5.tar.Z | 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 SPARCstation running Solaris 2.*, type cl> mkpkg ssun 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/