All products of the UVES/UVES-MOS pipeline that are delivered to end-users or are ingested into the ESO archive follow certain naming conventions. This is done to have human-readable names rather than archive or original file names. Naming schemes exist for both calibration and science products.

 

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:

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

Instrument code

All UVES and UVES-MOS calibration product names start with UV. All VLT instruments follow the same scheme, i.e. their calibration products also start with a two letter instrument code.

Type of product

The product type is given by the fits key HIERARCH.ESO.PRO.CATG. A short form of this is coded in the name using a four character scheme:

1st letter M or P master file or product file 2nd to 4th letter ... 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., 011015 for Oct 15, 2001. The version of a file is indicated by capital letters always starting with A. Versioning is supported for certain types of files only (see table above). In all other 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 UVES FLAVOUR <CCD>_<BIN> MBIA, MDRK ECH, MOS <CCD><WLEN><MODE>_<BIN>_<SLTW> PDRS, PLI1,2,3, MFLT, MDFT, MIFT ECH <CCD><WLEN><MODE>_<BIN> PORD, PBKG, PGUE, PEFC, PRSP ECH <CCD><WLEN> MRSP ECH <CCD><WLEN><MODE>_SI<SIMCAL>_PL<PLATE> MFxx, MSxx, PDRS, PORD, PLIN MOS <CCD><WLEN><MODE>_PL<PLATE> PGUE, PODF, POGU MOS <CCD><WLEN><MODE> MSFT MOS

where

PARAMETER EXPLANATION VALUES <CCD> CCD designation BLUE, REDL, REDU <WLEN> wavelength in nm (e.g. 580) <MODE> observation mode (INS.MODE keyword) bl: blue arm; re: red arm; d1: dichroic#1, d2: dichroic#2; fi: fibre mode <BIN> detector binning (x times y) 1x1, 2x2, 1x2, 2x3 <SLTW> slit width in arcsec * 10 (e.g. 0.5 arcs are coded as 05, and 2.1 arcs as 21) <PLATE> observation plate 1 or 2 <SIMCAL> SimCal mode 0: calibrations for science that do not use the simultaneous calibration fibre; 1: for science that use the simultaneous calibration fibre

<SIMCAL> is set according to the value of the INS.SLIT3.MODE keyword (from the fits headers): 6FIB or 8FIB means SIMCAL=0, 7+1FIB means SIMCAL=1.

Extension

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

Master products from slit and fibre flats (UVES-MOS)

There is a large number of pipeline products that are derived from combining slit and fibre flat fields. From Period 74 on (i.e. from 1 October 2004), these products are coded with MSxx or MFxx:

Some of the products (BN, BP, DT, SG) come as data cubes combining up to three individual files. The original files can be recovered using the DECUBI/FLAM command of the MIDAS FLAMES context:

midas> indisk/fits <file>.fits <file>.bdf
midas> decubi/flam <file>.bdf <plane> <outputname>.bdf no

with <plane> = 1, 2, or 3. Example:

midas> decubi/flam UV_MSDT_050309A_REDL580fi_SI0_PL1.bdf 2 master2L.bdf no .

For master files produced in Period 73 or earlier, the type was either MSFT of MFFT and an additional three letter code was added after the instrumental parameters. Data cubes were not used.

Examples

UVES/UVES-MOS:

UV_MBIA_030227A_REDU_1x1.fits is the (first and only) master bias for REDU_1x1 from 2003-02-27. It is valid for all files from the red upper CCD and with binning 1x1.

UVES (ECH):

UV_PORD_010421A_REDU580d1_2x2.tfits is the order table from 2001-04-21 for UVES setting REDU580d1_2x2 (since the corresponding raw file has data from both red CCDs, there will always be a corresponding REDL product).

UV_PLI2_011021C_BLUE346bl_1x1_07.tfits is the so-called object line table from 2001-10-21 for setting BLUE346bl_1x1, slit width 0.7 arcs. It is the third one from this night (from at least three).

UVES-MOS:

UV_MSFT_030226C_REDL580re.fits is the third master slit flat field from 2003-02-26 for central wavelength 580nm and the (red) lower chip. Usually, slit flat fields are recorded in three different positions so that three master slit flats exist.

UV_MSDT_041001A_REDU580fi_SI0_PL1.fits is one of the several different master slit flat products. It should be used for science data from plate 1 which are not using the SimCal feature.

UV_MFFT_030226A_REDL580fi_SI1_PL2_NSG.fits is an example for the old (P73 and earlier) naming scheme for master fibre flat fields. It can be taken for science frames using simultaneous calibration and plate 2. 'NSG' distinguishs this product from other products of the same reduction step.

UV_PLIN_030226C_REDU860fi_SI0_PL2.tfits is the line table from 2003-02-26 for the red upper chip, 860nm, plate 2, and SIMCAL=0. It is the third one from this night (from at least three).

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:

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

Instrument code

All UVES and UVES-MOS science product names start with UV. All VLT instruments follow the same scheme, i.e. their calibration products also start with a two letter instrument code.

Type of product

The product type is given by the fits key HIERARCH.ESO.PRO.CATG. A short form of this is coded in the name using a four character scheme:

1st letter S science product file 2nd to 4th letter ... 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 two schemes are used:

PARAMETER CODE UVES FLAVOUR <CCD><WLEN><MODE>_<BIN>_<SLTW> ECH <CCD><WLEN><MODE>_SI<SIMCAL>_PL<PLATE> MOS

where

PARAMETER EXPLANATION VALUES <CCD> CCD designation BLUE, REDL, REDU <WLEN> wavelength in nm (e.g. 580) <MODE> observation mode (INS.MODE keyword) bl: blue arm; re: red arm; d1: dichroic#1, d2: dichroic#2; fi: fibre mode <BIN> detector binning (x times y) 1x1, 2x2, 1x2, 2x3 <SLTW> slit width in arcsec * 10 (e.g. 0.5 arcs are coded as 05, and 2.1 arcs as 21) <PLATE> observation plate 1 or 2 <SIMCAL> SimCal mode 0: science does not use simultaneous calibration fibre; 1: science uses simultaneous calibration fibre

<SIMCAL> is set according to the value of the INS.SLIT3.MODE keyword (from the fits headers): 6FIB or 8FIB means SIMCAL=0, 7+1FIB means SIMCAL=1.

Extension

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

Examples

UVES (ECH):

UV_SRED_123908_2004-12-01T01:45:74.446_BLUE390d1_1x1_08.fits: reduced spectrum, the ID of the exectuded OB was 123908, the raw file was measured on 1 Dec 2004 at 01:45:74.446 (UT). The spectrum is from the blue arm of UVES, 390nm central wavelength, dirchroic#1 mode, 1x1 detector binning, and 0.8 arcsec slit width.

UVES-MOS:

UV_SERR_165221_2005-02-09T04:10:43.008_REDU580fi_SI0_PL1.fits: errorbars for the reduced spectra, the ID of the executed OB was 165221, the raw file was measured on 9 February 2005 at 04:10:43.008 UT. The file is for the upper (red) CCD, 580nm central wavelength, and fibre mode (the only mode for UVES-MOS science). The observation did not use simultaneous wavelength calibration and has been carried out with observation plate 1.