Data product names
The names of all calibration 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 setup values recognizable in the product name.
The general format of user-oriented product file names is the same for all
VLT/VLTI instruments.
On the archive interface, the master calibrations can be associated to science files and downloaded. Then they carry
technical filenames (the archive filename ARCFILE). In order to rename them to the
original filenames, search for the fits header key ORIGFILE. The naming scheme
of ORIGFILE is described here.
Instrument code
All product names start with two letters which are specific for the
instrument. For instance: UVES product names start with 'UV', VISIR names with
'VR'.
Product category
The full value of the product category is coded in the FITS header
key HIERARCH.ESO.PRO.CATG. A short form of this tag is encoded in four
characters being unique per instrument:
1st letter | M or P | calibration product |
| G | general (static) calibration product |
2nd to 4th letter | ... | type of product |
Calibration products come in two flavours: dynamic ones (being updated
regularly, short validity), and static ones (never or rarely updated). The
static ones are also called 'general' because they often are not derived from
raw data (like e.g. a line catalogue).
Both
product types are stored in the archive and are available for download through
the calSelector service.
All KMOS pipeline product names start with "KM_".
Dynamic calibrations.
The following types of dynamic calibration products of
KMOS exist:
Code | type of file | PRO_CATG |
PDRK | master dark | MASTER_DARK |
PBPD | bad pixel mask | BADPIXEL_DARK |
|
PFLT | master flat | MASTER_FLAT |
PBPF | final bad pixel mask | BADPIXEL_FLAT |
PEDG | slitlet localization | FLAT_EDGE |
PXCL | slitlet localization | XCAL |
PYCL | slitlet localization | YCAL |
|
PLCL | wavelength calibration | LCAL |
|
PILL | IFU illumination correction | ILLUM_CORR |
|
PTEL | telluric spectrum | TELLURIC |
PSPC | extracted standard star spectrum | STAR_SPEC |
PTEG | general telluric spectrum | TELLURIC_GEN |
Static calibrations.
These are the codes for the static calibrations:
Code | type of file | PRO_CATG |
GCAT | arc line catalog | ARC_LIST |
GATM | atmospheric model data | ATMOS_MODEL |
GSOL | solar spectrum | SOLAR_SPEC |
GSTY | lookup table for spectral types | SPEC_TYPE_LOOKUP |
GWBD | wavelength bands | WAVE_BAND |
GREF | reference arc lines | REF_LINES |
GRES | averaged responce curves | RESPONSE |
GKER | kernel for molecfit | KERNEL_LIBRARY |
GOHS | OH spectrum | OH_SPEC |
The remaining part of the names follow the same convention as for the dynamic
products (see below).
Date of origin, version
The date of origin is identical to the date of the raw data measurement. It
is coded like, e.g., 191015 for Oct 15, 2019.
The version of a file is indicated by capital letters, starting with A.
Versioning is supported when reasonable, otherwise it is always A.
Instrument parameters
The instrument parameters characterizing a setup are included in the product
name. KMOS products have either the DIT as instrument set-up (for
MASTER_DARK and BADPIXEL_DARK) or the wavelength band (IZ, YJ, H, HK, or K).
Static calibration products either have some setup part, or contain some
self-explanatory character string.
File name extension
All product files have extension .fits. They have either image format or
binary table format.
Examples
KM_PBPD_180912A_DIT60.fits: a bad pixel mask derived from a set of darks with DIT=60s,
measured on 2018-09-12.
KM_PLCL_180912A_K.fits: a wavelength calibration product for the K band from
the same date.
|