dmaptocdl

Syntax

dmaptocdl --help
dmaptocdl [-vb] datamap cdl map

Synopsis

Scans a DataMap file to produce a Commond Data Form Language (CDL) 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.
`cdl`	filename of the CDL file to generate.
`map`	filename of mapping that relates variables in the DataMap file to those in the CDL file.

Description

Scans a DataMap file to produce a Commond Data Form Language (CDL) file.

The netCDF format has no concept of a "record". A netCDF dataset is just a collection of arrays of fixed length, named, dimensions. One dimension can be defined as "unlimited". The unlimited dimension does not have a fixed length and it's index can effectively be thought of as the record number.

In translating DataMap files, each record in the file is mapped to an index of the unlimited dimension;scalars become 1 dimensional arrays, and arrays gain one extra dimension.

NetCDF has a simple text based scripting language called CDL (Common Data form Language) that can be used to describe the layout of a dataset. The utility ncgen can convert a CDL file to an empty dataset ready to store data.

The tool dmaptocdl first analyses a dmap file to determine the size of the arrays required and produces an outline CDL file. The user can edit this CDL file to correct any problems and add any meta-data (attributes).

Examples

dmaptocdl 20021219.kap.fitacf fitacf.cdl fitmacf.cdfmap

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