Common DFOS tools:
Documentation

make printable	New:	See also:
	v1.4 extracts ANCILLARY fits files	The tool is distributed through the utilities package (utilPack). It is used by updateDP. databases none dfos tools called by updateDP output structured text file upload/download none

extractAB

The tool extractAB extracts all associated raw files from an AB and its cascaded ABs. This information is needed for packing.

The tool is called by updateDP. Call from the command line is possible.

The tool scans the specified AB, and finds all contained files. It is used for packing.

The scanning for raw data can be done in two levels:
- Level 1: all ABs behind qualifiers MCALIB and MASSOC are scanned for their raw files
- Level 2: as level 1, plus all ABs called in the level1 ABs are scanned
All other files (PRODUCTS, MCALIB, MASSOC etc.) are extracted from the specified AB.

With v1.4, the tool also finds the names of ancillary fits files (${MCAL_CODE}_LOGS|PLTS ) and writes their name into the output.

The output is dumped to the command line (or recorded in a text file if called by updateDP). For each retrieved file, the tool lists:

- path and file name
- the AB name
- OBS_ID, OBS_PROG_ID
- DO_CATG or PRO_CATG
- QUALIFIER
- DPR_TYPE
- PACK_TYPE

The tool expects the AB under the operational directory $DFO_LOG_DIR/<date> where <date> needs to be specified.

How to use

Type

extractAB -h | -v

for on-line help and version;

extractAB -a <ab_name> -d 2004-12-30 -c <casc-level>

to extract information from the specified AB. The specified date is translated into $DFO_LOG_DIR/$DATE where the AB is expected. Specification of the date is done for performance reasons. The cascade level is 1 by default, but can be set to 2.

Installation

The tool is part of the utilPack package.

Configuration file

The tool has no configuration file.