Note: The following tutorial instructions assume that the user has already completed SCUBA-2 DR Tutorial 1, and has the associated raw data and basic directory structure already in place.
The following instructions assume that the tutorial parent directory is located in the user’s home directory, ~/ and that the computer to be used already has a functioning installation of the latest version of the Starlink software suite (the latest release is available for download here). Please also remember to run KAPPA and SMURF first.
Recpars Files; Manually Running mapmaker; dimmconfig Files
This tutorial demonstrates how to modify the behavior of standard reduction recipes using a Recipe Parameters recpars file, how to perform standard imaging of a SCUBA-2 dataset using the makemap command, and also how to manually modify the process by specifying a different dimmconfig file.
Tutorial 1 demonstrated the possibility of re-running an ORAC-DR pipeline reduction with a non-default Recipe. It is, however, also possible to supply a recpars (Recipe Parameters) plain text file that specifies the modification of some parameters for a given Recipe reduction without necessarily using a completely different recipe. Common modifications included in SCUBA-2 recpars files include changes to (e.g.) the pixel size in the final map or the dimmconfig file to be used by the recipe.
A number of pre-existing examples of SCUBA-2 recpar files can be listed by typing the following:
and then using
to view the contents of a listed recpars file for project .
In the ~/tutorial/reduced data directory, experiment with creating a simple recpars file and save it with the filename myparams.ini .
A starting point for your custom recpars file might be something like the following:
[REDUCE_SCAN] MAKEMAP_CONFIG = dimmconfig_bright_extended.lis
Test the new recpars file by re-running the data reduction with:
oracdr -loop file -files mylist -recpars myparams.ini
Feel free to experiment with the settings in the recpars file and re-run the reduction. As usual, the original reduction can be recovered by simply running the above command without the -recpars myparams.ini option.
The next data reduction possibility is to manually run makemap, rather than running it via ORAC-DR. Switch to the tutorial parent directory, create a second reduced data directory (called reduced2) and switch to it:
It is necessary to provide some input parameters in order to run makemap. One of these is a list of the input files to be processed. For the purposes of this tutorial, a suitable file was already created during Tutorial 1, with the filename mylist. Copy this file into the new reduced2 directory using:
cp ../reduced/mylist ./
If running makemap directly, it is also necessary to specify directly which of the underlying dimmconfig files (used by the recipes) should be used. These files are also supplied as part of the standard Starlink package distribution, and can be listed by typing:
For the purposes of highlighting the impact the correct dimmconfig can have on data reduction, the makemap command will be run twice for this tutorial, with two contrasting dimmconfig files that are provided as part of the standard Starlink distribution. Copy two of these to the current working directory:
cp $STARLINK_DIR/share/smurf/dimmconfig_bright_extended.lis ./
cp $STARLINK_DIR/share/smurf/dimmconfig_blank_field.lis ./
Run the map-maker with the first dimmconfig file:
makemap in=^mylist out=out_be.lis config=^dimmconfig_bright_extended.lis
This should produce an NDF file called out_be.sdf .
For comparison, re-run the map-maker with the other dimmconfig file:
makemap in=^mylist out=out_bf.lis config=^dimmconfig_blank_field.lis
This should produce an NDF file called out_bf.sdf .
Try examining both out_be.sdf and out_bf.sdf in Gaia using the techniques described in Tutorial 1. It should be immediately clear which of the two dimmconfig files is the more suitable for the type of observations used in these tutorials. As noted in Tutorial 1, the default Recipe for the example dataset is REDUCE_SCAN, which uses the dimmconfig file dimmconfig_jsa_generic.lis as its default for science targets.
Feel free to try re-running the process with other standard dimmconfig files. For interest, you may also wish to compare and contrast the contents of these files.