netcdf.defVarDeflate
netCDF 変数の圧縮パラメーターを定義する
説明
例
NetCDF 変数の作成とその圧縮レベルの設定
この例では、次元が [1800 3600]
で圧縮レベルが 5
の変数を作成します。結果として、10
行 10
列のグリッドであるチャンク化されたレイアウトが作成されます。独自のチャンク化を定義する場合は、関数 netcdf.defVarChunking
を使用します。定義しなかった場合、netcdf.defVarDeflate
は既定のライブラリ値を使用します。
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.defVarDeflate(ncid,varid,true,true,5); netcdf.close(ncid);
入力引数
ncid
— ファイル識別子
非負の整数スカラー
netcdf.create
または netcdf.open
によって返される netCDF ファイルの識別子、または netcdf.defGrp
によって返される netCDF グループの識別子。非負の整数スカラーとして指定します。
データ型: double
varid
— NetCDF 変数の識別子
非負の整数スカラー
NetCDF 変数の識別子。非負の整数スカラーとして指定します。変数の識別子は、関数 netcdf.defVar
で返されます。
データ型: double
varid
— 変数の識別子
非負の整数スカラー
netcdf.defVar
で返される netCDF 変数の識別子。非負の整数スカラーとして指定します。
データ型: double
shuffle
— シャッフル フィルターのステータス
false
または 0
| true
または 1
シャッフル フィルターのステータス。数値として、あるいは logical 0
(false
) または 1
(true
) として指定します。値 false
はシャッフル フィルターを無効にし、true
は有効にします。シャッフル フィルターは、データ ストリームのバイト順を変更することにより、整数データの圧縮に役立ちます。varid
が NC_STRING
型または NC_VLEN
型の変数を参照している場合、shuffle
を true
に設定することはできません。
データ型: logical
deflate
— deflate フィルターのステータス
false
または 0
| true
または 1
deflate フィルターのステータス。数値または logical 0
(false
) または 1
(true
) として指定します。deflate
を true
として指定して圧縮を有効にしてから、deflateLevel
を目的の正の圧縮レベルとして指定します。圧縮を無効にする場合は、deflate
を false
として指定します。deflateLevel
が 0
として指定された場合、deflate
の値は自動的に false
に設定されます。
データ型: logical
deflateLevel
— 圧縮のレベル
0
~ 9
までの整数スカラー値
圧縮のレベル。0
~ 9
の整数スカラー値として指定します。値 0
は圧縮しないことを示し、deflate
の値を false
に指定することと等価です。値 1
は最小圧縮を示し、値 9
は最大圧縮を示します。deflate
が false
の場合、deflateLevel
の値は無視されます。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
制限
varid
がNC_STRING
型またはNC_VLEN
型の変数を参照している場合、deflate
をtrue
に設定してdeflateLevel
を正の値に設定することはできません。
ヒント
この関数は、netCDF ライブラリ C API の関数
nc_def_var_deflate
に相当します。
バージョン履歴
R2010b で導入R2023b: deflateLevel
を 0
に設定することによる deflate フィルターの無効化
圧縮レベルをゼロに設定すると、deflate フィルターが無効になります。以前は、圧縮レベルをゼロに設定することで deflate フィルターを有効にすることができました。
R2023b: 固定長のデータ型でのみの圧縮およびシャッフル フィルターの使用
圧縮およびシャッフル フィルターは固定長のデータ型でのみ使用でき、NC_STRING
型または NC_VLEN
型の変数に適用すると、エラーが生成されます。以前は、NC_STRING
または NC_VLEN
の変数に対して圧縮またはシャッフル フィルターを指定した場合、その指定に効果はありませんでした。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)