Main Content

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

NetCDF API 構文の MATLAB 構文へのマッピング

MATLAB® の低水準関数パッケージ netcdf と NetCDF C ライブラリのこれに相当するもの。

MATLAB では、netcdf という名前のパッケージにグループ化されている一連の低水準関数を使用して NetCDF C ライブラリ内のルーチンにアクセスできます。このパッケージの関数を使用して NetCDF ファイルに対し、データの読み取りと書き込みを行います。MATLAB NetCDF 関数を効果的に使用するには、NetCDF インターフェイスに関する知識が必要です。

通常、netcdf パッケージ内の MATLAB 関数は、NetCDF C ライブラリ内のルーチンにちょうど対応しています。たとえば、MATLAB の関数 netcdf.open は NetCDF ライブラリのルーチン nc_open に相当します。場合によっては、1 つの MATLAB 関数が NetCDF ライブラリ関数の 1 つのグループに対応することもあります。たとえば、NetCDF ライブラリの nc_put_att_type 関数 (type はデータ型を表す) すべてに MATLAB の対応バージョンを作成する代わりに、MATLAB では 1 つの関数 netcdf.putAtt を使用してサポートされるすべてのデータ型を扱います。

netcdf パッケージ内のいずれかの関数を呼び出すには、関数名の前にパッケージ名を指定しなければなりません。MATLAB 関数の構文は NetCDF ライブラリのルーチンと同様です。ただし、NetCDF C ライブラリのルーチンでは入力パラメーターを使用してデータを返しますが、対応する MATLAB の関数では 1 つ以上の戻り値を使用します。たとえば、次は NetCDF ライブラリ内の nc_open ルーチンの関数シグネチャです。

int nc_open (const char *path, int omode, int *ncidp); /* C syntax */

NetCDF のファイル識別子は ncidp 引数で返されます。

これは、対応する MATLAB 関数 netcdf.open のシグネチャです。

ncid = netcdf.open(filename, mode)

NetCDF C ライブラリ側のものと同様、MATLAB の NetCDF 関数は、ファイル名とアクセス モードを指定する定数とを受け入れます。ただし、MATLAB の関数 netcdf.open では、ファイル識別子 ncid が戻り値として返されます。

MATLAB NetCDF 関数では、NetCDF のデータ型に最も一致する MATLAB クラスが自動的に選択されます。以下の表は既定のマッピングです。

NetCDF データ型MATLAB クラス
'NC_BYTE'int8 または uint8[a]
'NC_CHAR'char
'NC_SHORT'int16
'NC_INT'int32
'NC_FLOAT'single
'NC_DOUBLE'double

[a] NetCDF interprets byte data as either signed or unsigned.

関数 netcdf.getVar のオプションの引数を使用して既定値をオーバーライドし、返されたデータのクラスを指定できます。

関連するトピック

外部の Web サイト