mirror sites: PL (internal link) HQ     [?]

Quality Control and
Data Processing


CAL | HC | refs | QC
QUALITY CONTROL
    HOME
HAWK-I QC
Trending & QC1
Pipeline
   product names
HAWKI ...
QC links:
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 HAWK-I pipeline product names start with "HI_".

Dynamic calibrations. The following types of dynamic calibration products of HAWK-I exist:

Code type of file PRO_CATG
MDRK master dark MASTER_DARK
 
MFLT master twilight flat MASTER_TWILIGHT_FLAT
PBPM bad pixel map MASTER_BPM
PCON confidence map MASTER_CONF
MFRG gain MASTER_READGAIN
 
PZIM calibrated, processed image BASIC_CALIBRATED_STD
PZSR catalogue of detected objects BASIC_CAT_STD
PZVM corresponding variance map BASIC_VAR_MAP
PZMP table of objects from the external catalogues that were used to calibrate the astrometry and photometry MATCHSTD_PHOTOM
PZSK mean sky image MEAN_SKY
PZSV corresponding sky variance map MEAN_SKY_VAR
 
PDBM bad pixel map BP_MAP_NL
PDLT linearity table DET_LIN_INFO
PDGT gain table GAIN_INFO
PDCC linearity coefficients cube COEFFS_CUBE

Static calibrations. These are the codes for the static calibrations:

Code type of file PRO_CATG
GSMN Schlegel_map_north SCHLEGEL_MAP_NORTH
GSMS Schlegel_map_north SCHLEGEL_MAP_SOUTH
GPHT phot map PHOTCAL_TAB
GCAS 2mass astrometric catalog MASTER_2MASS_CATALOGUE_ASTROM
GCAP 2mass photometric catalog MASTER_2MASS_CATALOGUE_PHOTOM
MFRG readgain MASTER_READGAIN

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 HAWK-I products have the following scheme:

<FILTER> or <DET_DIT>_<DET_NDIT> for DARKs;
where

  • FILTER is INS.FILT1.NAME or INS.FILT2.NAME keyword, the BB or NB filter used
  • DET_DIT is the dark integration time
  • DET_NDIT is the number of sub-integrations

Static calibration products either have some setup part, or contain some self-explanatory string like e.g. HI_GPHT_151001A_hawki_phot.fits for the photometric table.

Extension

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

NOTE: HAWK-I pipeline products are either a traditional FITS file (i.e. single Header-Data Units (HDUs), e.g. the Stitched product of the hawki_img_jitter recipe) or Multi-Extensin FITS files (MEFs) with a primary HDU containing a header only and then four extension HDUs (one for each chip of the mosaic). The order is normally, but not necessarily chips 1,2,4,3.

Examples

HI_MFLT_180608B_Ks.fits filter Ks twilight flat ; taken on date 2018-06-08 (second one).

HI_MDRK_180620A_300.0_1.fits: 300 s DIT, 1 NDIT master dark; taken on 2018-06-20 (first one on that date).


Send comments to <qc_hawki@eso.org> powered by QC [webCMS v1.0]