editdim - Edits the built-in attributes of dimensions

SYNOPSIS

editvar  [ parameter=value ... ]  [ inputfile ... ]

Parameters are: dimnamenewname,   varnamescaleoffsetcoord.

DESCRIPTION

The function editdim lets you change the built-in attributes of dimensions in TeraScan datasets (datasets). These attributes include the name, coord, variable, scale and offset values.

PARAMETERS

dimname

The name of the dimension to edit.

There is no default.

newname

New name for the dimension.

The default is the same as the current value.

varname

This specifies that the dimension's values are to be obtained from the dataset variable varname (see datasets, e.g. dim->var).

The default is the same as the current value.

scale

If varname is not specified, then this specifies a new scale factor for the dimension. If this parameter is specified and the dimension has a previously defined dim->var, then dim->var is set to NULL (see datasets, e.g. dim->var).

The default is the same as the current value.

offset

If varname is not specified, then this specifies a new offset value for the dimension. If this parameter is specified and the dimension has a previously defined dim->var, then dim->var is set to NULL (see datasets, e.g. dim->var).

The default is the same as the current value.

coord

New coordinate value. See include/gp.h for pre-defined coordinates. Valid responses are [ x, y, z, t, c, X, Y, Z, T, C, 0, 1, 2, 3, 4, 5 ]. Lower case letters mean the same as upper case letters. T stands for time. C stands for complex. 0 stands for no coordinate. Numeric equivalence is defined in include/gp.h.

The default is the same as the current value.

EXAMPLES

% editdim myfile
dimname        : char( 31) ? line
newname        : char( 31) ? [<same>] latitude
varname        : char( 31) ? [<same>]
scale          : char( 31) ? [<same>] 10.0
offset         : char( 31) ? [<same>] -90.0
coord          : char( 31) ? [<same>]

FILES

include/gp.h

SEE ALSO

editvar, varinfo, getinfo, setattr, datasets


Last Update: $Date: 2002/01/31 23:08:20 $