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_uist. 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_uist 20021031. 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 199 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. 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 have chosen to postpone observation of your standard-star until after your
object you may wish to specify the _NOSTD form of the recipe on the command line, for
example:
The original recipe name is still written into the headers of the file, so once you have observed and reduced your standard you can re-reduce your object frames without specifying a recipe on the command line. Note that if you specify a recipe name on the command line then this recipe will be used to reduce all specified frames, so in this example you must ensure that the range of files specified includes only sky and object frames and omits the flat-field and arc frames likely to be at the beginning of the sequence.
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.