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.
ARRAY_TESTS
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.
BRIGHT_POINT_SOURCE
BRIGHT_POINT_SOURCE_APHOT
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.
CHOP_SKY_JITTER9
CHOP_SKY_JITTER9_BASIC
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.
EXTENDED_3x3
EXTENDED_3x3_BASIC
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 3×3 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.
EXTENDED_5x5
EXTENDED_5x5_BASIC
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 5×5 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.
JITTER5_SELF_FLAT
JITTER5_SELF_FLAT_NO_MASK
JITTER5_SELF_FLAT_APHOT
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.
JITTER5_SELF_FLAT_NCOLOUR
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.
JITTER9_SELF_FLAT
JITTER9_SELF_FLAT_NO_MASK
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.
JITTER9_SELF_FLAT_TELE
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.
MOVING_JITTER9_SELF_FLAT
MOVING_JITTER9_SELF_FLAT_BASIC
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.
NOD4_SELF_FLAT_NO_MASK
NOD4_SELF_FLAT_NO_MASK_APHOT
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.
NOD8_SELF_FLAT_NO_MASK
NOD8_SELF_FLAT_NO_MASK_APHOT
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.
POL_ANGLE_JITTER
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.
POL_JITTER3
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.
REDUCE_DARK
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.
SKY_FLAT
SKY_FLAT_MASKED
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.
SKY_FLAT_POL
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.