================ GeRT READme File ---------------- GeRT Version: S14.0 v1.1 [060415], 2006 April 15 Associated SSC pipeline version: S14.0 ------------------------------------------- General system Requirements: --------------------------- o tcsh/csh o perl o standard shared system libraries o LINUX, Mac, or Solaris Setup Instructions: ------------------- (1) Unpack tarball gunzip gert_gnuSOL_060415.tar.gz tar -xvf gert_gnuSOL_060415.tar (2) Edit SOS_GeRT environment parameter in gert_setup.csh to match local path. The GeRT setup and scripts are designed for tcsh/csh. cd GeRT_gnuSOL_060415 emacs gert_setup.csh --> setenv SOS_GeRT /scr/GeRT/GeRT_gnuSOL_060415 (3 [optional]) If you have perl threads (Thread.pm), then set GERT_THREAD in gert_setup.csh, otherwise leave GERT_THREAD set to zero (no threads). # Use perl Thread.pm for increased speed (if available) # GERT_THREAD =~ num_cpu + 1 --> 2xnum_cpu for optimal performance # GERT_THREAD 0 = no threads (e.g., Can't locate Thread.pm in @INC ) (4) Source gert_setup.csh to set environment > source gert_setup.csh #Environment parameters used by scripts: SOS_LOCAL = location of the cal and cdf directories = SOS_GeRT SIRTF_BIN = location of the binaries = SOS_GeRT/bin WRAPDIR = location of the scripts = SOS_GeRT/scripts SIRTF_BIN is added to your PATH. The LD_LIBRARY_PATH is set to SOS_GERT/lib for the Solaris versions but is not used for LINUX and Mac versions. The setup script checks for perl and sets PERL_PATH if needed. You need PERL to run the GeRT. (5) Test the GeRT on your system. cd testme $WRAPDIR/gert.pl INtest.lis OUTdir --> Runs the GeRT on input list of files given by INtest.lis and puts the products in OUTdir. Confirm that the *.bcd.fits files are successfully made in the OUTdir/bcd directory. To run with perl threads, then $WRAPDIR/gert_thread.pl INtest.lis OUTdir If you try to use gert_thread.pl and get errors with a message like "Can't locate Thread.pm in @INC", then you do not have perl threads on your system, and you need to set GERT_THREAD=0 and run gert.pl. For default processing, the GeRT reads the header of the first file to determine the data type and picks the appropriate pipeline. The important keywords which control the pipeline processing are CHNLNUM, EXPTYPE, and FOVID. CHNLNUM = 2 for 70um CHNLNUM = 3 for 160um EXPTYPE = scn ==> Scan data, normal science pipeline is run. EXPTYPE = pht ==> Photometry data, normal science pipeline is run. If EXPTYPE=pht and FOVID>117, then the data are 70um FINE-scale observations and the appropriate calibration files are chosen. EXPTYPE = sed ==> 70um SED data, SED pipeline is run. EXPTYPE = tpm ==> Total power mode data, TPM pipeline is run. EXPTYPE = d2a ==> DARK data, DARK pipeline is run. EXPTYPE = sfl ==> IC data from scanning, IC pipeline is run. EXPTYPE = pfl ==> IC data from photometry, IC pipeline is run. EXPTYPE = ffl ==> IC data from FINE-scale photometry, IC pipeline is run. EXPTYPE = dfl ==> SED IC data, IC pipeline is run. EXPTYPE = tfl ==> Total power IC data, IC pipeline is run. Users can force the GeRT to run a specfic pipeline by providing the EXPTYPE on the command line (3rd input argument). For example, if you would like to make your own IC calibration file from your science data you could try the following, e.g.: $WRAPDIR/gert.pl IN70.lis OUTdir sfl where "sfl" causes the GeRT to run the IC pipeline. The output BCD products from the GeRT have the same suffixes as those from the SSC archive and are put in the OUTdir/bcd directory. The BCDs and/or fBCDs can be coadded using mopex. The gert.pl script also makes numerous intermediate products which can be useful for diagnostic purposes. ========================== The GeRT package includes: (1) cal/ Calibration files used for MIPS-70 and MIPS-160 (2) cdf/ cdf namelist files cdf/2 cdf's for MIPS-70 bcd pipeline processing cdf/3 cdf's for MIPS-160 bcd pipeline processing cdf/*.nl cdf's for filtering scripts and postbcd processing (3) scripts/ Scripts for MIPS-Ge processing (4) bin/ MIPS-Ge binaries (5) lib/ MIPS-Ge shared libraries (if applicable) (6) gert_setup.csh Environment setup file for running GeRT software (7) gert_doc Documentation for this package (ascii) =============================================================== SYSTEM Versions of the GeRT We have 4 versions of the GeRT. The online system uses the Solaris--Forte version and all cababilities should work for this version. GNU-compiled versions of the GeRT for Solaris, Linux, and the Mac have been made recently. The current GNU versions of the GeRT can carry out science BCD processing, but the calibration IC pipelines do not work on these versions yet. The listing of what works with which version is tabulated below. GeRT Versions: -------------- (1) Solaris -- Forte Tested Systems: SunOS 5.8 Generic_108528-22 sun4u sparc SUNW,Sun-Fire-V240 perl, v5.6.0 built for sun4-solaris perl, v5.8.7 built for sun4-solaris-thread-multi SunOS 5.8 Generic_108528-21 sun4u sparc SUNW,Sun-Blade-100 perl, v5.6.0 built for sun4-solaris (2) Solaris -- gnu 3.4.5 SunOS 5.8 Generic_108528-22 sun4u sparc SUNW,Sun-Fire-V240 perl, v5.8.7 built for sun4-solaris-thread-multi (3) LINUX -- gnu 3.4.5 Tested systems: Red Hat Enterprise Linux WS release 3 (Taroon Update 7) Linux 2.4.21-20.ELsmp i686 i686 i386 GNU/Linux perl, v5.8.0 built for i386-linux-thread-multi Red Hat Enterprise Linux WS release 3 (Taroon Update 2) Linux 2.4.21-15.EL x86_64 x86_64 x86_64 GNU/Linux perl, v5.8.0 built for x86_64-linux-thread-multi (4) Mac -- gnu 3.4.5 Tested systems: Mac OSX 10.4.6 PowerPC G5 Darwin Kernel Version 8.6.0 RELEASE_PPC Power Macintosh powerpc perl, v5.8.6 built for darwin-thread-multi-2level Mac OSX 10.3.9 perl, v5.8.1 ========================= GeRT Functionality Table: Y=yes; it works. N=no; it does not work in general. EXPTYPE/ SOL-forte SOL-gnu LINUX MAC Function (1) (2) (3) (4) ------------------------------------------------- perl-5.6 Y N N N perl-5.8 Y Y Y Y scn Y Y Y Y pht Y Y Y Y pht-FINE Y Y Y Y sed Y Y Y Y tpm Y Y Y Y d2a Y Y Y Y sfl Y N N N pfl Y N N N ffl Y N N N dfl Y N N N tfl Y N N N ------------------------------------------------------ #frayer, 15 April 2006