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-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);

    输入参数

    全部折叠

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

    数据类型: double

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

    数据类型: double

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

    注意

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

    数据类型: logical

    netCDF 变量中使用的填充值，指定为标量。

    注意

    fillValue 的数据类型必须与 netCDF 变量的数据类型相同。

    数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    提示

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

    版本历史记录

    在 R2010b 中推出

    另请参阅

    | | | |