Main Content

netcdf.defVarFill

定义 NetCDF 变量的填充参数

语法

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

说明

netcdf.defVarFill(ncid,varid,noFillMode,fillValue) 为 NetCDF-4 文件中的变量设置填充参数。varid 标识变量,ncid 标识 NetCDF-4 文件。

对于 netCDF 文件,您只能在 NetCDF 处于定义模式(在调用 netcdf.endDef 之前)时指定填充值。对于处于 64 位编译模式的 NetCDF 文件,您可以随时打开或关闭无填充模式。

输入参数

ncid

netcdf.createnetcdf.open 返回的 NetCDF-4 文件的标识符,或者由 netcdf.defGrp 返回的 NetCDF 组的标识符。

varid

netcdf.defVar 返回的 NetCDF 变量标识符。

noFillMode

布尔值。设置为 true 后,关闭变量填充值使用,这在高性能应用程序中非常有用。在该值为 true 时,netcdf.defVarFill 会忽略 fillValue 参数的值。要设置填充值,请将它设置为 false

fillValue

在变量未赋值的情况下,可使用该值为变量指定填充值。其数据类型必须与变量的数据类型一致。

示例

本例创建一个 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);

局限性

  • NC_STRING 类型的数据写入 NetCDF-4 文件时,无法将 noFillMode 指定为 true

参考

此函数对应于 netCDF 库 C API 中的 nc_def_var_fill 函数。