This routine flatfields SCUBA-2 data. Each
input file is propagated to a corresponding output file which is identical but contains flatfielded data.
If the input data are already flatfielded, the user will be informed and no action will be performed on
the data.
BBM = NDF (Read)
Group of files to be used as bad bolometer masks. Each
data file specified with the IN parameter will be masked. The corresponding previous
mask for a subarray will be used. If there is no previous mask the closest following will
be used. It is not an error for no mask to match. A NULL parameter indicates no mask
files to be supplied. [!]
FLATMETH = _CHAR (Read)
Method to use to calculate the
flatfield solution. Options are POLYNOMIAL and TABLE. Polynomial fits a polynomial to
the measured signal. Table uses an interpolation scheme between the measurements to
determine the power. [POLYNOMIAL]
FLATORDER = _INTEGER (Read)
The order of
polynomial to use when choosing POLYNOMIAL method. [1]
FLATSNR = _DOUBLE (Read)
Signal-to-noise ratio threshold to use when filtering the responsivity data to determine
valid bolometers for the flatfield. [3.0]
FLATUSENEXT = _LOGICAL (Read)
If true the
previous and following flatfield will be used to determine the overall flatfield to apply to
a sequence. If false only the previous flatfield will be used. A null default will use both
flatfields for data when we did not heater track at the end, and will use a single flatfield
when we did heater track. The parameter value is not sticky and will revert to the default
unless explicitly over-ridden. [!]
IN = NDF (Read)
Input files to be uncompressed and
flatfielded. Any darks provided will be ignored.
MSG_FILTER = _CHAR (Read)
Control
the verbosity of the application. Values can be NONE (no messages), QUIET (minimal
messages), NORMAL, VERBOSE, DEBUG or ALL. [NORMAL]
OUT = NDF (Write)
Output
file(s).
OUTFILES = LITERAL (Write)
The name of text file to create, in which to put
the names of all the output NDFs created by this application (one per line). If a NULL (!)
value is supplied no file is created. [!]
RESIST = GROUP (Read)
A group expression
containing the resistor settings for each bolometer. Usually specified as a text file using "
" syntax. An
example can be found in $STARLINK_DIR/share/smurf/resist.cfg [$STARLINK_DIR/share/smurf/resist.cfg]
RESPMASK = _LOGICAL (Read)
If true, responsivity data will be used to mask bolometer data
when calculating the flatfield. [TRUE]