The CDF_VARPUT procedure writes a value to a variable in a Common Data Format file. This function provides equivalent functionality to the C routines CDFvarPut and CDFvarHyperPut.
Examples
id= CDF_CREATE('mycdf', [5,10], /NETWORK_ENCODING, /ROW_MAJOR)
varid= CDF_VARCREATE(id, 'V1', [1,1], /CDF_FLOAT, /REC_VARY)
To write the value 42.0 into record 12, third row, fourth column:
CDF_VARPUT, id, varid, 42, REC_START=12, OFFSET=[2,3]
Syntax
CDF_VARPUT, Id, Variable, Value [, COUNT=vector] [, INTERVAL=vector] [, OFFSET=vector] [, REC_INTERVAL=value] [, REC_START=record] [, /ZVARIABLE]
Arguments
Id
The CDF ID, returned from a previous call to CDF_OPEN or CDF_CREATE.
Variable
A string containing the name or number of the variable being written.
Value
The value to write. If the value has 1 more dimension than the CDF, multiple records will be written.
Keywords
COUNT
An optional vector containing the counts to be used in writing Value. Note that counts do not have to match the dimensions of Value. The default count is to use the dimensions of Value.
INTERVAL
A vector specifying the interval between values in each dimension. The default value is 1 in each dimension.
OFFSET
A vector specifying the array indices within the specified record(s) at which to begin writing. OFFSET is a 1-dimensional array containing one element per CDF dimension. The default value is zero in each dimension.
REC_INTERVAL
The interval between records being written when writing multiple records. The default value is 1.
REC_START
The record number at which to start writing. The default is 0.
ZVARIABLE
If Variable is a variable ID (as opposed to a variable name) and the variable is a zVariable, set this flag to indicate that the variable ID is a zVariable ID. The default is to assume that Variable is an rVariable ID.
Version History
See Also
CDF_VARCREATE, CDF_VARINQ, CDF_VARGET