2 Pipeline Setup

In order to configure the Orac-dr SCUBA data reduction pipeline a setup command, oracdr_scuba, is provided. Assuming you are running the command from the Unix TC-shell2 this command sets all the environment variables and command aliases required to run the pipeline. The UT date of the observations can be specified by supplying an argument to the command, if not specified the current UT date is assumed:

  % oracdr_scuba 19990703

In order for the startup script to be configured to read the input data, an environment variable must be set which points to the directory containing the UT date directory. For example, if your data is in directory /mydata/19991012 the following is required:

  % setenv ORAC_DATA_ROOT /mydata
  % oracdr_scuba 19991012

If ORAC_DATA_ROOT is not set then the current directory will be assumed unless the script is run at the Joint Astronomy Centre. With this variable unset when run at the Joint Astronomy Centre the input data directory will be configured to point to the actual SCUBA archive data directory.

When run, this command should list information detailing the current setup. Hopefully, it should be obvious at this point whether something has gone wrong. Here is an example for the JAC:

  % oracdr_scuba 20000127
  
       ORAC Data Reduction Pipeline -- (ORAC-DR Version 1.0-0)
       Configured for instrument SCUBA
  
       Type "oracdr -h" for usage
       Type ’showme sun231’ to browse the hypertext documentation
  
  
   Raw data will be read from /scuba/m99b/20000127/
   Reduced data will appear in /users/timj/oracdr/docs/sun231
  
  +++++++++ For online SCUBA reduction use oracdr -loop flag +++++++++
  
  For comments specific to SCUBA data reduction mail timj@jach.hawaii.edu
  For problems with the ORAC-DR system mail helpme@jach.hawaii.edu
           http://www.jach.hawaii.edu/UKIRT/software/oracdr/
  

A warning is printed if the input directory can not be found on the system.

Once this is done, the next step is to set the location of the output directory. By default, the directory from which the oracdr_scuba command was issued is chosen. In order to override this value, the ORAC_DATA_OUT environment variable must be set:

  % setenv ORAC_DATA_OUT /largedisk/myoracata/

All Orac-dr output files will appear in ORAC_DATA_OUT. For more information on the Orac-dr environment variables please see SUN/230.

2Orac-dr requires tcsh for full functionality from the system setup. If tcsh is not available the startup scripts (oracdr_ufti etc) will not set the specified UT date (the argument is ignored). In this case the ORAC_DATA_IN and ORAC_DATA_OUT environment variables must be set up explicitly. Additionally, the oracdr command must include the ‘-ut’ option as specified in the oracdr documentation.