mirror sites: PL (internal link) HQ     [?]

Quality Control and
Data Processing


CAL | HC | refs | QC
QUALITY CONTROL
    HOME
OmegaCAM QC
Trending & QC1
Pipeline
product names
OmegaCAM ...
QC links:
Data product names

The names of all calibration pipeline products follow a certain naming convention. This is done to have human-readable rather than technical file names. The naming scheme has been chosen to have the type of product, its date of creation, and its pipeline-relevant setup values recognizable in the product name.

The general format of user-oriented product file names is the same for all VLT/VLTI instruments.

On the archive interface, the master calibrations can be associated to science files and downloaded. Then they carry technical filenames (the archive filename ARCFILE). In order to rename them to the original filenames, search for the fits header key ORIGFILE. The naming scheme of ORIGFILE is described here.

Instrument code

All product names start with two letters which are specific for the instrument. For instance: UVES product names start with 'UV', VISIR names with 'VR'.

Product category

The full value of the product category is coded in the FITS header key HIERARCH.ESO.PRO.CATG. A short form of this tag is encoded in four characters being unique per instrument:

1st letter M or P calibration product
G general (static) calibration product
2nd to 4th letter ... type of product

Calibration products come in two flavours: dynamic ones (being updated regularly, short validity), and static ones (never or rarely updated). The static ones are also called 'general' because they often are not derived from raw data (like e.g. a line catalogue).

Both product types are stored in the archive and are available for download through the calSelector service.

All OmegaCAM pipeline product names begin with "OC_".

OC_S . . . are science products.

OC_P and OC_M . . . are calibration products.

OmegaCAM SCIENCE PIPELINE PRODUCTS

In view of the current Quality Control scheme, science processing is not done. However, in the some special cases (i.e. during the first 6 months of operations) it can be done. Thus, for completeness the OmegaCAM pipeline products are listed. They have the following naming scheme:

OC_[SXXX]_[OBS_ID]_[date_time]_[BINNING_X]_[BINNING_Y]_[READ_MODE]_[READ_SPEED]_[FILTER_NAME].[ext]

where:

  • [SXXX] is the four letter code uniquely describing the type of product (the first letter is always S for SCIENCE). All these codes are listed below.
  • [OBS_ID] is the Observing Block (OB) number of the observation read from the OBS.ID fits header
  • [date_time] is the UT date and time of the first raw frame measured for the OB (e.g. 2009-01-01T04:31:12); this information is required since OBs can be executed several times
  • [BINNING_X] is a string containing the instrumental binning size as read from the DET.WIN1.BINX fits header (generally, 1)
  • [BINNING_Y] is a string containing the instrumental binning size as read from the DET.WIN1.BINY fits header (generally, 1)
  • [READ_MODE] is a string containing the instrumental read-out mode as read from the DET.READ.MODE fits header (generally, normal)
  • [READ_SPEED] is a string containing the instrumental read-out speed as read from the DET.READ.SPEED fits header (generally, normal)
  • a small subset of science products (OC_SSDI or OC_SSMA) are given an additional 4 digit number (i.e. 0004, 0041, 0042, etc.) . This is needed because these frames are products based on SINGLE exposures (and not the coaddition of all the exposures contained in the OB), and hence all have identical filter names, binning, and read modes.
  • [FILTER_NAME] is a string containing the filter name as read from the INS.FILT1.NAME fits header.
  • [ext] is fits or hdr

e.g.

OC_SSCI_705898_2012-05-29T06:48:12_1_1_normal_normal_r_SDSS.fits

OC_SSDI_715898_2012-07-08T06:48:12_g_SDSS_1_1_normal_normal_g_SDSS.fits

SCIENCE PIPELINE PRODUCTS

The following OmegaCAM science products presently exist:

Code type of file PRO_CATG
SSCI full, coadded stack of science frames (coaddition of all exposures in one OB) STACK_SCIENCE
SCMS science confidence map associated with science frames (coaddition of all images in one OB) CONF_MAP_SCIENCE
SCAT catalogue of all detected sources in science frame stack (fits table) SCIENCE_CATALOGUE
SSDI fully processed, single pointing science frame within the dither template SIMPLE_DITHER
SSJI fully processed, single pointing science frame within the jitter template SIMPLE_JITTER
SOFF fully processed, single pointing science frame within the offset template SIMPLE_OFFSET
SSTA fully processed, single pointing science frame within the stare template SIMPLE_STARE
SSMA the bad pixel mask associated with the fully processed, single pointing science frame SIMPLE_MASK

CALIBRATION PIPELINE PRODUCTS

OmegaCAM calibration products come in two flavours: dynamic ones (being updated regularly and having a relatively short validity), and static ones (never, or rarely updated). Both products are stored in the archive. The static ones (also called general calibration products) are also delivered in the public pipeline releases.

Dynamic calibrations. The following types of dynamic calibration products of OmegaCAM presently exist:

Code type of file PRO_CATG
MBIA master bias MASTER_BIAS
MHPM bad pixel map (hot pixels only) HOT_PIXELS_MAP
 
PRNA* bias read-out noise (fits table) READNOISE_ADU
 
MDAR master dark frame MEAN_DARK
 
PLIF* single dome flat instrument life test LIFETEST_CHECK
 
PSHU* shutter timing test (shutter direction of travel: up) DOME_SHUTTERTEST
PSHD* shutter timing test (shutter direction of travel: down) DOME_SHUTTERTEST
 
PDLI detector linearity information (fits table) DET_LIN_INFO
PDGI detector gain information (fits table) GAIN_INFO
PDCC* product cube of the detmon linearity coefficients cube COEFFS_CUBE
PDC0* single plane of detmon linearity coefficients cube (coeff 0) COEFFS_CUBE_P0
PDC1* single plane of detmon linearity coefficients cube (coeff 1) COEFFS_CUBE_P1
PDC2* single plane of detmon linearity coefficients cube (coeff 2) COEFFS_CUBE_P2
PDC3* single plane of detmon linearity coefficients cube (coeff 3) COEFFS_CUBE_P3
PDC4* single plane of detmon linearity coefficients cube (coeff 2) COEFFS_CUBE_P4
PDNL* map of non-linear pixels DB_MAP_NL
PDDF* difference images between the dome flats of the detmon template DIFF_FLAT
PDAC* auto-correlation of the images of the detmon template AUTOCORR
 
PILL illumination correction frame ILLUMINATION
 
MFLD master dome flat MASTER_FLAT_DOME
MCPM cold pixel map based on dome flat template COLD_PIXELS_MAP
 
MFLA master flat based on the combination of the master dome flat and the master twilight flat MASTER_FLAT
MFLT master twilight flat MASTER_FLAT_TWILIGHT
MBPM master bad pixel map based on the combination of the hot and cold pixel maps BAD_PIXELS_MAP
 
PSTD fully reduced standard star image REDUCED_STD
PSMA the bad pixel mask of the reduced standard star image REDUCED_STD_MASK
PPHO photometric table based on detected and extracted stars in reduced standard star field PHOTOMETRIC_TABLE
PZPT standard star zeropoints table ZEROPOINTS

* A quality control product only: These products are not ingested into the archive data base.

Static calibrations.

Static calibration products are also named according to a "nearly" standard OmegaCAM naming scheme.

Code type of file PRO_CATG Example
GEXT extinction curve fits table EXTINCTION_CURVE OC_GEXT_110729_ALL.fits
GUSN master catalogue of USNO A2 stars MASTER_USNOA2_CATALOGUE OC_GUSN_110728_USNOA2.fits
GSTD master catalogue of secondary standard stars (equatorial and polar fields) REFERENCE_STAR_CATALOG OC_GSTD_110728_ALL.fits
GMON monitoring report MONITOR_REPORT OC_GMON_110728_ALL.fits

Date of origin, version

The date of origin is identical to the date of the raw data measurement. It is coded as, e.g., 120331 for March 31, 2012.

The version of a file is indicated by capital letters always starting with A. Versioning is supported for certain types of files, see the above table. In all other cases, only one version per day is created (always A).

Instrumental parameters

The instrument parameters characterizing a setup are included in the product name. Most products have the following scheme:

OC_[MCODE][DATE][BINNING_X][BINNING_Y][READ_MODE][READ_SPEED][FILTER_NAME]

where:

  • BINNING_X/Y is usually: 1 / 1
  • READ_MODE is usually: normal
  • READ_SPEED is usually: normal
  • FILTER_NAME can be: u_SDSS / g_SDSS / r_SDSS / i_SDSS / z_SDSS / B_JOHN / V_JOHN / v_STRM / H_ALPHA / NB_659 / NB_852 / u_g_r_i_SDSS / opaque

for example:

OC_MFLA_120708_normal_normal_1_1_r_SDSS.fits

The [BINNING_X], [BINNING_Y], [READ_MODE] and [READ_SPEED] have been unchanged since the beginning of operations, Thus, they are currently skipped in the naming scheme, i.e.

OC_MFLA_120708A_r_SDSS.fits

Suffix

All product files have extension .fits. They have either image format or binary table format.


Send comments to <qc_omegacam@eso.org> powered by QC [webCMS v1.0.1]