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 MUSE pipeline product names start with "MU_".
Dynamic calibrations. There are following types of dynamic
calibration products of MUSE:
Code | type of file | PRO_CATG |
MBIA | master bias | MASTER_BIAS |
MDRK | master dark | MASTER_DARK |
|
MFLA | master lamp flat | MASTER_FLAT |
PFTT | slices tracing table | TRACE_TABLE |
|
MFLS | master sky flat | MASTER_SKYFLAT |
|
PWCT | wavecal table | WAVECAL_TABLE |
|
MDCS | datacube for standard star | DATACUBE_STD |
MSDR | instrument response | STD_RESPONSE |
MSDT | telluric lines | STD_TELLURIC |
|
MDCA | datacube for astrometry | DATACUBE_ASTROMETRY |
MAWC | wcs from astrometric observation | ASTROMETRY_WCS |
Static calibrations.
The following table lists the codes in the name scheme:
Code | type of file | PRO_CATG |
GASR | astrometry reference table | ASTROMETRY_REFERENCE |
GBPT | bad pixel table | BADPIX_TABLE |
GEOT | geometry table | GEOMETRY_TABLE |
GEXT | extinction table | EXTINCT_TABLE |
GFIL | list of filters | FILTER_LIST |
GLNC | catalog of spectroscopic lines | LINE_CATALOG |
GSFT | standard stars flux table | STD_FLUX_TABLE |
GSKL | sky lines | SKY_LINES |
GLST | lsf table | LSF_TABLE |
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., 141015 for Oct 15, 2014.
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 MUSE products have the following scheme:
<INS.MODE>_<INS.OPTI1.NAME><DET.READ.CURNAME>
where
- INS.MODE is either WFM-NOAO-E (wide field mode - no AO -
extended range) or WFM-NOAO-N (wide field mode - no AO - nominal
range), or WFM-AO-N_Blue-Na2, WFM-AO-E_Na correspondingly
- INS.OPTI1.NAME (filter) is either Clear, Blue for noAO and Na
Blue-Na2 for AO modes
- DET.READ.CURNAME is SCI1.0 or FAST.
Static calibration products either have some setup part, or contain some
self-explanatory string like e.g. MU_GSFT_140101A_stdflux_table.fits for the
standard stars' table.
Extension
All product files have extension .fits. They have either image format or
binary table format.
NOTE: all MUSE image pipeline products have in addition to the
image part extensions with the statistics (STAT) and data quality (DQ)
for each IFU/CHANNEL.
Examples
MU_MBIA_140822A_WFM-NOAO-E_Clear_SCI1.0.fits: master bias taken on 2014-08-22
MU_MFLA_140606B_WFM-NOAO-N_Blue_SCI1.0.fits: master flatfield taken on
2014-06-06 (second one that day).
|