QC documentation system: QC procedure QCocam_lingain.py for OMEGACAM

This documentation is intended both for QC scientists and SciOps astronomers (who may want to ignore the technical information displayed in grey).
 
HOME
 
CRIRES
FORS1
FORS2
KMOS
NACO
 
GIRAFFE
UVES
XSHOOTER
 
ISAAC
SPHERE
VIMOS
VISIR
 
HAWKI
MUSE
SINFONI
 
AMBER
MIDI
PIONIER
 
OMEGACAM
VIRCAM
[best viewing with style sheets and javascript enabled]
QCocam_qcheck.py QCocam_shutter.py QCocam_readnoise.py QCocam_lingain.py
QCocam_bias.py QCocam_dark.py QCocam_dome.py QCocam_flat.py
QCocam_std.py QCocam_sci.py
 
bottom  plots   |   contact
NAME QCocam_lingain.py
VERSION 1.0 -- 2012-06-10 First draft of this QC report
SYNTAX Python
CALL measureQuality of data contained in $DFS_PRODUCT/DETGAIN/$DATE
within processQC: processQC -a $AB
explicit call: QCocam_lingain.py -a [$AB_name] -e [$ext_number: 1-32] -i [$level_of_interaction: 0-2]
INSTRUMENT OMEGACAM
RAWTYPE DETGAIN (DPR.TYPE = FLAT,DOME,DETGAIN)
PURPOSE a) generates 3 QC reports for each OmegaCAM CCD
b) writes QC1 parameters into local QC1 database omegacam_detlin
PROCINPUT No input is required:
a) $DATE is read from AB
b) the primary file is set in QCocam_lingain.py and is the PRO.CATG=GAIN_INFO product with the _0000.fits extension.
c) raw frames are implicitly read from the AB.
d) All reference products: GAIN_INFO, DET_LIN_INFO, BP_MAP_NL, COEFFS_CUBE_P0, COEFFS_CUBE_P1, COEFFS_CUBE_P2, and COEFFS_CUBE_P3 are found and read in from $DFO_ROOT_DIR_FC/calib/references/DETGAIN/.
QC1TABLE trending | table(s) in QC1 database:
omegacam_detlin
TRENDPLOT trending | HealthCheck plot(s) associated to this procedure:
trend_report_GAIN_HC.html
QC1PAGE trending | associated documentation:
gain_QC1.html
QC1PLOTS
top

lingain1.png
top left: a) an average column trace through the raw dome having the longest exposure time (blue line).
b) an average column trace through the raw dome having the shortest exposure time (green line).
The mean flux levels of both extremes are given in the legend and the saturation line at 65,000 ADU (red line) is also shown. The intent is to flag saturated dome flats.
top right: the median flux per exposure time (ADU/second) vs. the median total flux (ADU) for the current set of dome flats (blue points) and the reference dome flats (red points). The exposure times of each flat (2 -> 70 seconds) is listed next to each data point. The median levels are shown as dotted lines and listed in the figure legend.
lower left: the gain (electrons/ADU) vs. the net flux (ADU) for each dome flat in the gain/linearity template. The current gain values are shown with blue points, while the reference values are red. The gain levels assumed by the pipeline (QC.GAIN) are given in the legend and plotted as dotted lines. The change in gain as a function of net flux is obvious.
lower right: the median flux level (ADU) for each dome flat in the gain/linearity template vs. the exposure time is plotted for the current data (blue points) and the reference data (red points). A fit to the relation is shown as a green line and is listed in the legend.

lingain2.png
top: by plotting the signal of dome flat pairs vs. variance one can compute the gain over the full flux range. Plotting the mean_flux[on_1] + mean_flux[on_2] - (mean_flux[off_1] + mean_flux[off_2]) vs the variance (sigma^2[on] - sigma^2[off]) for each dome flat exposure pair, a linear fit to the data (green line) gives the inverse (1/gain) gain value (e-/ADU).
bottom: the gain (e-/ADU) as measured for ALL OmegaCAM detectors. The current gain values are shown as blue dots, the reference gains are shown as red dots. The median current gain is shown as a dotted green line with its +/- 1 sigma shaded green. The current detector is circled and the median gain is listed in the legend.

lingain3.png
top left: the full-frame, current linearity coefficient P0.
top center: the full-frame, current linearity coefficient P1.
top right: the full-frame, current linearity coefficient P2.
lower left: the difference between the reference and the current linearity coefficient P0.
lower center: the difference between the reference and the current linearity coefficient P1.
lower right: the difference between the reference and the current linearity coefficient P2.

lingain4.png
left: a map of the positions of non-linear pixels. The total number of non-linear pixels is listed at the top of the frame.
right: a map of the positions of non-linear pixels that differ between the reference and current non-linearity maps. The total number of differing pixels is listed at the top of the frame.
QC1PARAM QC1 parameters written into QC1 table(omegacam_detlin)
SOURCE(header or script)     DBNAME                   value        description
PRO.DATANCOM datancom 22 the number of raw files combined in pipeline processing QC.METHOD qc_method PTC the method used to compute the gain QC.CONAD qc_conad 0.385452 conad value (ADU/e-) QC.GAIN qc_gain 2.647343 gain (e-/ADU) QC.GAIN.ERR qc_gain_err 0.078654 error in gain (e-/ADU) QC.CONTAM1 qc_contam1 42345.5 detector contamination in a region QC.CONTAM2 qc_contam2 47311.4 detector contamination in a region QC.CONTAM3 qc_contam3 40141.2 detector contamination in a region QC.CONTAM4 qc_contam4 39993.5 detector contamination in a region QC.CONTAM5 qc_contam5 41341.5 detector contamination in a region QC.COUNTS.MIN qc_counts_min 1288.6 minimum median value used in linearity QC.COUNTS.MAX qc_counts_max 42288.6 maximum median value used in linearity QC.LIN.EFF qc_lin_eff -0.004343 effective non-linearity correction QC.LIN.EFF.FLUX qc_lin_eff_flux 10000 flux level at which effective non-linearity correction is applied QC.FPN qc_fpn 0.0268342 fixed pattern noise QC.NUM.BPM qc_num_bpm 23453 number of (bad) non-linear pixels QC.LIN.COEF0 qc_lin_coef0 1.2416343 linearity coefficient value (P0) QC.LIN.COEF0.ERR qc_lin_coef0_err 0.0268347 error in linearity coefficient value (P0) QC.LIN.COEF1 qc_lin_coef1 13135.343 linearity coefficient value (P1) QC.LIN.COEF1.ERR qc_lin_coef1_err 1334.8347 error in linearity coefficient value (P1) QC.LIN.COEF2 qc_lin_coef2 131.34343 linearity coefficient value (P2) QC.LIN.COEF2.ERR qc_lin_coef2_err 41.834743 error in linearity coefficient value (P2) QC.LIN.COEF3 qc_lin_coef3 5.34343 linearity coefficient value (P3) QC.LIN.COEF3.ERR qc_lin_coef3_err 0.834743 error in linearity coefficient value (P3) QCocam_lingain.py qc_temp_mosaic_plate 146.5 average temperature probe of mosaic plates from DET.TLM5/8 (QC script)
ALGORITHM
CERTIF - The OmegaCAM linearity/gain template consists of 20 dome flat images taken in pairs of 2, 5, 7, 10, 20, 30, 40, 50, 60, and 70 second exposures and two bias frame exposures. The template MUST be executed in the v_STRM filter, since using the Sloan filters would result in the long exposures saturating (e.g. in z_SDSS the dome flat will saturate in 4.0 seconds).
- Check that the longest exposure is not saturated. This will be obvious from QC report 2 which plots the trace of the shortest and longest exposure dome flats. Saturated dome flats should be rejected and Paranal advised to repeat the linearity/gain template.
COMMENTS OmegaCAM linearity/gain frames are normally taken every 10 days and consist of 20 raw screen flats in the v_STRM filter and 2 bias frames.
top [2015-11-05T15:10:17]         created by qcDocu v1.1.2, a tqs tool