Main Content

netcdf.defVarFill

定义 netCDF 变量的填充参数

    说明

    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.createnetcdf.open 返回的 netCDF 文件标识符,或者由 netcdf.defGrp 返回的 netCDF 组标识符,指定为非负整数标量。

    数据类型: double

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

    数据类型: double

    netCDF 变量的填充值模式,设置为 truefalse。当设置为 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 中推出