VIMOS: codes for pipeline products

VIMOS:
Naming scheme

VIMOS:
QC home
TOC
QC
general info
QC1
Pipeline
general info
calib processing
science reduction
product naming
Service Mode
general info
directories
list files
problems, issues
Data
Management
general info
FAQs
SM run status

QC links:
QC home
HealthChecks
Reference Frames
QC1 database

FORS1 QC
FORS2 QC
GIRAFFE QC
ISAAC QC
MIDI QC
NACO QC
SINFO QC
UVES QC
VIMOS QC
VISIR QC
[best viewing with style sheets and javascript enabled]

All products of the VIMOS 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:

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

Instrument code

All VIMOS calibration product names start with VI. 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:

1^stletter M or P master file or product file

2^nd to 4^th letter ... type of product

The following types of calibration products presently exist:

CODE	TYPE OF FILE	PRO_CATG	VIMOS MODE	VERSIONING?
MBIA	master bias	MASTER_BIAS	IMG, MOS, IFU	no
MDRK	master dark	MASTER_DARK	IMG, MOS, IFU	yes

MKFI	master sky flat	IMG_MASTER_SKY_FLAT	IMG	yes
PSTI	reduced standard star field	IMG_STANDARD_REDUCED	IMG	yes
PZPI	zeropoint table	PHOTOMETRIC_TABLE	IMG	no

MSFM	master flat through MOS mask	MOS_MASTER_SCREEN_FLAT	MOS	yes
PWDM	inverse dispersion solution	EXTRACT_TABLE	MOS	yes
PRSM	spectrophotometric response	MOS_SPECPHOT_TABLE or MOS_MASTER_RESPONSE*	MOS	yes
PSRM	reduced standard star	MOS_STANDARD_REDUCED	MOS	yes

PTCF	fibre identification	IFU_TRACE	IFU	yes
PTNF	fibre transmission correction	IFU_TRANSMISSION	IFU	yes
PWDF	inverse dispersion solution	IFU_IDS	IFU	yes
MXFF	extracted flat spectrum per fibre	IFU_FLAT_SPECTRUM_EXTRACTED	IFU	yes
STRF	reduced fibre spectra	IFU_STANDARD_REDUCED	IFU	yes
STFF	reconstructed image of field of view	IFU_STANDARD_FOV	IFU	yes
PRSF	response curve	IFU_SPECPHOT_TABLE or IFU_MASTER_RESPONSE*	IFU	yes

* master response curves are averages of several individual measurements

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.

SCIENCE PRODUCT CODES

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

Instrument code

VIMOS science product names start with VI. 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:

1^stletter S science product file

2^nd to 4^th letter ... type of product

The following types of calibration products presently exist:

CODE	TYPE OF FILE	PRO_CATG	VIMOS MODE
SREI	reduced science image	IMG_SCIENCE_REDUCED	IMG

SREM	reduced spectra of objects found	MOS_SCIENCE_REDUCED	MOS
SRFM	flux calibrated spectra	MOS_SCIENCE_FLUX_REDUCED	MOS
SEXM	extracted spectra per slit	MOS_SCIENCE_EXTRACTED	MOS
SSKM	sky spectra per slit	MOS_SCIENCE_SKY	MOS
SSRM	sky spectra per object	MOS_SKY_REDUCED	MOS
SOTM	table for object identification	OBJECT_TABLE	MOS
SWTM	object positions on slit	WINDOW_TABLE	MOS
SFRM	fringe map*	MOS_FRINGES	MOS

SREF	reduced spectra per fibre	IFU_SCIENCE_REDUCED	IFU
SRFF	flux calibrated spectra	IFU_SCIENCE_FLUX_REDUCED	IFU
SSVF	reconstructed image of field of view	IFU_FOV	IFU

* The fringe map is produced only for jittered MOS observations with LR_red or HR_red grisms
if the offset between the frames is at least four pixels.

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

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.