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 GIRAFFE pipeline product names start with "GI_".
Dynamic calibrations.
The following types of dynamic calibration products of
GIRAFFE exist:
Code | type of file | PRO_CATG |
MBIA | master bias | MASTER_BIAS |
MDRK | master dark | MASTER_DARK |
|
PLOW | localization width | FF_LOCWIDTH |
PLOC | localization centroid | FF_LOCCENTROID |
PFEX | extracted spectra | FF_EXTSPECTRA |
PFEE | extraction errors | FF_EXTERRORS |
|
PNLW | localization width (nasmyth flats) | NF_LOCWIDTH |
PNLC | localization centroid (nasmyth flats) | NF_LOCCENTROID |
PNEX | extracted spectra (nasmyth flats) | NF_EXTSPECTRA |
PNEE | extraction errors (nasmyth flats) | NF_EXTERRORS |
|
PDIS | dispersion solution | DISPERSION_SOLUTION |
PRBS | rebinned spectra | ARC_RBNSPECTRA |
|
PSRS* | rebinned spectra (STD) | STD_RBNSPECTRA |
PIMG* | reconstructed image (STD) | STD_RCSPECTRA |
PRSP* | instrument response (STD) | INSTRUMENT_RESPONSE |
* for Argus only
Static calibrations.
These are the codes for the static calibrations:
Code | type of file | PRO_CATG |
GCAT | line catalog | LINE_CATALOG |
GRAT | grating data | GRATING_DATA |
GMSK | line mask | LINE_MASK |
GDIS | reference dispersion solution | REFERENCE_DISP_SOLUTION |
GSGS | slit geometry setup | SLIT_GEOMETRY_SETUP |
GFLX | flux standard list | FLUX_STANDARDS |
GATM | extinction table | ATMOSPHERIC_EXTINCTION |
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. Most GIRAFFE products have the following scheme:
<SLIT>_<GRATING><WLEN>nm_o<ORDER> or
(since 2010-10-20):
<SLIT>_<GRATING><WLEN>_o<ORDER>_<READ>
where
- SLIT is either Medusa1, Medusa2, IFU1, IFU2, or Argus,
- GRATING is either H (high resolution) or L (low resolution)
- WLEN is the central wavelength in nm of the mode,
- ORDER is the spectral order (to distinguish 'old' and 'new' setups),
- READ is either n (Normal) or f (Fast) or s (Slow) and indicates the read speed.
Master biases have only =1x1 and = n/f/s as setup string.
STD data have in addition the target name coded,
<SLIT>_<GRATING><WLEN>nm_o<ORDER>_<TARG_NAME>.
Static calibration products either have some setup part, or contain some
self-explanatory string like e.g. GI_GATM_021213A_atm_extinction.fits for the
extinction table.
Extension
All product files have extension .fits. They have either image format or
binary table format. Most GIRAFFE pipeline products have in addition to the
image part an extension with the 'fibre-setup table'. That table lists the
fibre parameters (from the ozpoz and fibre tables attached to the raw files)
for the fibres actually found. More ...
Examples
GI_PDIS_140516A_Argus_L773.4nm_o2.fits: dispersion solution for Argus, setup
L773.4 (order 2); taken on date 2014-05-16 (first one on that date).
GI_PFEX_180606B_Medusa2_L427.2nm_o4.fits: extracted flat for Medusa2, setup
L427.2 (order 4); taken on date 2018-06-06 (second one).
GI_PFEX_201106B_Medusa2_L427.2nm_o4_n.fits: same product type, taken on date
2020-11-06.
GI_MBIA_140101A_1x1_f.fits: master bias for 2014-01-01, fast mode.
|