dmaptocdf

Syntax

dmaptocdf --help
dmaptocdf [-vb] datamap map cdf

Synopsis

Convert a DataMap file into a Common Data Format (CDF) file.

Options

`--help`	print the help message and exit.
`--version`	print the RST version number and exit.
`-vb`	verbose. Log information to the console.
`datamap`	filename of the DataMap file to convert.
`map`	filename of the mapping file that relates variables in the DataMap file to those in the CDF file.
`cdf`	filename of an empty CDF file to populate.

Description

Convert a DataMap file into a Common Data Format (CDF) file.

A CDF file is divided up into rVariables and zVariables. All rVariables share the same dimensionality. zVariables can have different dimensionality from each other. A CDF file can contain multiple records but each record must have the same rVariables and zVariables.

In translating DataMap files, scalars are stored in rVariables and arrays are stored in zVariables.

An CDF file can be created from a specially formatted text file called a skeleton table. The utility skeletoncdf produces the empty CDF file from the skeleton table.

The tool dmaptoskeleton first analyses a DataMap file to determine the variables requires and produces an outline skeleton table and a mapping table that translates the variable names in the DataMap file to the CDF equivalents. The user can edit this file to correct any problems and add any meta-data required. The user then creates an empty CDF file using skeletoncdf. The final step is to populate the CDF file using dmaptocdf.

Examples

dmaptocdf 20021219.kap.fitacf fitacf.cdfmap 20021219.kap.cdf

Populate the empty CDF file "20021219.kap.cdf" with data from the file "20021219.kap.fitacf" using the mapping table "fitacf.cdfmap".