vircam_reset_combine
[Recipes]

Name:

vircam_reset_combine

Purpose:

Combine a list of raw reset frames to form a mean reset frame.

Description:

A list of raw reset frames is combined with rejection to form a mean reset frame. If a master reset is supplied, then a difference image is formed between it and the combined result from the current frame list. This difference image can be useful for looking at the evolution of the structure of the bias and the reset anomaly with time. If a channel table is given, then the difference image is broken into lots of little cells. The median value of the difference image as well as the RMS in each cell is written to a difference image statistics table.

Language:

C

Parameters:

• comb (int): Determines the type of combination that is done to form the output map. Can take the following values:
  • (1): The output pixels are medians of the input pixels
  • (2): The output pixels are means of the input pixels
• scale (int): Determines how the input data are scaled or offset before they are combined. Can take the following values:
  • (0): No scaling of offsetting
  • (1): All input frames are biassed additively to bring their backgrounds to a common mean.
  • (2): All input frames are scaled multiplicatively to bring their backgrounds to a common mean.
  • (3): All input frames are scaled to a uniform exposure time and then additively corrected to bring their backgrounds to a common mean.
• xrej (int): If set, then an extra rejection cycle will be run.
• thr (float): The rejection threshold in numbers of sigmas.
• ncells (int): If a difference image statistics table is being done, then this is the number of cells in which to divide each readout channel. The value should be a power of 2, up to 64.
• ext (int): The image extension of the input files to be done on this run. If all of the extensions are to be processed, then this should be set to zero.

Input File Types:

The following list gives the file types that can appear in the SOF file. The word in bold is the DO category value.

• BIAS (required): A list of raw reset images for combining
• REFERENCE_RESET (optional): A library reference reset frame. If this is given, then a difference image will be formed and some basic statistics run on it.
• MASTER_BPM or MASTER_CONF (optional): If this is given, then it will be used to mask out bad pixels during and statistical analysis that is done.
• MASTER_CHANNEL_TABLE or CHANNEL_TABLE_INIT (optional): If this is given then the channels in difference image will be broken up into a number of cells. Basic statistics will be done on the cells and written to the difference image statistics table. No linearity information is used, hence either type of channel table is acceptable.

Output Products:

The following list gives the output data products that are generated by this recipe. The word in bold gives the DPR CATG keyword value for each product:

• The output mean/median reset frame, formed by either a mean or median combination of the input raw frames with rejection (MASTER_RESET).
• The output difference image, formed by subtracting the input master reset frame from the current mean/median reset frame. This is only done if a master reset frame is specified from the outset (DIFFIMG_RESET).
• The output difference image statistics table. The exact columns contained in this file are described at length in section 5.7 in the VIRCAM Data Reduction Library Design document (DIFFIMG_STATS_RESET).

Output QC Parameters:

• RESETMED The median of the combined reset frame
• RESETRMS The RMS value of the combined reset frame.
• RESETDIFF_MED The median value of the difference image
• RESETDIFF_RMS The RMS of the difference image

Notes

None.

Fatal Error Conditions:

• NULL input frameset
• Input frameset headers incorrect meaning that RAW and CALIB frame can't be distinguished
• No reset frames in the input frameset
• Unable to save data products

Non-Fatal Error Conditions:

• No master reset. No difference image formed.
• No master bad pixel or confidence map. All pixels considered to be good.
• No channel table. No difference image stats table created.
• Incomplete channel table. No difference image stats table.

Conditions Leading To Dummy Products:

• Reset frame image extensions wouldn't load.
• The detector for the current image extension is flagged dead
• Combination routine failed
• Master reset frame image extension won't load or is flagged as a dummy
• Channel table fits extension won't load, won't verify or is flagged as a dummy.

Author:

Jim Lewis, CASU

Code Reference:

vircam_reset_combine.c

---