[ ESO ]
CRIRES:
Naming scheme

CAL | HC | refs | QC
QUALITY CONTROL
    HOME
CRIRES QC
Trending & QC1
Pipeline
Data Packages
Data Management
QC links:
 
calibration products static calibrations science products

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

 
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:

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

Type of product

The following types of calibration products presently exist:

CODE TYPE OF FILE PRO_CATG VERSIONING?
PDRK master dark CALPRO_DARK yes
PBPM bad pixel map CALPRO_BPM yes
PFLT master flat CALPRO_FLAT yes
PDIS dispersion solution CALPRO_WAVE yes
PWMA 2D wavelength map from calibration WL_MAP_IMA yes
PWMP 2D wavelength map from physical model WL_MAP_MODEL_IMA yes
PSMA 2D wavelength map of dispersion solution used for standard star calibration STD_WL_MAP_IMA yes
PSMP

2D wavelength map from physical model
(determined from standard star observation)

STD_WL_MAP_MODEL_IMA yes
PEFF STD star extracted spectrum and efficiency spectrum STD_EXTRACT_SENS_TAB yes
PEXT STD star extracted spectrum STD_EXTRACT_WL_TAB yes
PCOM STD combined nodding image STD_COMBINED_IMA yes
PCON STD contribution map STD_CONTRIBUTION_IMA yes
PBGD STD background map STD_BGD_MAP_IMA yes
PPRF STD extraction profile STD_PROFILE_IMA yes
For windowed detector read-out mode:
PDRW master dark (windowed read-out) CALPRO_DARK_WIN yes
PBPW bad pixel map (windowed read-out) CALPRO_BPM_WIN yes
PFLW master flat (windowed read-out) CALPRO_FLAT_WIN yes
PMAW 2D wavelength map of dispersion solution used for standard star calibration (windowed read-out) STD_WIN_WL_MAP_IMA yes
PMPW

2D wavelength map from physical model, determined from standard star observation (windowed read-out)

STD_WIN_WL_MAP_MODEL_IMA yes
PEFW STD star extracted spectrum and efficiency spectrum (windowed read-out) STD_WIN_EXTRACT_SENS_TAB yes
PEXW STD star extracted spectrum (windowed read-out) STD_WIN_EXTRACT_WL_TAB yes
PCMW STD combined nodding image (windowed read-out) STD_WIN_COMBINED_IMA yes
PCNW STD contribution map (windowed read-out) STD_WIN_CONTRIBUTION_IMA yes
PBGW STD background map (windowed read-out) STD_WIN_BGD_MAP_IMA yes
PPRW STD extraction profile (windowed read-out) STD_WIN_PROFILE_IMA yes

Date of origin, version

The date of origin is identical to the date of the raw data measurement. It is coded as, e.g., 070402 for Apr 02, 2007. 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
DIT<DIT> PDRK
<WLEN>nm PBPM, PFLT, PDIS, PWMA
DIT<DIT>_<WLEN>nm PEFF, PEXT, PCOM, PPRF, PCON

where

PARAMETER EXPLANATION VALUES
<DIT> detector DIT in sec e.g. 1, 15, 60
<WLEN> reference wavelength on chip 3 in nm e.g. 1090.4

Extension

All files have extension .fits .

Examples

CR_PDRK_070402A_DIT60.fits is a dark product (master) frame from 2007-04-02 with DIT=60 sec.

CR_PDIS_070411B_1648.9nm.fits is the second (from at least two) dispersion solution table from 2007-04-11 for 1648.9 nm reference wavelength.

CR_PEFF_070411A_DIT15_5050.4nm.fits is a standard star product for 5050.4 nm reference wavelength measured with DIT=15 sec on 2007-04-11.

STATIC CALIBRATIONS

Naming scheme

The naming scheme has the product type, a date, and short description. The general scheme is:

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

Type of product

The following types of static calibrations presently exist:

CODE TYPE OF FILE
GCAT line catalogs
GFLX standard star flux
GMOD configuration for physical model

 

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:

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

Type of product

The following types of calibration products presently exist:

CODE TYPE OF FILE PRO_CATG
SEXT extracted science spectra OBS_EXTRACT_WL_TAB
SCOM combined nodding images OBS_COMBINED_IMA
SCON contribution map OBS_CONTRIBUTION_IMA
SPRF extraction profile image OBS_PROFILE_IMA
SBGD map used for background noise calculation OBS_BGD_MAP_IMA
SWMA 2D wavelength map of dispersion solution used for science calibration OBS_WL_MAP_IMA
SWMP 2D wavelength map from physical model
(determined from science observation)
OBS_WL_MAP_MODEL_IMA
For windowed read-out:
SEXW extracted science spectra (windowed read-out) OBS_WIN_EXTRACT_WL_TAB
SCMW combined nodding images (windowed read-out) OBS_WIN_COMBINED_IMA
SCNW contribution map (windowed read-out) OBS_WIN_CONTRIBUTION_IMA
SPRW extraction profile image (windowed read-out) OBS_WIN_PROFILE_IMA
SBGW map used for background noise calculation (windowed read-out) OBS_WIN_BGD_MAP_IMA
SMAW 2D wavelength map of dispersion solution used for science calibration (windowed read-out) OBS_WIN_WL_MAP_IMA
SMPW 2D wavelength map from physical model,
determined from science observation (windowed read-out)
OBS_WIN_WL_MAP_MODEL_IMA

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. 2007-04-18T04:45:19.435.

Instrumental parameters

The instrumental parameters for the science frames are the same as for the calibrations in order to identify matching files:

PARAMETER CODE USED FOR FILE TYPES
DIT<DIT>_<WLEN>nm SEXT, SCOM, SCON, SPRF, SBGD, SWMA, SWMP

where

PARAMETER EXPLANATION VALUES
<DIT> detector DIT in sec e.g. 1, 15, 60
<WLEN> reference wavelength on chip 3 in nm e.g. 1090.4

Extension

All files have extension .fits .

Example

VI_SEXT_218201_2007-04-02T08:53:01.761_DIT30_1202.9nm.fits: table with extracted science spectra, statistical errors, etc.; the ID of the OB was 218201, the (first) raw file was measured on 2 April 2005 at 08:53:01.761 (UT) with reference wavelength 1202.9 nm and a DIT of 30 sec.


[ QC Home page ]
 
[ESO][Index][Search][Help][News]