netcdf.create

创建新的 netCDF 数据集

语法

ncid = netcdf.create(filename,cmode)
[chunksize_out,ncid] = netcdf.create(filename,cmode,initsz,chunksize)


说明

ncid = netcdf.create(filename,cmode) 根据文件创建模式创建新的 netCDF 文件。返回值 ncid 是一个文件 ID。cmode 参数确定文件访问的类型。可将 cmode 指定为以下值之一。

cmode 的值	描述
'NOCLOBBER'	防止覆盖现有的同名文件。
'CLOBBER'	覆盖现有的同名文件。
'SHARE'	支持文件同步更新。
'64BIT_OFFSET'	支持轻松创建大于 2GB 的文件和变量。
'NETCDF4'	创建 netCDF-4/HDF5 文件
'CLASSIC_MODEL'	强制使用标准模式；除非采用逐位模式或配合 NETCDF4，否则没有效果

注意

可以将 mode 指定为一个数值，该数值可用 netcdf.getConstant 函数检索到。要指定多个 mode，可对 mode 数值执行按位或操作。

[chunksize_out,ncid] = netcdf.create(filename,cmode,initsz,chunksize) 用附加的性能调节参数创建新的 netCDF 文件。initsz 设置该文件初始大小。chunksize 会影响 I/O 性能。netCDF 库选择的实际值可能与输入值不对应。

此函数对应于 netCDF 库 C API 中的 nc_create 和 nc__create 函数。要使用此函数，应该熟悉 netCDF 编程范式。

示例

创建 NetCDF 文件而不覆盖现有文件

创建一个名为 foo.nc 的 netCDF 数据集，其前提是当前目录下没有同名文件。要运行本例，必须对当前目录拥有写入权限。

ncid = netcdf.create('foo.nc','NOCLOBBER')

ncid = 65536

netcdf.create 返回文件标识符。

关闭文件

netcdf.close(ncid)

使用典型模型创建 NetCDF-4 文件

获取对应于 netCDF 库定义的 NETCDF4 和 CLASSIC_MODEL 常量的数值。要指定多个创建模式，可对这些数值执行按位或操作。

cmode = netcdf.getConstant('NETCDF4');
cmode = bitor(cmode,netcdf.getConstant('CLASSIC_MODEL'));

通过指定创建模式值 cmode 创建一个使用经典模型的 netCDF-4 文件。

ncid = netcdf.create('myfile.nc',cmode);

关闭文件。

netcdf.close(ncid);

使用特定于 NetCDF-4 的数据类型创建 NetCDF 文件

创建一个 netCDF 文件，其中包含 NC_UINT 类型的变量，这是 netCDF-4 中引入的数据类型之一。

首先，创建一个 netCDF 文件 foo.nc。由于数据类型 NC_UINT 仅在 netCDF-4 中可用，请将 "NETCDF4" 指定为文件创建模式。

ncid = netcdf.create("foo.nc","NETCDF4");

在 foo.nc 中创建类型为 NC_UINT 的标量变量 observation。

observation_id = netcdf.defVar(ncid,"observation","NC_UINT",[]);

将值 1 写入 observation 中。

netcdf.putVar(ncid,observation_id,1)

读取 observation 的值以确认预期行为。

observation_value = netcdf.getVar(ncid,observation_id)

observation_value = uint32
    1

关闭文件。

netcdf.close(ncid)

版本历史记录

在 R2008b 中推出

另请参阅

netcdf.getConstant | netcdf.open