L Release Notes—V2.0-1
The major changes are the move to generic recipes, and the introduction of many new recipes,
especially for polarimetry and Fabry-Perot data.
L.1 New recipes
-
CHOP_SKY_JITTER
- Reduction of alternating sky-target jitters for extended objects of size
comparable to the detector’s field of view.
-
CHOP_SKY_JITTER_BASIC
- A basic (faster) version of CHOP_SKY_JITTER.
-
FP
- Reduction of a Fabry-Perot observation, without jittering.
-
JITTER_SELF_FLAT_NCOLOUR
- Reduction of multi-colour standard jitters. This will
become the new JITTER_SELF_FLAT once the recipes are colour generic.
-
POL_ANGLE_JITTER
- Reduces an imaging polarimetry observation, in which the waveplate
angle iterates at each jitter position.
-
POL_EXTENDED
- Reduces an imaging polarimetry observation of an extended source.
-
POL_JITTER
- Reduces an imaging polarimetry observation, in which the spatial is position
jittered before moving the waveplate angle.
-
SKY_FLAT_FP
- Creates and files a Fabry-Perot flat field derived from eight frames, using object
masking.
-
SKY_FLAT_POL
- Creates a polarimetry flat field derived from eight frames (two at each
waveplate angle), using object masking. It copies the flat for each waveplate angle and
files them.
-
SKY_FLAT_POL_ANGLE
- Creates and files polarimetry flat fields derived from jittered
frames at each waveplate angle, using object masking.
L.2 Modified recipes
Many former recipes had numerous variants for different jitter sizes. These have largely been
superseded by generic equivalents. Only the EXTENDED recipes await conversion. The families of
recipes changed are listed below.
- JITTER_SELF_FLAT (Six recipes in the family) There were three-, five-, seven-, and
nine-point versions, but most were only available for one or two recipe variants.
- MOVING_JITTER_SELF_FLAT (Two recipes) These were limited to nine-point jitters.
- NOD_SELF_FLAT_NO_MASK (Four recipes) There were limited to fixed sizes of four-
and eight-point jitters.
- SKY_AND_JITTER (Two recipes) Only five-point jitters were available.
In addition certain recipes had a fixed jitter size, but no longer. These families are as follows.
L.3 Global changes
The main changes from a user perspective were as follows.
- Recipes and primitives are instrument generic.
- Improved registration allowing mixed solutions. There is a new offset type—beam
separations—for combining polarimetry mosaics.
- Thresholding of dark-subtracted data to prevent bizarre values affecting the pipeline
processing. In addition JITTER_SELF_FLAT and SKY_FLAT recipes and their variants
which use object masking to make a flat, now have the deviant pixels of the initial
flat-field frame reflagged as bad.
- Editing of the FITS headers to create a world co-ordinate system which Gaia and Kappa
recognise. Also pre-ORAC IRCAM data have their headers structured and comments
edited to bring them closer towards the UKIRT FITS standard, and to make the headers
easier to read and comprehend.
- The names of flats have changed. The filter name is included for easy identification.
Certain characters have special meaning to HDS, therefore
[]{} are removed and a
decimal point becomes a p in the flat’s name. The _cycle suffix is shortened to _c, and
all _subgrp strings removed from the group number. Flats are are not combined over
multiple cycles over recipes. SKY_FLAT and SKY_FLAT_MASKED are limited to jitters
between three to five points for compatibility with other ORAC tools. It is still possible to
make private variants of these recipes in which the number of jitter positions is set by the
NUMBER steering parameter.
- Mosaics are combined using the mean at each pixel. This was formerly the median.
The change was made to correct the photometry. Poor registration from telescope offsets
due to sparse fields leads to multiple peaks in the mosaic’s grid, and given the steep
point-spread function’s profile, the median preferentially selects pixels not at a peak.
This resulted in a typical underestimate of the flux of standard stars by 1–3%. The
_MAKE_MOSAIC_ primitive now has an argument to select various estimators should
you prefer not to use the mean.
- For the aperture photometry the default sky annulus radii have been increased. This
reduces the error estimating the sky level, both statistically and from the extend low-level
pedestal in the point-spread function. The area is increased 2.9
for IRCAM and 5.6
for UFTI.
- To counteract the spike artifact in the histogram of sky values of flat-fielded frames where
the pre-flattened frame itself contributed to the flat (‘self-flat’ recipes), the mode is now
calculated using multiple standard-deviation clipping for JITTER_SELF_FLAT_APHOT
and NOD_SELF_FLAT_NO_MASK_APHOT. The previous estimation was from iterative
application of Chauvenet’s criterion and using the 3 median 2 mean
formula, and lead to a underestimate of the sky level. For typical standard stars this
systematic error led to a brightening of 1–2%. The latter method is still used for photometric
recipes which do not self flat, such as BRIGHT_POINT_SOURCE_APHOT. If you create
and apply a ‘superflat’, the artifact is much reduced and therefore, the former estimator
is appropriate.
- More and better processing-status messages. For example, all floating-point numbers are
now reported with a sensible number of decimal places, and the names of calibration
frames are reported.
- Addition of FWHM to the aperture photometry results and small text list. The file name
column is 3 characters wider to accommodate the positive and negative suffices of recipe
NOD_SELF_FLAT_NO_MASK_APHOT.
- The saturation level in the aperture photometry was a constant. Now it is set to the
appropriate value by instrument and mode.
- It is possible to use versions of Kappa other than the latest. The changed argument lists
in various tasks are adjusted for the Kappa version.
- More intermediate files, mostly the text files, are removed.
- Pipeline activates two more application engines: Polpack and CATSELECT.
- A new UFTI bad-pixel mask.
- Added waveplate angle to flat rules file ($ORAC_DATA_CAL/rules.flat). The angle defaults
to zero if it does not have a value in the FITS headers.
- Bug fixes and documentation improvements, especially links in the Perl POD.
Copyright © 2004 Particle Physics and Astronomy Research Council