dmaptoskeleton

Syntax

dmaptoskeleton --help
dmaptoskeleton [-vb] datamap skeleton map

Synopsis

Scans a DataMap file to produce a Skeleton table that can be used to create 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 scan.
`skeleton`	filename of the skeleton table to generate.
`map`	filename of mapping that relates variables in the DataMap file to those in the skeleton table.

Description

Scans a DataMap file to produce a Skeleton table that can be used to create 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.

Examples

dmaptoskeleton 20021219.kap.fitacf fitacf.skeleton fitmacf.cdfmap

Generate the skeleton table "fitacf.skeleton" and mapping table "fitacf.cdfmap" from the file "20021219.kap.fitacf".