This is a very brief introduction to running Orac-dr. More detailed information can be found in SUN/230. SUN/232 also includes a description of how to set up and run Orac-dr.
You must first initialise Orac-dr using oracdr_acsis. This will prepare Orac-dr to reduce data taken
that night. If you wish to reduce a previous nights data then you should specify the UT date on the
command line, e.g. oracdr_acsis 20080616. If necessary, you should set the $ORAC_DATA_IN and
$ORAC_DATA_OUT environment variables to the names of the directories from which the raw data should
be read and to which reduced data should be written.
For example:
To reduce all data taken so far and then all data as it is stored you should run
Several windows will (eventually) open: an Orac-dr text display, Gaia windows and Kapview windows (a collective term for various Kappa display tasks). The pipeline will reduce the data as they are stored to disk, using the recipe name in the image header.
The pipeline is meant to run without interference from the observer. Thus, although you can use the
various Gaia tools to examine images, the pipeline should not need to be stopped and/or restarted. If,
however, you do need to restart the pipeline then this can be done using the -from option on the
command line:
This will re-reduce frames from 19 onwards if they have previously been reduced, then continue
to wait for new frames to arrive. The -loop flag tells it not to exit when it runs out of
frames. When reducing data off-line this should be omitted. The -skip tells it to skip missing
observations.
To re-reduce a group of previously stored frames you can use the -list option to specify a list of
frames separated by commas or ranges separated by colons:
You may choose to reduce your data with a recipe other than the one specified in the file headers. If
you discover narrow-line data reduction produces better maps than the REDUCE_SCIENCE_GRADIENT
recipe does, you may wish to specify the REDUCE_SCIENCE_NARROWLINE recipe on the command line,
for example:
Simplified recipes are available to perform a faster data reduction suitable to be carried out in
real-time at the telescope. To use these recipes, supply the -recsuffix SUMMIT command-line
option:
If Orac-dr is initialised using oracdr_acsis_summit this option will be included automatically.
The chief advantage to using the -recsuffix SUMMIT option instead of supplying the full recipe on the
command-line is if the summit recipe does not exist, the default standard recipe will be used instead.
Thus you need not fear reducing pointing observations using a recipe designed for science
targets.
To exit (or abort) Orac-dr click on ‘Exit’ in the text log window, or type [ctrl]-c in the xterm. The
command oracdr_nuke can be used to kill all DR-related processes, should you be having
problems.