vircam_mesostep_analyse
[Recipes]

Name:

vircam_mesostep_analyse

Purpose:

Reduce a complete mesostep sequence

Description:

A mesostep sequence in a single filter is corrected for instrumental signature and sky background if requested. The field is divided into cells and an illumination correction is calculated for each one from all the stars on all images in that cell. The result is smoothed by fitting a 2d polynomial to the result. The evaluation of that polynomial at the grid points forms the output illumination correction data product.

Language:

C

Parameters:

• ipix (int): The minimum allowable size of an object
• thr (float): The detection threshold in sigma above sky
• icrowd (int): If set then the deblending software will be used
• rcore (float): The core radius in pixels
• nb (int): The smoothing box size for background map estimation
• destripe (int): If set, then the single images will be destriped
• skycor (int): If set, a simple sky background correction will be applied.
• nord (int): The order of the polynomial to fit to the data
• 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.

• MASTER_DARK (required): A master dark frame.
• MASTER_TWILIGHT_FLAT (required): A master twilight flat frame.
• MASTER_CONF or MASTER_BPM (required): A master confidence map for the filter used in the science images. If such is not available, then there is the option to use a master bad pixel mask.
• MASTER_CHANNEL_TABLE (required): The channel table.
• STD_ILLUMINATION (required): The list of input science images.
• PHOTCAL_TAB (required): A photometric calibration table
• MASTER_2MASS_CATALOGUE: The index file for the 2mass catalogue

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:

• An illumination correction table defined from the corrected simple images (ILLCOR_TAB_MES)

Output QC Parameters:

None

Notes

None.

Fatal Error Conditions:

• NULL input frameset
• Input frameset headers incorrect meaning that RAW and CALIB frame can't be distinguished
• No science frames in the input frameset
• Required master calibration images and tables are missing
• Unable to save data products

Non-Fatal Error Conditions:

• None

Conditions Leading To Dummy Products:

• Master calibration images either won't load or are flagged as dummy
• The detector for the current image extension is flagged dead in all science frames
• Various processing routines fail.

Author:

Jim Lewis, CASU

Code Reference:

vircam_mesostep_analyse.c

---