LIST OF PIPELINE PRODUCTS CODES

The names of all 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 parameter values all recognizable from the product name.

Since the begin of period 75 (April 2005), both science and calibration product files are renamed. (Actually, there was a transition phase extending for some instruments from April towards the end of the year 2005).

Before that date only calibration products followed the common scheme which is described here. (Some instruments had their own naming scheme which is described below, if applicable).

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

Instrument code

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

Type of product

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

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

All OmegaCAM pipeline product names begin with "OC_".

OC_S . . . are science products.

OC_P and OC_M . . . are calibration 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

top 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

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

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

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

top 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).

top 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

Suffix

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