netcdf.putVar
Write data to netCDF variable
Syntax
netcdf.putVar(ncid,varid,data)
netcdf.putVar(ncid,varid,start,data)
netcdf.putVar(ncid,varid,start,count,data)
netcdf.putVar(ncid,varid,start,count,stride,data)
Description
netcdf.putVar(ncid,varid,data)
writes data
to a netCDF
variable identified by varid
.
Note
For variables of type NC_STRING
, data
can
contain UTF-8-encoded characters; for variables of type NC_CHAR
,
data
must contain only ASCII-encoded characters.
ncid
is an identifier of a netCDF file, such as returned by
netcdf.create
or netcdf.open
, or an identifier of a
netCDF group, such as returned by netcdf.defGrp
.
netcdf.putVar(ncid,varid,start,data)
writes
a single data value into the variable at the index specified by start
.
netcdf.putVar(ncid,varid,start,count,data)
writes
a section of values into the netCDF variable at the index specified
by the vector start
to the extent specified by
the vector count
, along each dimension of the specified
variable.
netcdf.putVar(ncid,varid,start,count,stride,data)
writes
the subsection specified by sampling interval, stride
,
of the values in the section of the variable beginning at the index start
and
to the extent specified by count
.
This function corresponds to several variable I/O functions in the netCDF library C API. To use this function, you should be familiar with the netCDF programming paradigm.
Examples
Tips
MATLAB® interprets multidimensional data as column-major, but the netCDF C API interprets multidimensional data as row-major. Multidimensional data in the netCDF C API shows dimensions in the reverse of the order shown by MATLAB and consequently appears transposed.
For variables of type
NC_VLEN
, ifdata
contains any entries that have more than one dimension, then thenetcdf.putVar
function flattens those entries in column-major order before writing the values. For example, for a variable of typeNC_VLEN
, specifyingdata
as{[0.5 0.3] 1.2; [0.4; 0.5] [0 -0.7 5.2; 4.6 2.5 1.8]}
and specifying
data
as{[0.5; 0.3] 1.2; [0.4; 0.5] [0; 4.6; -0.7; 2.5; 5.2; 1.8]}
have the same effect.