The following instructions will guide you through making your own personal installation of the `iuetools' package in IRAF. Note that you must also have the STSDAS and TABLES packages installed first. PART 1: First Time Set-Up -------------------------- 1) Copy the iuetools.tar file to a suitable directory and unpack it. I will use the ficticious directory path "/my/path/iuetools/" for this example. % cd /my/path/iuetools/ % tar xvf iuetools.tar 2) Compile the source code. For this step, start an IRAF session and "cd" to the directory where the source code was installed, then run "mkpkg". Following the previous example, the steps would be: cl> cd /my/path/iuetools/ cl> mkpkg -p tables update You will see a warning about the "iuetools.a" file not being found; this is the normal behavior when the object file is first created. After some time the compilation will yield a few new files, notably "x_iuetools.e" which is the executable. If there were no errors, you will be ready to use the "iuetools" package within IRAF after following the directions in Part 2 below. 3) Build the iuetools package help database using the following commands within IRAF, which require first loading the "softools" package: cl> softools cl> cd /my/path/iuetools/lib/ cl> mkhelpdb root.hd helpdb.mip This will create the file "helpdb.mip" within the iuetools$lib/ directory. See the instructions below for getting the IRAF help system to access this new help database for the iuetools package. PART 2: Using the Package -------------------------- Here are the directions for loading and running the `iuetools' package once the package has been installed and built for your machine. You will need to perform the first three steps each time you start a new IRAF session, unless you follow the advice in point 4: 1) Begin an IRAF session and load TABLES. Then "cd" to the directory where the software is kept. In fact, it would be best to define an IRAF environment variable to point to that directory. Using the example directory from 1) above: cl> set iuetools = /my/path/iuetools/ cl> cd iuetools$ And don't forget the trailing slash (/) in the "iuetools" definition! 2) Define the `iuetools' package and load the package with: cl> task iuetools.pkg = iuetools$iuetools.cl cl> iuetools 3) To use the `mxtomultispec' task you will need to load the "STSDAS", "hst_calib", and "onedspec" packages. 4) Now everything should work during this session. In order to avoid having to execute these setup commands each time you enter the IRAF environment, add the following lines to your "loginuser.cl" file. set iuetools = "/my/path/iuetools/" task iuetools.pkg = "iuetools$iuetools.cl" reset helpdb = (envget("helpdb") //",iuetools$lib/helpdb.mip") The 3rd command will add the iuetools help database to the list of IRAF databases that get searched when you execute a "help" command. You may also wish to load the STSDAS, hst_calib, and onedspec packages in your "login.cl" file.