Main Content

ncwriteatt

NetCDF ファイルへの属性の書き込み

構文

ncwriteatt(filename,location,attname,attvalue)
ncwriteatt(filename,location,attname,attvalue,'Datatype',dtype)

説明

ncwriteatt(filename,location,attname,attvalue) は、filename で指定された NetCDF ファイルの location で指定されたグループまたは変数の attname で指定された属性を作成するか、修正します。attvalue は文字ベクトル、string スカラー、string 配列、数値ベクトルのいずれでも構いません。

ncwriteatt(filename,location,attname,attvalue,'Datatype',dtype) は、attvaluedtype に指定されたデータ型として書き込みます。たとえば、'Datatype' の値を 'string' として指定して、attvalue のデータを string データとして書き込みます。

入力引数

filename

NetCDF ファイル名を指定する文字ベクトルまたは string スカラー

location

NetCDF ファイル内のグループまたは変数を指定する文字ベクトルまたは string スカラー。グローバル属性を書き込むには、location'/' (スラッシュ) に設定します。

attname

NetCDF ファイル内の既存の属性名、または作成する属性名を指定する文字ベクトルまたは string スカラー。

attvalue

文字ベクトル、string スカラー、string 配列、または数値ベクトル。

Datatype

属性値 attvalue の書き込みに使用するデータ型を指定する文字ベクトルまたは string スカラー。'Datatype' は、'double''single''int64''uint64''int32''uint32''int16''uint16''int8''uint8''char''string' の値のいずれかとして指定します。

すべて折りたたむ

グローバル属性を NetCDF ファイルに作成します。

copyfile(which('example.nc'),'myfile.nc');
fileattrib('myfile.nc','+w');
ncdisp('myfile.nc');
ncwriteatt('myfile.nc','/','creation_date',datestr(now));
ncdisp('myfile.nc');

NetCDF ファイルにある既存の属性を修正します。

copyfile(which('example.nc'),'myfile.nc');
fileattrib('myfile.nc','+w');
ncdisp('myfile.nc','peaks');
ncwriteatt('myfile.nc','peaks','description','Output of PEAKS');
ncdisp('myfile.nc','peaks');

string 配列を NetCDF-4 ファイルのデータセット属性に書き込みます。次に、属性の値を表示します。

NetCDF-4 ファイルおよび Temperature という名前の変数を作成します。次に、string 配列 ["°​F","°​C"]Units という名前の属性値として書き込みます。配列には非 ASCII string データが含まれます。

nccreate("myfile.nc", "Temperature", "Format", "netcdf4");
ncwriteatt("myfile.nc", "Temperature", "Units", ["°​F","°​C"])

変数 Temperature の内容を表示します。

ncdisp("myfile.nc","Temperature")

データを NetCDF-4 ファイルの属性に string データとして書き込みます。

NetCDF-4 ファイルおよび Temperature という名前の変数を作成します。次に、"Datatype" の値を "string" として指定することにより、文字ベクトル 'July'NC_STRING 型として Months という名前の属性に書き込みます。既定では、ncwriteatt は、スカラー テキスト データを NC_CHAR 型として書き込みます。

変数を作成します。

nccreate("myfile.nc", "Calendar", "Format", "netcdf4");
ncwriteatt("myfile.nc", "Calendar", "Months", 'July', "Datatype", "string"

属性 Months の値を読み取ります。

ncreadatt("myfile.nc","Calendar","Months")

制限

  • NetCDF-4 ファイルのみを使用して、NC_STRING 型の属性を作成できます。

バージョン履歴

R2011a で導入