|
IRCAM manual
List of available IRCAM/TUFTI ORACDR recipes (alphabetical)
Please the previous section
Appropriate ORACDR
for a guide as to which recipes to use under what circumstances.
This list gives a brief description only; more detailed information is
available by clicking on the recipe names.
Purpose: Determines readnoise and dark current;
displays on screen and writes to log file.
Requirements: The correct number and type of dark frames, easiest to
achieve by running the exec array_tests which is normally done at the start
of the night.
Used by system exec: array_tests.
Purpose: Bad-pixel masking, dark subtraction,
flatfield division, feature detection and matching between object
frames, resampling, and mosaicking. The resampling applies non-integer
Cartesian shifts of origin.
The _APHOT task also performs aperture photometry of the central point
source using a minimum aperture of 6 arcsec.
Requirements: Needs appropriate dark (same exposure) and flat
(same filter)
to have been filed. For photometry the object has to be within 5" of the
center of the readout area.
Used by system exec: jhk_k8; jhk_k10.
Purpose: The recipe makes a sky-subtracted untrimmed mosaic
automatically. Performs bad-pixel masking, null debiassing, dark
subtraction, flat-field division, sky subtraction, registration,
resampling, and mosaicking.
Requirements: Alternating blank-sky and target
frames commencing and ending with a blank sky where both the sky and target
frames are jittered. Appropriate dark needs to have been filed.
Used by system exec: None currently.
Purpose: Reduces an extended source; bad-pixel masking, dark
subtraction, flat-field division, sky subtraction, registration,
resampling, and mosaicking. The flat field is derived from the sky frames.
The _BASIC task
is a fast option which uses telescope offsets
instead of registration, and does not do sub-pixel resampling.
Requirements: The data
comprise alternating blank-sky and target frames commencing and
ending with a blank sky. The target frames are arranged in an
overlapping (30-50%) grid of 3x3 frames. Suitable for extended
objects up to about 30 arcsec across with TUFTI.
Needs appropriate dark (same exposure) to have been filed.
Used by system exec: None currently.
Purpose: Reduces an extended source; bad-pixel masking, dark
subtraction, flat-field division, sky subtraction, registration,
resampling, and mosaicking. The flat field is derived from the sky frames.
The _BASIC task
is a fast option which uses telescope offsets
instead of registration, and does not do sub-pixel resampling.
Requirements: The data
comprise alternating blank-sky and target frames commencing and
ending with a blank sky. The target frames are arranged in an
overlapping (30-50%) grid of 5x5 frames. Suitable for extended objects
up to about 60 arcsec across with TUFTI.
Needs appropriate dark (same exposure) to have been filed.
Used by system exec: None currently.
Purpose: Bad-pixel masking, dark
subtraction, flatfield creation, flatfield division, feature
detection and matching between object frames, resampling, and
mosaicking.The flat field is created iteratively by combining
normalised object frames using the
clipped median at each pixel and this flat is refined by object
detection and masking. The _NO_MASK task
omits the object masking and is therefore faster. The _APHOT
task carries out the full JITTER5 plus does aperture photometry
on the central object.
Requirements: A set of 5
images is expected. Needs appropriate dark (same exposure) to have
been filed. For photometry the object has to be within 5" of the
center of the readout area.
Used by system exec: jhk_k11; jhk_k12; jhk_k13;
jhk_k14.
Note: for very short exposures (less than 5 seconds
at JHK) there are insufficient counts in the background for this
to generate a useable self-flat.
Purpose: For data observed through one or more filters. For each filter:
bad-pixel masking, dark
subtraction, flatfield creation, flatfield division, feature
detection and matching between object frames, resampling, and
mosaicking.The flat field is created iteratively by combining
normalised object frames using the
clipped median at each pixel and this flat is refined by object
detection and masking.
Requirements: A set of 5
images is expected. Needs appropriate dark (same exposure) to have
been filed.
Used by system exec: None currently.
Note: for very short exposures (less than 5 seconds
at JHK) there are insufficient counts in the background for this
to generate a useable self-flat.
Purpose: Bad-pixel masking, dark
subtraction, flatfield creation, flatfield division, feature
detection and matching between object frames, resampling, and
mosaicking.The flat field is created iteratively by combining
normalised object frames using the
clipped median at each pixel and this flat is refined by object
detection and masking. The _NO_MASK task
omits the object masking and is therefore faster.
Requirements: A set of 9
images is expected. Needs appropriate dark (same exposure) to have
been filed.
Used by system exec: jitter9_basic; k_jitter9_self_flat.
Note: for very short exposures (less than 5 seconds
at JHK) there are insufficient counts in the background for this
to generate a useable self-flat.
Purpose: Bad-pixel masking, dark
subtraction, flatfield creation, flatfield division, registration using
telescope offsets, resampling, and
mosaicking.The flat field is created iteratively by combining
normalised object frames using the
clipped median at each pixel and this flat is refined by object
detection and masking.
Requirements: A set of 9
images is expected. Needs appropriate dark (same exposure) to have
been filed.
Used by system exec: None currently.
Purpose:Reduces a 9-point "standard
jitter" photometry observation of a moving target using
object masking. Performs bad-pixel masking, dark
subtraction, flat-field creation and division, feature
detection and matching between object frames, and
resampling. Registration is adjusted to track the motion of
the moving target using ephemeris data stored in file
target_ephem.txt specified by the environment variable
ORAC_EPHEMERIS, defaulting to
$ORAC_DATA_OUT/target_ephem.dat.
Requirements:A set of 9
images is expected. Needs appropriate dark (same exposure) to have
been filed.
Used by system exec: None currently.
Purpose: Reduces a "nod jitter" observation by subtracting adjacent frames
to produce two images each of which contain a positive and negative image of the
target. Bad-pixels are masked, a flatfield created from a median filter of
the four frames and the images flatfielded. A mosaic is created with a positive
and negative image of the source. Subtracting adjacent frames for sky removal gives
good results when working in the thermal regime.
Requirements:A set of 4
images is expected. Needs appropriate dark (same exposure) to have
been filed.
Used by system exec: lp_l5, lp_l8.
Purpose: Reduces a "nod jitter" observation by subtracting adjacent frames
to produce four images each of which contain a positive and negative image of the
target. Bad-pixels are masked, a flatfield created from a median filter of
the eight frames and the images flatfielded. A mosaic is created with a positive
and negative image of the source. Subtracting adjacent frames for sky removal gives
good results when working in the thermal regime.
Requirements:A set of 8
images is expected. Needs appropriate dark (same exposure) to have
been filed.
Used by system exec: lp_l6, lp_l10, lp_l12, lp_l13, mp_m5, mp_m7, mp_m10.
Purpose: Performs a null debiassing, bad-pixel masking, dark
subtraction and flat-field division on all frames. Next the sections of
the frame representing the e- and o-beam target and sky regions are
extracted, and the target frames sky-subtracted. The resultant frames
undergo registration and resampling to form a mosaic for each waveplate
angle and beam. Once all eight mosaics are formed they are registered and
resampled, and then combined to form the various polarisation images.
Requirements:The waveplate angle iterates at each jitter
position. This recipe works well for point or extended sources
less than about 10 arcseconds diameter. Dark and flat need to have been
filed.
Used by system exec: None currently.
Purpose: Reduces three-point jitters in Right Ascension at the four
waveplate angles 0, 45, 22.5, 67.5 degrees to make calibrated polarisation
images automatically. Performs null debiassing, bad-pixel masking, dark
subtraction and flat-field division on all frames. Next the sections of
the frame representing the e- and o-beam target and sky regions are
extracted, and the target frames sky-subtracted. The resultant frames
undergo registration and resampling to form a mosaic for each waveplate
angle and beam. Once all eight mosaics are formed they are registered and
resampled, and then combined to form the various polarisation images.
Requirements: This recipe works well for point or extended sources
less than about 10 arcseconds diameter. Dark and flat need to have been
filed.
Used by system exec: None currently.
Purpose: Applies bad pixel mask and files the dark for future use.
Requirements: None.
Used by system exec: most of the execs include a dark.
Purpose: Bad pixel masking, dark subtraction, combines normalised frames
pixel by pixel using a clipped
median statistic. Files for future use. The _MASKED task creates a flat
iteratively, identifying and removing objects from the final flat.
Requirements: Needs 5 data frames and an appropriate
dark (same exposure) has to have been filed.
Used by system exec: sky_jhk.
Purpose:Creates and files a flat field derived from eight frames
using object masking to reduce artifacts.
Requirements: Appropriate dark needs to have been filed.
Used by system exec: None currently.
|