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_DOUBLE'double'
NC_FLOAT'single'
NC_INT64 (NetCDF-4 ファイルのみ)'int64'
NC_UINT64 (NetCDF-4 ファイルのみ)'uint64'
NC_INT'int32'
NC_UINT (NetCDF-4 ファイルのみ)'uint32'
NC_SHORT'int16'
NC_USHORT (NetCDF-4 ファイルのみ)'uint16'
NC_BYTE'int8'
NC_UBYTE (NetCDF-4 ファイルのみ)'uint8'
NC_CHAR'char'
NC_STRING (NetCDF-4 ファイルのみ)'string'

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

関連するトピック

外部の Web サイト