ncwrite

NetCDF ファイルにデータを書き込む

ページ内をすべて折りたたむ

構文

ncwrite(filename,varname,vardata)

ncwrite(filename,varname,vardata,start)

ncwrite(filename,varname,vardata,start,stride)

説明

例

ncwrite(filename,varname,vardata) は、vardata のテキストまたは数値データを、NetCDF ファイル filename の既存の変数 varname に書き込みます。

関数 ncwrite は、vardata のデータをこの変数の先頭から書き込み、必要があれば制限のない次元を自動的に拡張します。制限のない次元の詳細については、関数 nccreate の Dimensions 引数を参照してください。

例

ncwrite(filename,varname,vardata,start) は、start で指定した位置から、データを既存の変数に書き込みます。既存の変数にデータを付加する、あるいは部分データを書き込む場合は、この構文を使用します。

例

ncwrite(filename,varname,vardata,start,stride) は、stride で指定した各次元のインデックス間の間隔でデータを書き込みます。

例

すべて折りたたむ

変数を NetCDF ファイルに書き込む

ライブスクリプトを開く

変数が格納された NetCDF ファイルを作成し、その変数にデータを書き込みます。

pi という変数が格納された myfile.nc という新しいファイルを作成します。

nccreate('myfile.nc','pi');

次元をもたないスカラーデータを変数 pi に書き込みます。

ncwrite('myfile.nc','pi',3.1416);

ファイルから変数を読み取って表示します。

valPi = ncread('myfile.nc','pi')

valPi = 3.1416

データを変数の一部に書き込む

ライブスクリプトを開く

NetCDF ファイルの変数の、指定した位置から始まる部分にデータを書き込みます。

3 行 6 列の空の数値変数 vmark をもつファイル myncfile.nc を作成します。欠落した変数や空の変数に対する既定の埋め込み値を無効にするには、FillValue の名前と値のペアの引数の値を disable に設定します。

nccreate('myncfile.nc','vmark',...
         'Dimensions', {'x',3,'y',6},...
         'FillValue','disable');

3 行 3 列の配列を変数に書き込み、vmark をファイルから読み取って表示します。関数 ncwrite は、変数の先頭からデータを書き込みます。

ncwrite('myncfile.nc','vmark',3*eye(3));
varData = ncread('myncfile.nc','vmark');
display(varData)

varData = 3×6

     3     0     0     0     0     0
     0     3     0     0     0     0
     0     0     3     0     0     0

3 行 3 列の別の配列を、変数 vmark の 1 行目の 4 列目から始まる部分に追加します。次に、vmark をファイルから読み取って表示します。関数 ncwrite は、この配列を [1 4] の位置から書き込みます。

ncwrite('myncfile.nc','vmark',5*eye(3),[1 4]);
varData = ncread('myncfile.nc','vmark');
display(varData)

varData = 3×6

     3     0     0     5     0     0
     0     3     0     0     5     0
     0     0     3     0     0     5

指定した間隔でのデータの書き込み

ライブスクリプトを開く

各次元に沿って、指定された変数インデックス間の間隔でデータを書き込みます。

最初に、6 行 6 列の空の数値変数 vmark をもつファイル myncfile.nc を作成します。欠落した変数や空の変数に対する既定の埋め込み値を無効にするには、FillValue の名前と値のペアの引数の値を disable に設定します。

nccreate('myncfile.nc','vmark',...
         'Dimensions', {'x',6,'y',6},...
         'FillValue','disable');

次に、3 行 3 列の数値配列を、変数 vmark の位置 [1 1] から、各次元に沿って変数インデックス間の間隔 2 で書き込みます。vmark をファイルから読み取って表示します。

ncwrite('myncfile.nc','vmark',3*eye(3),[1 1],[2 2]);
varData = ncread('myncfile.nc','vmark');
display(varData)

varData = 6×6

     3     0     0     0     0     0
     0     0     0     0     0     0
     0     0     3     0     0     0
     0     0     0     0     0     0
     0     0     0     0     3     0
     0     0     0     0     0     0

入力引数

すべて折りたたむ

`filename` — ファイル名
文字ベクトル | string スカラー

既存の NetCDF ファイルの名前。文字ベクトルまたは string スカラーとして指定します。

NetCDF ファイルまたは変数が存在しない場合、まず関数 nccreate を使用してそれらを作成します。

データ型: char | string

`varname` — 変数名
文字ベクトル | string スカラー

変数名。NetCDF ファイルの変数名を含む文字ベクトルまたは string として指定します。

データ型: char | string

`vardata` — 変数データ
数値 | テキスト

変数データ。数値データまたはテキストとして指定します。

メモ

NC_CHAR 型の変数について、vardata は ASCII エンコード文字のみを含む必要があります。NetCDF-4 ファイルは、NC_STRING 型の変数で UTF-8 エンコード文字の書き込みをサポートしています。

変数 varname が存在する場合、ncwrite では vardata のデータ型が NetCDF 変数のデータ型と一致する必要があります。

変数 varname が _FillValue、scale_factor または add_offset のいずれかの属性をもつ場合、関数 ncwrite ではデータがデータ型 double であることが必要です。vardata を NetCDF データ型にキャストするため、関数 ncwrite は次の属性の規則を順番に適用します。

vardata から add_offset 属性の値を減算します。
vardata をscale_factor 属性の値で除算します。
vardata にあるすべての NaN を、_FillValue 属性に格納されている値に置き換えます。この属性が存在しない場合、ncwrite は、NetCDF ライブラリで指定されたとおりに、この変数の埋め込み値を使用します。

`start` — 開始位置
1 のベクトル (既定値) | 数値ベクトル

変数内のデータの開始位置。インデックスのベクトルとして指定します。N 次元の変数について、start は 1 ベースのインデックスを含む、長さ N のベクトルです。

start を指定しない場合、関数 ncwrite は各次元に沿って、最初のインデックスから変数の書き込みを開始します。

データ型: double

`stride` — 変数インデックス間の間隔
1 のベクトル (既定値) | 数値ベクトル

各次元に沿った変数インデックス間の間隔。整数の数値ベクトルとして指定します。N 次元の変数について、stride は長さ N のベクトルです。ベクトル stride の要素は、変数の次元に、同じ順序で対応しています。値が 1 の場合、対応する次元内の NetCDF 変数の隣接する値を書き込みます。一方、値が 2 の場合、対応する次元内の NetCDF 変数の値に 1 つおきにアクセスし、以降同様に繰り返されます。

stride を指定しない場合、関数 ncwrite は各次元に沿って既定の間隔 1 でデータを書き込みます。

データ型: double