#----------------------------------------------------------------------------- # IRACproc: IRAC Post-BCD Processing v4.3 SETUP #----------------------------------------------------------------------------- (c) 2005 Mike Schuster, Massimo Marengo (mmarengo@cfa.harvard.edu) (c) 2005 SAO - Smithsonian Astrophysical Observatory Harvard-Smithsonian Center for Astrophysics Smithsonian Astrophysical Observatory 10 Dec 2008 Once your system has the required configuration (see System requirements), this software suite should only take a few minutes to install, as very little is needed to configure IRACproc to run. We happen to use pico as our text editor in the examples, though you may use your preferred text editor instead. #----------------------------------------------------------------------------- # Step #1 - System requirements #----------------------------------------------------------------------------- It is assumed that the following are installed on your system: REQUIRED -------- MOPEX (ver. 18.1.5 or newer) Perl (ver. 5.6 or newer) PDL(v2.4.x or newer w/ bad values support enabled) Perl modules (available from search.cpan.org): Astro::FITS::Header Astro::FITS::CFITSIO Note that Perl is normally available in all Unix Systems. PDL is also pre-installed by in most Linux systems, but often is compiled without bad value support (required). Instructions on how to install MOPEX are given below. OPTIONAL -------- SAOimage DS9 [our preference for image display] IRAF [optional features - automated image inspection and photometry package] PDL, or Perldl, is a development environment much like IDL or MATLAB, that is based on Perl and is distributed freely. The software has been tested on the Linux 32 and 64 bit platform, and on the MacOSX 5.x Intel platform. The software can run on both cshell (tcsh) and bash shells. IRACproc may also work under Solaris, but... no guaranties. #----------------------------------------------------------------------------- # Setup #2 - Download and Unpack the IRACproc distribution #----------------------------------------------------------------------------- Download the following files from http://www.cfa.harvard.edu/~mmarengo/IRACproc: * IRACproc-4.3.tar.gz: main IRACproc distribution * IRAC_psfs-2.0.tar.gz: PSF files In the directory where the files are downloaded, run the following commands: user_name][ cp IRAC*.tar.gz user_name][ cd user_name][ tar xzvf IRACproc-.tar.gz user_name][ cd IRACproc/ user_name][ tar xzvf ../IRAC_psfs-.tar.gz where is the directory, with full path, where IRACproc will be installed. Documentation can be found in IRACproc/docs/. Follow the instructions given in SETUP (this document), HOWTOs, etc. #----------------------------------------------------------------------------- # Setup #3 - Download and Install MOPEX #----------------------------------------------------------------------------- Grab the latest distribution of MOPEX for your platform from the Spitzer Space Center (SSC) web site, at the address: http://ssc.spitzer.caltech.edu/postbcd/download-mopex.html Follow the instructions given by the SSC, and first run the GUI. Set the checkbox to automatically check for updates in the GUI menu, to obtain the latest version of the software. Once the software is updated, close the GUI and setup the software to enable running the command-lime MOPEX which is used by IRACproc: 1 If you are running cshell (tcsh) edit the file mopex-script-env.csh to make sure that the following variables are set as shown (use the actual where you have installed MOPEX): user_name][ pico mopex-script-env.csh setenv MOPEX_INSTALLATION /mopex setenv SIRTF_QA ./ setenv SIRTF_CDF ./ unsetenv SIRTF_CAL 2 If you are running bash (default for MacOSX and some Linux distributions) copy the file mopex-script-env.sh from the directory into the /mopex directory and edit the path of your MOPEX installation in the first line: user_name][ cp /mopex-script-env.sh /. export MOPEX_INSTALLATION=/mopex 3 There is a bug in the MOPEX script "simulate" that prevents IRACproc from processing data sets larger than 1000 BCD images. The bug is still present in the newest version of MOPEX (v18.2 w/ GUI). Replace the MOPEX simulate script with the one provided with IRACproc (make a copy first). user_name][ cd //mopex/bin/ user_name][ mv simulate.pl simulate.pl.orig user_name][ cp //IRACproc/simulate.pl . user_name][ chmod +x simulate.pl #----------------------------------------------------------------------------- # Setup #4 - Shell Resource Control File [.cshrc] #----------------------------------------------------------------------------- You need to modify your shell control resource file (.cshrc if you are using cshell or tcsh, and .bashrc if you are using bash) to set up the correct paths to IRACproc and MOPEX. 1 If you are running cshell, copy the file irac_procrc.csh into your home directory, with the name .irac_procrc, and edit the file to replace the with your installation path for IRACproc: user_name][ cp /IRACproc/irac_procrc.csh ~/.irac_procrc user_name][ pico ~/.irac_procrc setenv IRAC_PROC //IRACproc 2 If you are running bash, copy the file irac_procrc.sh into your home directory, with the name .irac_procrc, and edit the file to replace the with your installation path for IRACproc: user_name][ cp /IRACproc/irac_procrc.sh ~/.irac_procrc user_name][ pico ~/.irac_procrc export IRAC_PROC=//IRACproc 3 Edit your .cshrc (if you are using cshell or tcsh) to add the following lines: user_name][ pico .cshrc # IRACproc software source /mopex/mopex-script-env.csh source $HOME/.irac_procrc 4 Edit your .bashrc (if you are using bash) to add the following lines: user_name][ pico .cshrc # IRACproc software source /mopex/mopex-script-env.sh source $HOME/.irac_procrc 5 Make sure to execute the edited .cshrc file in all your open terminals: user_name][ source ~/.cshrc #----------------------------------------------------------------------------- # Setup #5 - PDL Resource Control File [.perldlrc] #----------------------------------------------------------------------------- Copy the PDL control resource file from the IRACproc distribution to your home directory: user_name][ cp $IRAC_PROC/perldlrc ~/.perldlrc Note the "." in the destination filename, which is critical. At this point you can test PDL running the PDL shell and some of the demos: user_name][ perldl perldl> demo perldl> demo pdl perldl> demo_pgplot When starting PDL, you may receive the following message: Unable to find PDL/pdldoc.db in... This is because you either do not have the online documentation installed (module PDL::Doc::Perldl can be downloaded at search.cpan.org - see your System Administrator), or it is installed incorrectly. You can work around this issue by commenting out (with a hash "#") a line in the .perldlrc file: user_name][ pico ~/.perldlrc # use PDL::Doc::Perldl; # online docs module #----------------------------------------------------------------------------- # Setup #6 - IRAF - for optional features (photometry and image inspection) #----------------------------------------------------------------------------- If you already have a loginuser.cl file, you will need to modify it. This file is usually located in ~/iraf/. user_name][ pico ~/iraf/loginuser.cl Now paste the following into the loginuser.cl file (Replace with the installation path for IRACproc.): # LOGINUSER.CL -- User login file for the IRAF command language. reset stdimage = imt512 reset imtype = "fits" # IRAC Processing set IRACproc = "/IRACproc/" task mkbpm = IRACproc$source/mkbpm.cl task inspect = IRACproc$source/inspect.cl task do_nsfind = IRACproc$source/do_nsfind.cl task psort_xy = IRACproc$source/psort_xy.cl task pdump_xy = IRACproc$source/pdump_xy.cl task do_nsphot = IRACproc$source/do_nsphot.cl task pdump_xymag = IRACproc$source/pdump_xymag.cl task do_wcsctran = IRACproc$source/do_wcsctran.cl task run_nsphot = IRACproc$source/run_nsphot.cl # Load packages that will be used for processing images immatch imutil tv lists stsdas tables analysis dither noao digiphot apphot ptools keep ------------------ There is a sample loginuser.cl file located in the IRACproc directory. If you do not already have a loginuser.cl file, copy the template provided into your IRAF directory. user_name][ cp $IRAC_PROC/loginuser.cl ~/iraf/