Main Content

netcdf.defVarChunking

netCDF 変数のチャンク動作を定義する

説明

netcdf.defVarChunking(ncid,varid,storage,chunkSizes) は、varid によって指定された変数のチャンク設定を実行します。チャンク化はパフォーマンスを向上させる手法です。storage は使用するチャンク化の型を指定し、chunkSizes はチャンク サイズの範囲を指定します。変数を作成した後、変数にデータを書き込む前に、変数と共に使用するチャンク サイズを指定しなければなりません。

netCDF-3 モードで作成された netCDF ファイルの変数には、チャンクのサイズを指定できません (CLASSIC_MODEL)。

すべて折りたたむ

ncid = netcdf.create("myfile.nc","NETCDF4");
latdimid = netcdf.defDim(ncid,"lat",1800);
londimid = netcdf.defDim(ncid,"col",3600);
varid = netcdf.defVar(ncid,"earthgrid","double",[latdimid londimid]);
netcdf.defVarChunking(ncid,varid,"CHUNKED",[180 360]);
netcdf.close(ncid);

入力引数

すべて折りたたむ

netcdf.create または netcdf.open によって返される netCDF ファイルの識別子、または netcdf.defGrp によって返される netCDF グループの識別子。非負の整数スカラーとして指定します。

データ型: double

netcdf.defVar で返される netCDF 変数の識別子。非負の整数スカラーとして指定します。

データ型: double

netCDF 変数のストレージ型。文字ベクトルまたは string スカラーとして指定します。"CHUNKED" に設定されている場合、netCDF はファイルに書き込む際に変数をチャンクに分割します。"CONTIGUOUS" に設定されている場合、netCDF はデータをチャンクに分割しません。

データ型: char | string

チャンクの次元。正の整数配列として指定します。chunkSizes の次元の並びは、C API の並びと逆になります。これは、MATLAB® では FORTRAN スタイルの並びを使用するからです。

storage が "CONTIGUOUS" の場合は、chunkSizes を省略できます。

メモ

チャンク サイズは、netCDF ライブラリによって決定されます。

データ型: double

ヒント

  • この関数は、netCDF ライブラリ C API の関数 nc_def_var_chunking に相当します。

バージョン履歴

R2010b で導入