External SPECROAD: Installing E-SPECROAD

Installing External SPECROAD

These instructions, while geared toward astronomers using to the MacOS X environment, are fairly portable to other *nix type environments. I have personally gotten working installations of E-SPECROAD on

• MacOS 10.5.x or later using Scisoft OSX to provide the IRAF installation and MacPorts for some additional packages. The instructions below outline everything you need to do to get this running.
• Scientific Linux 5.3 or later using ESO Scisoft 7 to provide the IRAF installation, although again this required some work to get Scisoft installed. (*) This process was considerably easier than getting things working under Fedora Core 9.
• Fedora Core 9 Linux (both 32 and 64-bit versions) using ESO Scisoft 7 to provide the IRAF installation, although this required some work to get Scisoft (**) Once you get Scisoft installed properly, you can continue below without much pain.

I've tried to make these notes as easy to follow as I can, however I do assume a certain level of comfort with the command line environment as well as familiarity with disk permissions and how/when to use the sudo command in conjunction with what you see below.

Pre-Installation Instructions

I will start off by telling you everything you need to do before you can even expect External SPECROAD (E-SPECROAD) to work. This breaks down to making sure before you even attempt installing the software related to E-SPECROAD you have to have

1. A functional X-windows *nix-based operating system.
2. Functional versions of the tcsh and ksh shells installed. I highly recommend using tcsh as your default environment as that is what I have assumed. However, if you are talented enough to set up the proper environmental variables in your preferred shell, you should be OK.
3. A functional installation of IRAF 2.12 or later (including X11IRAF). It is probably preferable to have IRAF 2.14 or later.
4. For Mac users, the g77 compiler must be installed and in your command path. Linux users can skip this as long as they have a complete gcc and glibc environment (all developer packages too). IRAF on linux uses f2c,which is included in the default IRAF distribution. If you using 64-bit linux, see notes below in the section on compiling IRAF packages.
   

Once you get your computer to meet these requirements, installing all the software for running External SPECROAD is fairly straightforward. If your computer meets these requirements, you can probably skip the pre-installation instructions for the most part.

1. My assumptions about your Computer.
   1. Using a Macintosh? You must be running MacOS 10.4.x or higher. You must have also installed the optional X11 support on the Mac if you are running MacOS 10.4. If you are running MacOS 10.5, I would strongly suggest you consider installing XQuartz over the X11 installed by the OS, but it is not critical. I've only extensively tested these E-SPECROAD scripts under MacOS 10.5, but there is nothing I can think of that prevents them from running on a Mac running MacOS 10.4.x.
   2. Using a Linux/BSD/SunOS Computer? The E-SPECROAD scripts should run on any operating system with a Linux/BSD/SunOS interface as long as that computer meets the requirements outlined above. In fact,as noted above, these scripts have been made to run under Scientific Linux 5.3 using ESO Scisoft 7.3.1 and both 32 and 64-bit versions of Fedora Core 9 Linux using ESO Scisoft 7.1.
      
      
2. Switch your default shell to tcsh. IRAF really want to run in tcsh instead of bash, the default shell on most modern *nix distributions. On most systems, you can change your default shell by typing:
   
   chsh -s /bin/tcsh
   
   on the command line. You may want to check with your system administrator if tcsh isn't installed. I have confirmed this works on a MacOS X Leopard (10.5) machine. For earlier MacOS X versions, you may have to run NetInfo manager to change your default shell to /bin/tcsh .
   
   
3. If you haven't already done so, install IRAF including X11IRAF (preferably version 2.14, but it should run on 2.12) on your computer and get your user account set up to use it.
   1. For the Intel-based Mac, the easiest way to get IRAF running is to either use Macros Huerta's IRAF package based installer or to use Scisoft OSX . I personally prefer using Scisoft OSX because it doesn't require futzing around with my account settings.
   2. If you have a PPC-based Mac, you can install IRAF 2.14, but I believe you will have to follow the instructions on IRAF.net for installing IRAF manually. Older versions of IRAF are available in the last PPC compatible version of Scisoft OSX and in Macro's Huerta's package based installers.
   3. For Linux computers, there are a variety of installation options available for IRAF. I personally find ESO Scisoft 7 to be the easiest way to install IRAF, at least on Fedora Core Linux and Scientific Linux machines. It installs IRAF 2.14 (as of ESO Scisoft version 7.3.1), along with a lot of other software that might be useful to you as an astronomer, in a few minutes. If you use another distribution of Linux or another *nix operating system, investigate IRAF.net for information on manually installing IRAF.
      
      
4. Tweaking your IRAF installation to use enough memory: Once you get your personal IRAF work area set up, open the login.cl configuration file in a text editor and change the line reading
   
   set min_lenuserarea = 64000
   
   to read
   
   set min_lenuserarea = 200000
   
   This ensures you have enough memory set aside for hcal to run properly. If you do not do this, hcal will terminate with "ERROR: Out of space in image header." Thanks to Megan Bagley for catching this requirement!
   
   
5. Testing your IRAF installation: Make sure you have set up IRAF so that you can run 'ecl' and so IRAF's environmental variables are loaded in your command line environment. If everything works
   1. You should be able to go to your IRAF directory and type "ecl" to launch IRAF.
   2. You should be able to type "cd $hlib" and go to one of the IRAF configuration directories.
   3. You should be able to type "xgterm" and have an xgterm terminal window launch. If it doesn't launch it could either be an indication of an IRAF installation problem or an X-windows configuration problem. If you are using MacOS 10.4.x, check an make sure you have the DISPLAY environmental variable set (e.g. - the .tcshrc file contains "setenv DISPLAY :0.0") and that the X11.app (located in the /Applications/Utilities) application is running. If you are running MacOS 10.5.x, make sure the DISPLAY variable is NOT set.
      
      
6. Download and install g77 for the Mac from the High Performance Computing for Mac OS X website. You will need it to properly compile some IRAF packages. To make sure it is in your $PATH and to get it to behave like f77, add the following lines to the end of your .tcshrc file:
   
   setenv PATH ${PATH}:/usr/local/bin
setenv XC_F77 g77
setenv XC_FFLAGS "-fugly-logint"
   
   WARNING for Linux Users: The above "XC" environmental variables should only be set on the Mac and NOT under Linux. Linux will use the f2c compiler within IRAF.
   
   
7. Download and install properly working versions ksh for the Mac. I'll admit I am not absolutely certain this step is necessary under MacOS 10.5, but under MacOS 10.4 I observed that the ksh that was provided with the Mac has a serious bug in the handling of file lists that prevents SPECROAD from working. You need a properly working ksh on the Mac if you want to run SPECROAD on the Mac. The easiest way to do this is to install MacPorts, and then, after properly configuring your .tcshrc to add support for MacPorts, type:
   
   sudo port install ksh93
   
   and after some work, you should have properly functioning ksh installed. Installing MacPorts also allows you to install many other applications with their origins in the linux community fairly easily.
   

Installing the Hectospec Software

The Smithsonian Astrophysical Observatory does provide most of the software necessary to reduce Hectospec data and you need to download and install it.

6. You might want to take a moment here and make sure you have disk permissions set properly to allow you to write to /usr/local as that is where we will be installing almost everything we need. If /usr/local doesn't exist, create it with permissions to allow you to write to it.
   
   
7. Create a /usr/local/iraf directory to install additional IRAF packages in. Actually, doesn't matter where you place this directory, I just assume this further down in these instructions. It's pretty easy to pick out where to change things in the next two steps to get another directory to work, just replace mentions of " /usr/local/iraf" with your preferred choice.
   
   
8. Download the IRAF packages you are going to need from the Hectospec data reduction software page. The IRAF packages you need to install include
   1. Hectospec (Version 3.5.8 or later): http://tdc-www.harvard.edu/instruments/hectospec/hectospec-3.5.8.tar.gz
      
      UPDATE RECOMMENDED: I strongly recommend if you have previously installed hectospec that you install version 3.5.8 or later as some significant bugs were fixed.
      
      
   2. MSCRED (Version 4.3 or later): http://tdc-www.harvard.edu/instruments/hectospec/mscdb-4.3.tar.gz
   3. RVSAO (version 2.7.6 or later): http://tdc-www.harvard.edu/iraf/rvsao/rvsao-2.7.6.tar.gz
      
      UPDATE RECOMMENDED: I am using some commands in versions of E-SPECROAD to be released after June 17, 2009 that were introduced in RVSAO version 2.7.6. Furthermore, there were extensive bug fixes that directly apply to E-SPECROAD. I strongly recommend upgrading to RVSAO version 2.7.6 if you haven't already.
      
      
   4. WCSTools (Version 3.7.0 or later): http://tdc-www.harvard.edu/software/wcstools/wcstools-3.7.5.iraf.tar.gz
   5. SVDFit (Version 1.9.2 or later): http://tdc-www.harvard.edu/iraf/svdfit/svdfit-1.9.2.tar.gz
      
      
   You should unpack each of these downloads in the /usr/local/iraf directory.
   
   
9. Create Symbolic Links: To make updating packages less difficult, I would strongly urge you to create symbolic links from "nonversioned" directories to the version-specific directories you unpacked in the /usr/local/iraf directory. That way, if you want to update a package, you just have to change the symbolic link and if the package doesn't work, you get backtrack by changing the symbolic link back. You can create symbolic links from the command line using something like the following (the version numbers may change, and I am assuming the symbolic links do not already exist):
   
   ln -s /usr/local/iraf/hectospec-3.5.8/ /usr/local/iraf/hectospec
ln -s /usr/local/iraf/mscdb-4.3/ /usr/local/iraf/mscdb
ln -s /usr/local/iraf/rvsao-2.7.6/ /usr/local/iraf/rvsao
ln -s /usr/local/iraf/wcstools-3.7.5/ /usr/local/iraf/wcstools
ln -s /usr/local/iraf/svdfit-1.9.2/ /usr/local/iraf/svdfit
   
   
10. Edit the list of external packages IRAF knows about to be aware of these new packages. Start by opening IRAF's extern.pkg file:
    

       cd $hlib
       cp extern.pkg extern.pkg.###### (where ###### is the date)
    

    Now open the extern.pkg file in a text editor and make the following changes:
    1. If you are using the Scisoft OSX IRAF installation, edit the rvsao lines to point to your newly downloaded rvsao package.

          reset   rvsao           = /usr/local/iraf/rvsao/
          task    rvsao.pkg       = rvsao$rvsao.cl
       
       

       and, if it exists, edit the

           #reset  mscdb       = /iraf/extern/mscdb/
       

       to read

           reset   mscdb       = /usr/local/iraf/mscdb/
       

       If you are not using Scisoft OSX, just edit the file to add these lines.
       
       
    2. Add the remaining package lines (or edit them if they exist already)

          reset   svdfit          = /usr/local/iraf/svdfit/
          task    svdfit.pkg      = svdfit$svdfit.cl
       
          reset   wcstools        = /usr/local/iraf/wcstools/
          task    wcstools.pkg    = wcstools$wcstools.cl
       
          reset   hectospec       = /usr/local/iraf/hectospec/
          task    hectospec.pkg   = hectospec$hectospec.cl
       
       

       To make the help files available, edit the 'helpdb' path at the end of the extern.pkg file:

          reset    helpdb      = "lib$helpdb.mip\
                     ,noao$lib/helpdb.mip\
                     ,nlocal$lib/helpdb.mip\
                     ,mscred$lib/helpdb.mip\
                     ,ctio$lib/helpdb.mip\
                     ,stsdas$lib/helpdb.mip\
                     ,vol$lib/helpdb.mip\
                     ,tables$lib/helpdb.mip\
                     ,color$lib/helpdb.mip\
                     ,nmisc$lib/helpdb.mip\
                     ,fitsutil$lib/helpdb.mip\
                     ,gemini$lib/helpdb.mip\
                     ,guiapps$lib/helpdb.mip\
                     ,taxe16$lib/helpdb.mip\
                     ,wcstools$lib/helpdb.mip\
                     ,rvsao$lib/helpdb.mip\
                     ,svdfit$lib/helpdb.mip\
                     ,hectospec$lib/helpdb.mip\
                     "
       

       That last quoteby itself on the last line is important. Also, make sure there are no spaces after the "\" on each of those lines or you will get an error when you launch IRAF that looks something like the following:

       ERROR: Newline while processing string
            called as: `cl ()'
            called as: `cl ()'
            called as: `cl ()'
          Error while reading login.cl file - may need to rebuild with mkiraf
          Fatal startup error.  CL dies.
       

11. Compile all the IRAF Packages you just downloaded. You will need to launch IRAF (via 'cl' or 'ecl') and then compile all the IRAF packages you just downloaded.
    
    WARNING for 64-bit Linux users: If you are running 64-bit Linux, you will need to make sure to use the 32-bit compilers within IRAF. Assuming you have set up IRAF properly, you will need to set it to use 32-bit via the following. First go to the $hlib directory:
    
    cd $hlib (should kick you to something lilke /scisoft/share/iraf/iraf/unix/hlib or something like that)
    
    examine the mkpkg.inc file, it has a bunch of settings for the compiler and linker, the key is to modify the ones run under your brand of linux (Fedora Core is "redhat" here), edit to add "-m32" to the XFLAGS and LFLAGS so they look something like this:
    
$set XFLAGS = "-c -w -m32" # default XC compile flags
$set XVFLAGS = "-c -w" # VOPS XC compile flags
$set LFLAGS = "-Nz -m32" # default XC link flags
    
    
    1. RVSAO (version 2.7.6 or later):To compile RVSAO, just do the following within IRAF:
       
       cd rvsao
mkpkg macintel (replace macintel with macosx if PPC mac, redhat with Fedora Core Linux)
       mkpkg update
       
       If you get no nasty error messages, everything has compiled. If you have used any previous version of RVSAO, you should be aware there were some changes to parameters used by RVSAO functions. As such, I would strongly suggest you follow this install up with an
       
       unlearn rvsao
       
       to reset the parameters for RVSAO. This should avoid conflicts between parameters stored for the old version of RVSAO and the new RVSAO scripts.
       
       
    2. WCSTools (Version 3.7.0 or later): To compile WCSTools, just do the following within IRAF:
       
       cd wcstools
mkpkg macintel (replace macintel with macosx if PPC mac, redhat with Fedora Core Linux)
       
       Scisoft users:Scisoft includes an installation of wcstools as well. It is typically a bit dated though, but since it is there, you need to make sure to place the binaries for this installation of wcstools before the ones for Scisoft's installation in your PATH. More on this below.
       
       64-bit Linux user warning: Before continuing to the next step, edit the CFLAG line in Src/Makefile to add the "-m32" flag to the end of CFLAG so that the compiled binaries are 32-bit.
       
       mkpkg update
       
       If you use WCSTools 3.7.0 through 3.7.3, this command will likely choke at the very end when all the packages are compiled with an error message starting
       
       Lnkbins: Command not found
       
       Linkbins is a script in the Src/ subdirectory, so just type (in IRAF):
       
       !./Src/Linkbins

       and it should create all the symbolic links it needs in the bin/ subdirectory.
       
       
    3. SVDFit (Version 1.9.2 or later): To compile SVDFit, just do the following within IRAF:
       
       cd svdfit
mkpkg macintel (replace macintel with macosx if PPC mac, redhat with Fedora Core Linux)
       mkpkg update
       
       If you get no nasty error messages, everything has compiled and you are set.
       
       
    4. Hectospec (Version 3.5.8 or later): To compile Hectospec, just do the following within IRAF:
       
       cd hectospec
mkpkg macintel (replace macintel with macosx if PPC mac, redhat with Fedora Core Linux)
       mkpkg update
       
       If you get no nasty error messages, everything has compiled. If you are upgrading from a previous version of hectospec, I would strongly suggest that after installing it, relaunch IRAF and type
       
       hectospec
       
       and then
       
       hrelearn
       
       to retrain the parameter files to know about (you may have to hit enter a few time to clear some default filenames, if hrelearn chokes on a numerical parameter, ctrl-C and re-execute it, it should stick on the second pass).
       
       Finally, you have to do one more thing. Hectospec needs to wants its own link to the apextract executable, so you need to place a symbolic link to it in the binary directory of the hectospec package. Do the following from the command line (OUTSIDE of IRAF):
       
       cd /usr/local/iraf/hectospec/bin
       
       [on MacIntel with Scisoft OSX installed (versions of Scisoft OSX Intel after and including 2008.8.1)]
       ln -s /Applications/scisoft/all/packages/iraf/irafbin/noao.bin.macintel/x_apextract.e .
       
       [on PPC Mac with Scisoft OSX installed]
       ln -s /scisoft/iraf-2.12.2/irafbin/noao.bin.macosx/x_apextract.e .
       
       [on Linux box with ESO Scisoft 7 installed]
       ln -s /scisoft/share/iraf/irafbin/noao.bin.redhat/x_apextract.e .
       
       [on other versions of IRAF]
       Find the irafbin/ directory, then place a symbolic link to the the noao.bin/*/x_apextract.e executable in the hectospec/bin directory.
       

At this point, assuming everything has worked, you have all the IRAF utilities you will need to run SPECROAD external installed. Now all you need to do is install some command line programs.

8. Download some command line utilities used by Hectospec.
   1. kfunc:These are some time-manipulation scripts used by SPECROAD. Just download kfunc.tar.gz and in the same directory type:
      
tar -C /usr/local -xzvf kfunc.tar.gz
      
      This will unpack the contents into /usr/local/kfunc. I am assuming you have permission to write to /usr/local, if you don't, fix this before proceeding.
      
      
   2. mktime: Download mktime.tar.gz (CFA mirror) and compile it. This contains some other time-manipulation scripts used by SPECROAD. To compile mktime, go to that directory you downloaded the tarball into and in the command line type:
      
      tar -xzvf mktime.tar.gz
cd mktime-2.3
./configure
make
make tests
      
      And if no errors are reported,
      
      make install
      
      Once you have done this, the "mktime" executable is placed in /usr/local/bin and the manpage is placed in /usr/local/man/man1/.
      
      
   3. starbase: Download starbase 3.3.9 or later (I used 3.3.9 in this example) and unpack it to /usr/local by going to the directory where you downloaded the tarball and typing:
      
tar -C /usr/local -xzvf starbase3.3.9.tar.Z

Before you try to compile the code, you need to be aware of a couple of things. Starbase is a custom database package the SPECROAD scripts use (it manipulates databases stored as ASCII). Starbase requires you to have previously installed either
      1. the stripped down version of the SLAlib positional astronomy library compiled from the source provided in the download (called sla_starbase). This can be compiled via a standard make followed by make install assuming you have permissions to install into /usr/local.
      2. the complete C version of the SLAlib positional astronomy library from TPoint Software. This library is proprietary, but available for free for non-commercial use by contacting Pat Wallace (ptw@tpsoft.demon.co.uk). Pat Wallace would greatly prefer you use the stripped down version of the library that is provided unless you have a compelling reason to get the entire library.
      Once you have an appropriate version of SLAlib installed, go to the directory you have unpacked the command line (assuming you use tcsh) do the following:
      
      Tell starbase where the SLAlib libraries and headers are located. I have them in /usr/local, so:
      
      setenv SLALIB /usr/local/lib/
setenv SLAINC /usr/local/include/
      
      (you can also do this in your .tcshrc file, which is what I do).

Making sure your environment is properly set, you can now compile starbase.
      
cd /usr/local/starbase3.3.9
./configure --prefix=/usr/local/starbase3.3.9
make
make install
      
      Linux Specific Note: If the install fails on a Linux box, make sure you have bison installed.
      
      Now, there is an issue (at least in starbase3.3.9) where the slalink shared library portion of starbase doesn't get built properly, so you need to do the following:
      
      cd /usr/local/starbase3.3.9/slalink
make slalink.so
cp slalink.so ../lib
      
      That will create the shared libary that is called by the starbase program "tawk" in the E-SPECROAD scripts. Once you are done with this, create a symbolic link from /usr/local/starbase to /usr/local/starbase3.3.9 via the command line
      
      ln -s /usr/local/starbase3.3.9 /usr/local/starbase
      
      The E-SPECROAD scripts look in /usr/local/starbase for some of the starbase binaries.
      
      A Quick Note of Thanks to John Roll at SAO who fixed up the starbase code to compile under MacOS 10.5 on Intel Macs.
      
      
9. Tweak your command line environmental settings to be aware of all this code you installed. I modified my .tcshrc file to include the following (and it must do so after any commands that activate Scisoft):
   
   # Setup all local Apps I use
setenv PATH ${PATH}:/usr/local/bin

# Setup IRAF environment (Mac specific)
setenv XC_F77 g77
setenv XC_FFLAGS "-fugly-logint"

# Setup IRAF environment
setenv UPARM ~/iraf/uparm/

# Setup SLALib
setenv SLALIB /usr/local/lib/
setenv SLAINC /usr/local/include/

# Setup SAO's environmental variables commands
setenv PATH /usr/local/starbase/bin/:/usr/local/iraf/wcstools/bin/:${PATH}
setenv PATH ${PATH}:/usr/local/hectoshell/
setenv TABLELIB /usr/local/starbase/lib/
   
   I like to place the starbase bin/ directory at the start of the PATH because 'column' is a common executable name and I really want starbase's version of column to be used. I similarly placed the wcstools bin/ directory before my preexisting PATH so that the newly installed wcstools binaries would be used instead of the ones included with scisoft.
   
   I should also note I have my IRAF settings in a subdirectory of my home directory called 'iraf'. SPECROAD will need to know about where the IRAF parameters are stored, so the UPARM line points to the uparm subdirectory of my personal IRAF directory. Also, /usr/local/hectoshell is where I keep the SPECROAD code, so I have added that to the path above.
   
   WARNING for Linux Users: The above "XC_*" environmental variables should only be set on the Mac and NOT under Linux. Linux will use the f2c compiler within IRAF. Linux users should still set up UPARM to point to their local IRAF parameter directory.
   

Installing E-SPECROAD Itself

OK, you have done most of the hard work if you have gotten this far, at this point, getting E-SPECROAD working on your machine should be fairly staightforward.

10. Install the E-SPECROAD scripts directory (called hectoshell). Start by downloading the following tarball (if more than one is listed, pick the one that makes the most sense):
    
    \n"; foreach ($tgzsmlink as $insert) { print "
11. "; echo $insert; print "\n"; } print "\n"; ?>
    Unpack this directory into /usr/local/hectoshell by going to the directory where you downloaded the tarball and typing (if , for example, you downloaded ):
    
    tar -C /usr/local -xzvf
    
    Hint: As you may have guessed from the filenames, one version of the hectoshell code is aimed at MacOS X and the other Linux (specifically Scientific Linux with /usr/bin/ksh installed and ESO Scisoft 7 version of IRAF installed).
    
    
12. Change the E-SPECROAD scripts to make them work for you. First things first, E-SPECROAD is NOT 100% portable in that just unpacking it is not enough. However, the modifications you may need to perform to get E-SPECROAD running should be fairly minor.
    1. Make sure that all references to 'ksh' point to your version of ksh. Since I am using the MacPorts installed version of ksh, all the ksh scripts in the Macintosh version of the hectoshell start with the line

#!/opt/local/bin/ksh
       
       (The Linux version has this set to #!/usr/bin/ksh, but in Fedora Core Linux it should point to #!/bin/ksh). A good text editor with multi-file search and replace capability (TextWrangler is an example of a free program on the Mac with this capability) should allow you to edit this realtively quickly.
       
       
    2. Make sure all the scripts that call IRAF point to the proper ecl executable. Since I am using /scisoft on an Intel-based Macintosh, The Mac version of these scripts start with the line
       
       #!/scisoft/all/packages/iraf/irafbin/bin.macintel/ecl.e -f
       
       The linux versions assume ESO Scisoft 7 is installed and start with
       
       #!/scisoft/share/iraf/irafbin/bin.redhat/ecl.e -f
       
       Again, a good search and replace of this with a link to the version of ecl you are using should be sufficient.
       
       
13. Some Double-checking for common glitches: Here are some quick double checks you can perform to be sure everything is installed properly before you attempt to use the E-SPECROAD scripts.
    1. Start up a new command line session to load the new .tcshrc you set up. Make sure that the command
       
printenv SHELL
       
       returns something like /bin/tcsh (something ending in tcsh), otherwise, you may have to launch tcsh manually (review step 2 for instructions on changing your default shell).
       
       
    2. Your environment, if properly set up, should allow you to try the following commands. If you get an error in any of these, check your .tcshrc file (review step 9 above).
       1. Typing
          
          printenv UPARM
          
          should return the path to your uparm/ directory.
          
       2. Typing
          
          printenv SLALIB
          
          should return what you configured in your .tcshrc file for this variable.
       3. Typing
          
          printenv SLAINC
          
          should return what you configured in your .tcshrc file for this variable.
          
          
    3. Make sure the starbase version of the column task is the one that you use by default by typing:
       
       which column
       
       The path to the starbase3.3.9 version of column should be returned. If it is the X11 version of column, you need to check that you set up your .tcshrc file properly (review Step 9 above).
       
       
    4. Make sure the version of the wcstools you are using is the one you installed above (instead of a scisoft version), type
       
       which gethead
       
       The path to the version of gethead installed with wcstools above should appear. If it is the scisoft version, you need to change your PATH to have the directory containing your newly install wcstools bin/ directory to preceed the scisoft bin/ path.
       
       
    5. Launch IRAF and confirm you can load the packages you installed by loading the three packages one at a time by typing:
       
       wcstools
rvsao
hectospec
       
       If those packages load, you should be at least minimally OK with the IRAF install.
       
       
14. You should now have a functioning version of E-SPECROAD running on your computer. Please send a short email to if you get a successful installation (or not).
    
    

Footnotes on Insalling SciSoft

Funding: The creation of E-SPECROAD was supported by National Science Foundation Grant AST-0729989 ("RUI: Collaborative Research to Map the Asymmetric Thick Disk").