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

    データ型: double

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

    データ型: double

    netCDF 変数の埋め込み値モード。true または false に設定します。true に設定されている場合、netcdf.defVarFill は変数の埋め込み値の使用をオフにします。これは、高性能のアプリケーションに役立ちます。true に設定されている場合、netcdf.defVarFill は、引数 fillValue の値を無視します。埋め込み値を使用するには、この値を false に設定します。

    メモ

    NC_STRING 型のデータを netCDF-4 ファイルに書き込む場合、noFillModetrue として指定してはなりません。

    データ型: logical

    netCDF 変数で使用する埋め込み値。スカラーとして指定します。

    メモ

    fillValue のデータ型は、netCDF 変数のデータ型と同じでなければなりません。

    データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    ヒント

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

    バージョン履歴

    R2010b で導入