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

 

CALIBRATION PRODUCT CODES

Naming scheme

The naming scheme has the product type, the date of creation, and pipeline-relevant parameter values all recognisable from its name. The general scheme is:

VI_<TYPE>_<DATE><VERSION>_<PARAMS>.<SUFFIX> .

Type of product

The following types of calibration products presently exist:

Date of origin, version

The date of origin is identical to the date of the raw data measurement. It is coded as, e.g., 051015 for Oct 15, 2005. The version of a file is indicated by capital letters always starting with A. Versioning is supported for most types of files (see table above). In the remaining cases, only one version per day is created (version is always A).

Instrumental parameters

Those parameters which are relevant for the specific type of calibration product are included in its name. The following schemes are used:

PARAMETER CODE USED FOR FILE TYPES VIMOS MODE Q<QUAD>_<GAIN> MBIA, MDRK IMG, MOS, IFU <FILT>_Q<QUAD>_<GAIN> MKFI, PSTI, PZPI IMG <ORDFLT>_<GRISM>_<MASK>_Q<QUAD>_<GAIN> MSFM, PWDM, PRSM, PSRM MOS <ORDFLT>_<GRISM>_<IFUMAG><IFUSHUT>_Q<QUAD>_<GAIN> PTCF, PTNF, PWDF IFU

where

PARAMETER EXPLANATION VALUES <QUAD> instrument quadrant (channel) 1, 2, 3, 4 <GAIN> detector gain lo: low gain, used for imaging; hi: high gain, used for spectroscopy <FILT> name of broadband filter U, B, V, R, I, z <ORDFLT> name of order sorting filter OS-blue, OS-red, GG435, GG475; "_" for "free" <GRISM> name of grism LRb: LR_blue; LRr: LR_red; MR; HRb: HR_blue; HRo: HR_orange; HRr: HR_red <MASK> identifier of MOS mask 6 digits, e.g. 100320 <IFUMAG> IFU magnification 1, 2 <IFUSHUT> IFU shutter ON, OFF

Extension

The master files have extension .fits, while most product files are tables and have extension .tfits .

Examples

BIAS:

VI_MBIA_051002A_Q1_lo.fits is the (first and only) master bias for imaging (low gain) for quadrant 1 from 2005-10-02.

VI_MBIA_051002A_Q3_hi.fits is the (first and only) master bias for spectroscopy (high gain) for quadrant 3 from 2005-10-02.

IMG:

VI_MKFI_050912B_I_Q2_lo.fits is the second (from at least two) master sky flats for the I filter and quadrant 2 from 2005-09-12.

MOS:

VI_PWDM_041212A_GG475_MR_200945_Q4_hi.tfits is a MOS dispersion solution for the MR grism with filter GG475, taken for the mask ID 200945 in quadrant 4.

IFU:

VI_PTCF_051002C_GG435_HRo_1ON_Q1_hi.tfits is a fibre indentification table for the HR_orange grism with filter GG435 for quadrant 1, IFU magnification is 1, IFU shutter is on.

Naming scheme

The naming scheme has the product type, a date, and a name or relevant instrument parameters. The general scheme is:

VI_<TYPE>_<DATE><VERSION>_<PARAMS>.<SUFFIX>

or

VI_<TYPE>_<DATE><VERSION>_<NAME>.<SUFFIX> .

Type of product

The following types of static calibrations presently exist:

Naming scheme

The naming scheme has the product type, the ID of the observation block, a time stamp, and pipeline-relevant parameter values all recognisable from its name. The general scheme is:

VI_<TYPE>_<OB_ID>_<TIMESTAMP>_<PARAMS>.<SUFFIX> .

Type of product

The following types of calibration products presently exist:

OB ID

The ID of the observation block that has been used to measure the raw science frame. It has usually six digits, e.g. 154718.

Time stamp

The time stamp has the form <YEAR>-<MONTH>-<DAY>T<HOUR>:<MINUTE>:<SECOND>.<MILLISEC>. It has the same value that is used in the archive filename of the raw file, e.g. 2005-01-18T04:45:19.435.

Instrumental parameters

The instrumental parameters for the science frames are the same as for the calibrations in order to identy matching files. These three schemes are used:

PARAMETER CODE USED FOR FILE TYPES VIMOS MODE <FILT>_Q<QUAD>_<GAIN> SREI IMG <ORDFLT>_<GRISM>_<MASK>_Q<QUAD>_<GAIN> SREM, SEXM, SSKM, SSRM, SOTM, SWTM, SFRM MOS <ORDFLT>_<GRISM>_<IFUMAG><IFUSHUT>_Q<QUAD>_<GAIN> SREF, SSVF IFU

where

PARAMETER EXPLANATION VALUES <QUAD> instrument quadrant (channel) 1, 2, 3, 4 <GAIN> detector gain lo: low gain, used for imaging; hi: high gain, used for spectroscopy <FILT> name of broadband filter U, B, V, R, I, z <ORDFLT> name of order sorting filter OS-blue, OS-red, GG435, GG475; "_" for "free" <GRISM> name of grism LRb: LR_blue; LRr: LR_red; MR; HRb: HR_blue; HRo: HR_orange; HRr: HR_red <MASK> identifier of MOS mask 6 digits, e.g. 100320 <IFUMAG> IFU magnification 1, 2 <IFUSHUT> IFU shutter ON, OFF

Extension

Most files have extension .fits, while some product files are tables and have extension .tfits .

Example

VI_SREI_199201_2005-10-02T05:33:39.651_R_Q1.fits: reduced science image, the ID of the OB was 199201, the raw file was measured on 2 October 2005 at 05:33:39.651 (UT). The R filter has been used; the file is from quadrant 1.