Common DFOS tools:
Documentation
dfos = Data Flow Operations System, the common tool set for DFO
*make printable new: See also :
 

version 1.0

- the tool is distributed through the utilities package (utilPack)
- related tools for FITS header manipulation:

  • replacekey

modhead

Description

While modifying an existing key in a FITS file header is usually done with the standard DFS tool replacekey, adding a missing key requires a different tool: modhead ("modify header").

This functionality is not required in routine DFO operations, but may become important to prepare for ingestion of new types of products, for example general calibration products. In these cases, certain standard FITS keys required for successful ingestion may be missing, and modhead is the tool to add them. modhead works on FITS files only.

How to use

Run the tool on the command line, or in a batch.

Type

modhead AMBER.2007-11-21T20:34:21.626.fits "INSTRUME" "'AMBER'"

to add a primary key;

modhead GIRAF.2027-11-21T20:34:21.626.fits "HIERARCH ESO PRO SCIENCE" "F"

to add a hierarchical key of type boolean,

modhead CRIRE.2020-11-21T20:34:21.626.fits "HIERARCH ESO PRO TECH " "'GENERAL'"

to add a hierarchical key of type string.

Required keys for product ingestion

The ingestion of product files is the only use case for the necessity to add FITS keys. Here is a list of FITS keys which are required by cdbIngest for proper registration of the ingested product in the database:

keyword name value comment
INSTRUME e.g. AMBER  
MJD-OBS e.g. 54732.5 used by renameProducts to gerenate the product name, and required for versioning; in dynamic products inherited from first raw file; in static calibrations corresponding e.g. to the date of creation
HIERARCH ESO PRO CATG LINE_TABLE unique description of product type, required for proper association
HIERARCH ESO PRO SCIENCE F boolean, always F except for science products
HIERARCH ESO PRO TECH GENERAL for dynamic calibrations, this key is inherited from DPR.TECH; in dynamic products, it should be filled with proper values, if possible (e.g. a standard star table would receive the tag "IMAGE"), otherwise with "GENERAL".

Installation

The tool comes as part of the utilPack delivery.

Configuration file

none.

Last update: April 26, 2021 by rhanusch