[ ESO ]
SINFONI:
Pipeline product naming scheme

CAL | HC | refs | QC
QUALITY CONTROL
    HOME
SINFONI QC
Trending & QC1
Pipeline
product names
QC links:
general SINFONI

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

top SINFONI INSTRUMENT CODES

All SINFONI pipeline product names begin with "SI_".

SI_S . . . are science products.

SI_P . . . are calibration products.

 

top SINFONI SCIENCE PIPELINE PRODUCTS

SINFONI pipeline products have the following naming scheme:

SI_<SXXX>_<OBS_ID>_<date_time>_<DET_DIT>_<grating>_<camera_scale>.<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
  • <DET_DIT> is a string containing the detector integration time (in seconds) as read from the DET.DIT fits header
  • <grating> is a string containing the instrumental grating used in the observation as read from the INS.GRAT1.NAME fits header (either H, J, K, or H+K)
  • <camera_scale> is a string containing the camera pixel scale used in the observation as read from the INS.OPTI1.NAME fits header (either 25, 100, or 250 mas)
  • a small subset of science products (SI_SBNS or SI_SXBJ) are given an additional 4 digit number (i.e. 0004, 0041, 0042, etc.) . This is needed because these frames are SINGLE exposure cubes (and not the coaddition of all the exposures contained in the OB), and hence all have identical dits, gratings, and camera scales.
  • <ext> is fits

e.g.

SI_SCDJ_186898_2009-01-29T06:48:12_600_H+K_250.fits

SI_SBNS_186898_2009-01-29T06:48:12_600_H+K_250_0041.fits

top SCIENCE PIPELINE PRODUCTS

The following SINFONI science products presently exist:

CODE TYPE OF FILE PRO_CATG
SCDJ full, coadded science product cube (coaddition of all exposures in OB) COADD_OBJ
SXBJ single exposure science product cube (for each exposure in OB) OBS_OBJ
SKCD mask of full, coadded science product cube MASK_COADD_OBJ
SMCD median collapse of science product cube MED_COADD_OBJ
SBNS single exposure, median collapsed science cube, distortion corrected OBJECT_NODDING_STACKED
SROB stacked and wavelength-resampled object image with distortion correction applied RESAMPLED_OBJ
 
SBCS* full, coadded cube sky frame (coaddition of all sky exposures in OB) OBS_CUBE_SKY
SBMS* median collapse of sky cube OBS_MED_SKY
SXSK single exposure sky product cube (for each exposure in OB) OBS_SKY
SXSM median image of sky cube SKY_MED
SSSD stacked sky image SKY_STACKED_DUMMY
SSDI stacked sky image with distortion correction applied SKY_STACKED_DIST
SRFL stacked and resampled flat image with distortion correction applied RESAMPLED_FLAT_LAMP
SRSK stacked and resampled sky image with distortion correction applied RESAMPLED_SKY

* A quality control product only: Not packed in service mode data distribution to PI.

 

top CALIBRATION PIPELINE PRODUCTS

SINFONI calibration products come in two flavours: dynamic ones (being updated regularly, short validity), and static ones (never, or rarely updated). Both product types are delivered in the data packages and 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 SINFONI presently exist:

CODE TYPE OF FILE PRO_CATG VERSIONING?
PMDK master dark MASTER_DARK yes
PHPM bad pixel map (hot pixels) BP_MAP_HP yes
 
PLPM* bad pixel map (non-linear pixels) BP_MAP_NL yes
PLCF* coefficients of non-linear fit to pixel intensity (image cube) BP_COEFF yes
PLDF* table with coefficients of non-linear fit to median of each input flat image LIN_DET_INFO yes
PLGN* table of detector gain values GAIN_INFO yes
 
PDST table of computed optical X/Y distortion DISTORTION yes
PSLD table with computed distance between each slitlet SLITLETS_DISTANCE yes
PDPM* above threshold bad pixel map image BP_MAP_DI yes
 
PMFL master lamp flat MASTER_FLAT_LAMP yes
PNPM* bad pixel map (cold pixels) BP_MAP_NO yes
PMPM master bad pixel map (hot, cold and non-linear pixels) MASTER_BP_MAP yes
 
PWSP table of slitlet edge positions SLIT_POS yes
PWMP wavelength map image (wavelength = image intensity) WAVE_MAP yes
PWFP* table of fit parameters to arc lines WAVE_FIT_PARAMS yes
PWCS* table with parabolic fit coefficients for each pixel row WAVE_COEF_SLIT yes
PWLS* stacked arc lamp image WAVE_LAMP_STACKED yes
PWRW wavelength resampled arc lamp image RESAMPLED_WAVE yes
 
PCST full, coadded standard star cube (coaddition of all exposures in OB) COADD_STD yes
PXST* single exposure standard star cube (for each exposure in OB) OBS_STD yes
PKCS* mask of full, coadded standard star cube MASK_COADD_STD yes
PMCS* median collapse of standard star product cube MED_COADD_STD yes
PSNS* single exposure, median collapsed standard star cube, distortion corrected STD_NODDING_STACKED yes
PSSA table of extracted spectrum of standard star (wavelength vs. flux) STD_STAR_SPECTRA yes
PSSM* collapsed (1d) image spectrum of standard star STD_STAR_SPECTRUM yes
PSFA* average collapse of flat field cube MFLAT_AVG yes
PSFM* median collapse of flat field cube MFLAT_MED yes
PSFS* stacked master flat field image MFLAT_STACKED_DIST yes
PSCS* full, coadded cube sky frame (coaddition of all sky exposures in the standard star OB) STD_CUBE_SKY yes
PSRO stacked and wavelength-resampled object (telluric standard) image with distortion correction applied RESAMPLED_OBJ_STD yes
PSRS stacked and wavelength-resampled sky (telluric standard) image with distortion correction applied RESAMPLED_SKY_STD yes
 
PCPF* full, coadded standard psf cube (coaddition of all exposures in OB) COADD_PSF yes
PXPF* single exposure psf star cube (for each exposure in OB) OBS_PSF yes
PKCP* mask of full, coadded psf star cube MASK_COADD_PSF yes
PMCP* median collapse of psf star product cube MED_COADD_PSF yes
PPCS* single exposure, median collapsed psf star cube, distortion corrected PSF_CALIBRATOR_STACKED yes
PSSA* table of extracted spectrum of standard star (wavelength vs. flux) STD_STAR_SPECTRA yes
PMPF median collapse of psf star cube MASTER_PSF yes
PAOP* table of psf star strehl information (wavelength vs. strehl) AO_PERFORMANCE yes
PEEE* table of encircled energy information ENC_ENERGY yes
PPCS* full, coadded cube sky frame (coaddition of all sky exposures in the psf OB) PSF_CUBE_SKY yes
PPMS* median collapse of sky cube PSF_MED_SKY yes

* A quality control product only: Not packed in service mode data distribution to PI.

 

top Static calibrations. With P81 (April 2008) and thereafter, the static calibration products are also named according to a "nearly" standard SINFONI naming scheme. Before that date, their names did not follow a strict naming scheme. The following table lists the codes in the new name scheme:

 

CODE TYPE OF FILE PRO_CATG EXAMPLE
GARC

arc line reference table (J, H, H+K, K bands)

REF_LINE_ARC

SI_GARC_050331A_H+K.fits

GBPM reference bad pixel map (image) REF_BP_MAP SI_GBPM_050331A_REF_BP_MAP.fits
GCOL position of first slitlet column (table) FIRST_COL SI_GCOL_050331A_FIRST_COL.fits
GDRS first guess wavelength dispersion solution table DRS_SETUP_WAVE SI_GDRS_050331A_DRS_SETUP_WAVE.fits
GATM atmospheric dispersion correction table ATM_REF_CORR SI_GATM_REF_CORR_J_025.fits *

*Note: The atmospheric dispersion correction tables exist for all grisms (S1_J, S2_H, S3_K, and S4_H+K) and for the 25 and 100 mas pixel scales.
The 250 mas pixel is not corrected, since at this pixel scale the maximal shift due to atmospheric dispersion is less than one pixel. The correction of
data cubes for atmospheric dispersion is implemented in SINFONI pipeline versions after 2.0.9.

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., 050331 for March 31, 2005.

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:

<GRATING><CAMERA_SCALE>

where:

  • GRATING is either J, H, K, or H+K bands (from the INS.GRAT1.NAME fits header)
  • CAMERA_SCALE is the pixel scale as defined by the pre-optics: 250, 100, or 25 mas (from the INS.OPTI1.NAME fits header)

for example:

SI_PKCS_090127D_J_250.fits

DARK products have only a <DET_DIT> exposure time (in seconds) designator (eg. SI_PMDK_090127A_300.fits)

 

Suffix

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


 
[ESO][Index][Search][Help][News]