ncreadatt
netCDF データ ソースから属性を読み取る
説明
は、attvalue
= ncreadatt(source
,location
,attname
)source
内の location
で指定されたグループまたは変数から netCDF 属性 attname
を読み取ります。返される属性の値は、attname
の NetCDF データ型に最良に適合する MATLAB® データ型の値です。MATLAB による最良の適合の判別方法の詳細については、NetCDF から MATLAB データ型への変換を参照してください。
例
グローバル属性の読み取り
netCDF ファイル example.nc
のグローバル属性 creation_date
を読み取ります。
creationDate = ncreadatt("example.nc","/","creation_date")
creationDate = '29-Mar-2010'
変数属性の読み取り
temperature
変数に関連付けられている scale_factor
属性を読み取ります。
scaleFactor = ncreadatt("example.nc","temperature","scale_factor")
scaleFactor = 1.8000
グループ属性の読み取り
/grid2
グループに関連付けられている description
属性を読み取ります。グループ属性は netcdf4
形式のファイルからのみ読み取ることができます。
groupDescription = ncreadatt("example.nc","/grid2","description")
groupDescription = 'This is another group attribute.'
入力引数
source
— netCDF データ ソースの名前
string スカラー | 文字ベクトル
netCDF データ ソースの名前。string スカラーまたは文字ベクトルとして指定します。引数 source
には、次の値のいずれかを指定できます。
ローカルの netCDF ソースのパス
リモートの OPeNDAP netCDF データ ソースの OPeNDAP URL
リモートの netCDF ソースの HTTP URL。その URL の末尾に
#mode=bytes
を付け加えてバイト範囲読み取りを有効にするメモ
バイト範囲読み取りは、他のソースからの読み取りよりも遅くなります。バイト範囲読み取りの詳細については、netCDF のドキュメンテーションを参照してください。
例: "myNetCDFfile.nc"
例: "http://
host_name
/netcdf_filename
#mode=bytes"
location
— 変数またはグループの場所
string スカラー | 文字ベクトル
netCDF データ ソース内の変数またはグループの場所。string スカラーまたは文字ベクトルとして指定します。グローバル属性を読み取るには、location
を "/"
(スラッシュ) に設定します。
例: "myVar"
例: "/myGrp/mySubGrp/myNestedVar"
例: "myGrp"
例: "/myGrp/mySubGrp"
attname
— 属性名
string スカラー | 文字ベクトル
読み取る属性の名前。string スカラーまたは文字ベクトルとして指定します。
例: "myAttribute"
詳細
NetCDF から MATLAB データ型への変換
netCDF 関連の MATLAB 関数は、次の表に従って、netCDF データ型に最良に適合する MATLAB データ型を自動的に選択します。
NetCDF データ型 | MATLAB データ型 |
---|---|
NC_DOUBLE | double |
NC_FLOAT | single |
NC_INT | int32 |
NC_SHORT | int16 |
NC_BYTE | int8 |
NC_CHAR | char |
NC_STRING (*) | string |
NC_INT64 (*) | int64 |
NC_UINT64 (*) | uint64 |
NC_UINT (*) | uint32 |
NC_USHORT (*) | uint16 |
NC_UBYTE (*) | uint8 |
ユーザー定義の NC_VLEN 型 (*) | cell |
(*) これらの netCDF データ型は netcdf4
形式のファイルでのみ使用可能です。
バージョン履歴
R2011a で導入R2022a: リモート データセットのバイト範囲読み取り
リモート サーバーがバイト範囲アクセスをサポートしている場合、リモート データセットへの読み取り専用のアクセスに ncreadatt
を使用して、HTTP バイト範囲機能を使用できます。
R2022a: 可変長配列データ型 (NC_VLEN
) の読み取り
netCDF-4 ファイルから、可変長配列データ型 (NC_VLEN
) を読み取ることができます。
R2021b: NC_STRING
属性の読み取り
netCDF-4 ファイルから NC_STRING
属性を読み取ることができます。
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)