Installation of the Radial Velocity Analysis (External) Package --------------------------------------------------------------- The external version of the IRAF radial velocity package, named RVX, is being distributed separately from the IRAF V2.10.3 distribution for users on platforms that have not yet been upgraded to V2.10.3 or who require a bug fix. This package includes precompiled binaries for certain popular systems or those that may have compiler incompatability problems (e.g. Silicon Graphics running IRIX 5.2 or Solaris systems with V3 compilers). Once the package is installed the unneeded binaries should be removed. The method you use to copy the file (or remotely access the tar file) is OS dependent and is not discussed in this document. If you have any questions, please contact the IRAF HOTLINE (602-323-4160) or the author at 602-325-9387 (or fitz@noao.edu or 5355::fitz). [1] The package is distributed as a compressed 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 140.252.1.1 login: anonymous password: [your last name] ftp> cd iraf.old ftp> get readme.rvx ftp> binary ftp> get rvx.tar.Z ftp> quit % ls -l *rvx* -rw-r--r-- 1 iraf 5024 Apr 1 15:40 readme.rvx -rw-r--r-- 1 iraf 280843 Apr 1 15:40 rvx.tar.Z % uncompress rvx.tar The readme.rvx file contains these instructions. Special arrangements can be made for sites that don't have access to internet but could copy the uncompressed archive over SPAN. [2] Create a directory to contain the RVX 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:[rvx] (VMS) or /local/rvx/ (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 commands: $ set def irafhlib # VMS example % cd $hlib # UNIX example Define the environment variable rvx to be the pathname to the rvx root dir- ectory. The '$' character must be escaped in the VMS pathname; UNIX path- names must be terminated with a '/'. Edit extern.pkg to include: reset rvx = usr\$1:[rvx] # VMS example reset rvx = /local/rvx/ # UNIX example task rvx.pkg = rvx$rvx.cl Near the end of the hlib$extern.pkg file, update the definition of helpdb so it includes the rvx help database, copying the syntax already used in the string. Add this line before the line containing a closing quote: ,rvx$lib/helpdb.mip\ [4] Log into the CL from the IRAF account and unpack the archive file. Change directories to the RVX root directory created above and use 'rtar': cl> cd rvx cl> softools cl> rtar -xrf where is the host name of the archive file or the IRAF tape device for tape distributions. On VMS systems, an error message will appear ("Copy 'bin.generic' to './bin fails") which can be ignored. Also on VMS systems, the four bin.'mach' directories created by rtar under [newimred.bin] can be deleted. UNIX sites should leave the symbolic link 'bin' in the RVX root directory pointing to 'bin.generic' but can delete any of the bin.`mach' directories that won't be used. The archive file can be deleted once the package has been successfully installed. [5] When the archive has been unpacked, build the RVX package executable. The compilation and linking of the RVX package is done using the following command: cl> mkpkg -p rvx update >& rvx.spool & NOTE: On systems that concurrently support different architectures (e.g., Suns, Convex), you must configure the system for the desired architecture before issuing the above command. SUN/IRAF sites must execute a pair of 'mkpkg' commands for each supported architecture type. The Unix environment variable IRAFARCH must be set as well before compiling. For example: # Assuming IRAFARCH is set to ffpa cl> mkpkg -p rvx ffpa cl> mkpkg -p rvx update >& rvx.ffpa & cl> mkpkg -p rvx f68881 # Now reset IRAFARCH to f68881 before continuing cl> mkpkg -p rvx update >& rvx.f68881 & The spool file(s) should be reviewed upon completion to make sure there were no errors. [6] This version of the package contains new package parameters so you will need to unlearn them by doing the following once it is built: cl> delete uparm$rvx*.par cl> delete uparm$clervx.par Note also that if the package was previously installed, you will need to re-edit the hlib$extern.pkg file and remove the leading '$' from the "task rvx.pkg = ..." definition. --------------------------- BUGS FIXED BY THIS RELEASE: --------------------------- NUMBER: 264 MODULE: rv.fxcor SYSTEM: V2.10 DATE: Thu Oct 13 15:32:33 MST 1994 FROM: fitz BUG: The batch processing code was not initializing the task structure properly and a "Memory has been corrupted" error can occur when processing in batch and the template spectrum has to be rebinned. The bug is not seen if it's the object spectrum that is rebinned. Possible workarounds include rebinning the data to a common disp- ersion and starting wavelength before correlating, setting the 'rebin' parameter to force it to rebin to the object's dispersion, or else just process interactively. The code change is trivial for sites who wish to fix it. STATUS: Fixed in versions after V2.10.3beta.