copyvar - Copies variables between TeraScan datasets

SYNOPSIS

copyvar  [ parameter=value ... ]  [ inputfile outputfile ]

Parameters are: include_vars overwrite_vars.

DESCRIPTION

This function allows you to copy variables from one existing dataset to another. Dimensions are defined as needed in the output to accommodate the variables. If an input variable dimension already exists in the output, it must have the exact same size.

Variables are not overwritten unless specified by the user. An input variable can overwrite an output variable if it has the same datatype and dimensions.

Variable attributes are copied along with the variable data.

PARAMETERS

include_vars

The variables to include in the file. If the list is preceded by a hyphen, followed by a space, then the variables in the list are excluded from the file, and all other variables in the input files are included.

Valid responses are any variable names in the input files, properly delimited (space or comma). The default is to include all variables.

overwrite_vars

Whether to overwrite existing variables in the output file, if names conflict.

Valid responses are [yes or no]. The default is no.

EXAMPLES

Make a constant dataset named blank.out and copy the AVHRR channel 4 data from n11.reg to blank.out.

[5]% const2d
output file    : char(75) ? blank.out
master_file    : char(16) ? [] Master
var_type       : char( 6) ? byte
var_value      : real     ? [0] 1

[6]% copyvar
in/out files   : char(75) ? n11.reg blank.out
include_vars   : char(75) ? avhrr_ch4

SEE ALSO

assemble, datasets


Last Update: $Date: 1998/05/28 18:20:11 $