netcdf.defVarFill

定义 netCDF 变量的填充参数

全页折叠

语法

netcdf.defVarFill(ncid,varid,noFillMode,fillValue)

说明

示例

netcdf.defVarFill(ncid,varid,noFillMode,fillValue) 为 netCDF 文件或组中的变量设置填充参数。varid 标识变量，而 ncid 标识 netCDF 文件或组。

对于 netCDF-4 文件，您只能在 netCDF 处于定义模式时指定填充值。对于处于经典和 64 位偏移量模式的 netCDF 文件，您可以随时打开或关闭无填充模式。

示例

全部折叠

创建和定义 NetCDF 变量的填充值

本例创建一个 netCDF-4 文件并定义变量的填充值。

ncid = netcdf.create("myfile.nc","NETCDF4");
dimid = netcdf.defDim(ncid,"latitude",180);
varid = netcdf.defVar(ncid,"latitude","double",dimid);
netcdf.defVarFill(ncid,varid,false,-999);
netcdf.close(ncid);

输入参数

全部折叠

`ncid` — 文件标识符
非负整数标量

由 netcdf.create 或 netcdf.open 返回的 netCDF 文件标识符，或者由 netcdf.defGrp 返回的 netCDF 组标识符，指定为非负整数标量。

数据类型: double

`varid` — 变量标识符
非负整数标量

netCDF 变量的标识符，由 netcdf.defVar 返回，指定为非负整数标量。

数据类型: double

`noFillMode` — netCDF 变量的填充值模式
`false` | `true`

netCDF 变量的填充值模式，设置为 true 或 false。当设置为 true 时，netcdf.defVarFill 关闭变量填充值的使用，这在高性能应用程序中很有帮助。当设置为 true 时，netcdf.defVarFill 将忽略 fillValue 参量的值。要使用填充值，请将该值设置为 false。

注意

将 NC_STRING 类型的数据写入 netCDF-4 文件时，不能将 noFillMode 指定为 true。

数据类型: logical