Main Content

ncinfo

NetCDF データ ソースに関する情報を返す

構文

finfo = ncinfo(source)
vinfo = ncinfo(source,varname)
ginfo = ncinfo(source,groupname)

説明

finfo = ncinfo(source) は、source で指定された NetCDF データ ソース全体に関する情報を構造体 finfo に返します。ここで、source は NetCDF ファイルの名前、OPeNDAP NetCDF データ ソースの URL、またはリモート NetCDF ファイルの HTTP URL (バイト範囲読み取り用の #mode=bytes 接尾辞を含む) となります。

vinfo = ncinfo(source,varname) は、source 内の変数 varname に関する情報を構造体 vinfo に返します。

ginfo = ncinfo(source,groupname) は、source 内 (NetCDF4 データ ソースのみ) のグループ groupname に関する情報を構造体 ginfo に返します。

メモ

NetCDF ソースの視覚検査については ncdisp を使用します。

入力引数

source

NetCDF ファイルの名前、OPeNDAP NetCDF データ ソースの URL、またはバイト範囲読み取り用のリモート NetCDF ファイルの HTTP URL を指定する、文字ベクトルまたは string スカラー。リモート データセットのバイト範囲読み取りを有効にするには、HTTP URL の末尾に #mode=bytes を追加します。バイト範囲読み取りの詳細については、NetCDF のドキュメンテーションを参照してください。

例: "myNetCDFfile.nc"

varname

NetCDF ファイルまたは OPeNDAP データ ソース内の変数名を指定する文字ベクトルまたは string スカラー。

groupname

NetCDF ファイルまたは OPeNDAP データ ソース内のグループ名を指定する文字ベクトルまたは string スカラー。

出力引数

finfo

構造体には次のフィールドがあります。

フィールド説明 
FilenameNetCDF ファイル名または OPeNDAP URL 
Name'/' はファイル全体を示す 
Dimensions以下のフィールドを含む構造体の配列:
 Name次元名
 Length次元の現在の長さ
 Unlimitedbooleanフラグ (制限のない次元の場合、True)
Variables以下のフィールドを含む構造体の配列:
 Name変数名
 Dimensions関連次元
 Size現在の変数サイズ
 DatatypeMATLAB® データ型、またはユーザー定義型の名前
 Attributes関連変数属性
 ChunkSize定義されている場合はチャンク サイズ。それ以の場合は []
 FillValue変数の埋め込み値
 DeflateLevel有効になっている場合は Deflate フィルター レベル
 Shuffleシャッフル フィルター有効フラグ
Attributes以下のフィールドを含むグローバル属性の配列
 Name属性名
 Value属性値
Groupsnetcdf4 ファイルの場合は、ファイル内に存在するグループの配列。それ以外のすべての NetCDF ファイル形式の場合は、空配列 ([])。
FormatNetCDF ファイルの形式 
Datatypes以下のフィールドをもつ NetCDF ファイル内のサポートされている各ユーザー定義型について、情報を含んでいる構造体の配列 (ユーザー定義型なしのファイルでは空):
 Nameタイプ名
 Classクラス (NC_VLEN 型の場合、NC_VLEN を含む)
 Typeタイプ固有の情報 (NC_VLEN 型の場合、基本データ型を MATLAB データ型として含む)
 ByteSizeタイプのサイズ (バイト単位)

vinfo

finfo の変数フィールドのみを含んでいる構造体。

フィールド説明
FilenameNetCDF ファイル名
Name変数名
Dimensions変数の次元
Size現在の変数のサイズ
DatatypeMATLAB データ型、またはユーザー定義型の名前
Attributes変数に関連付けられている属性
ChunkSize定義されている場合はチャンク サイズ。それ以の場合は []
FillValue変数で使用されている埋め込み値
DeflateLevel有効になっている場合は Deflate フィルター レベル
Shuffleシャッフル フィルター有効フラグ
FormatNetCDF ファイルの形式

ginfo

finfo のグループ フィールドのみを含んでいる構造体。

フィールド説明
FilenameNetCDF ファイル名
Nameグループの名前
Dimensions指定されたグループに定義された次元のみ
Variables指定されたグループに定義された変数のみ
Attributes変数に関連付けられている属性
Groups定義されている場合はグループの名前。それ以外の場合は、[]
FormatNetCDF ファイルの形式

例

ファイルの名前が x という文字で始まる次元を検索します。

finfo = ncinfo('example.nc');
disp(finfo);
dimNames = {finfo.Dimensions.Name};
dimMatch = strncmpi(dimNames,'x',1);
disp(finfo.Dimensions(dimMatch));

変数のサイズを取得して、それが制限のない次元をもっているかどうか確認します。

vinfo = ncinfo('example.nc','peaks');
varSize = vinfo.Size;
disp(vinfo);
hasUnLimDim = any([vinfo.Dimensions.Unlimited]);

グループに定義されている制限のない次元をすべて見つけます。

ginfo = ncinfo('example.nc','/grid2/');
unlimDims = [ginfo.Dimensions.Unlimited];
disp(ginfo.Dimensions(unlimDims));

制限

  • バイト範囲読み取りのパフォーマンスは、他のソースからの読み取りよりも遅くなります。

バージョン履歴

R2011a で導入

参考

| | |

トピック