cdfread
CDF (Common Data Format) ファイルからデータを読み取る
構文
data = cdfread(filename)
data = cdfread(filename,Name1,Value1,...,NameN,ValueN)
[data,info] = cdfread(filename,...)
説明
data = cdfread(
は、filename
)filename
で指定された CDF (Common Data Format) ファイルから、すべてのデータを読み取ります。filename
は string スカラーまたは文字ベクトルとして指定します。CDF データセットには通常、変数の集合が格納されており、個々の変数は特定のデータ型をもち、レコードの集合が関連付けられています。変数は、個々のレコードについて、ある観測値が記録された特定の時間を表す時間値である場合もあります。cdfread
は、すべてのデータを 1 つの cell 配列で返します。ここでは各列が変数を表し、各行が変数に関連付けられているレコードを表します。変数に関連付けられるレコード数がさまざまである場合、cdfread
は行を付加 (pad) して四角形の cell 配列を作成し、CDF ファイルで定義されている pad 値を使用します。
メモ
cdfread
は一時ファイルを作成するため、現在の作業ディレクトリは書き込み可能でなければなりません。
data = cdfread(
は、ファイルからデータを読み取ります。ここで、filename
,Name1
,Value1
,...,NameN
,ValueN
)Name1
、…、NameN
には、次の表に示す任意の名前と値の引数を指定できます。
[data,info] = cdfread(
は、CDF ファイルに関する詳細を filename
,...)info
構造体で返します。
名前と値の引数 | 値 |
---|---|
"Records" | 読み取るレコードを指定するベクトル。レコード番号は 0 ベースです。 |
"Variables" | ファイルから読み取る単一の変数の名前を指定する string スカラーまたは文字ベクトル、またはファイルから読み取る 1 つ以上の変数の名前を指定する 1 行 n 列または n 行 1 列の cell 配列。n は、ファイル内の変数の総数以下でなければなりません。 |
"Slices" | m 行 3 列の配列。ここで各行は、変数の特定の次元で読み取りを開始する位置、その次元で使用するスキップ インターバル (すべての要素、要素 1 つおきなど)、およびその次元で読み取る値の総数を指定します。m は、変数の次元数以下でなければなりません。m が次元の総数より少ない場合、 メモ: 名前と値の引数 |
"DatetimeType" |
|
"CombineRecords" |
メモ: 名前と値の引数 メモ: 名前と値の引数 |
メモ
大きいデータ ファイルで作業する場合にパフォーマンスを向上させるには、名前と値の引数 CombineRecords
を使用します。
メモ
パフォーマンスを向上させるために、ファイルを開いたときに CDF ライブラリが既定で実行するファイルの検証をオフにしてください。詳細については、cdflib.setValidate
を参照してください。
例
制限
関数
cdfread
は、ASCII エンコード以外のデータをサポートしません。CDF ファイル内のすべての変数名、属性名、変数値および属性値は、7 ビット ASCII エンコードでなければなりません。ASCII エンコード以外のデータを読み取ろうとすると、エラーまたはデータの文字化けが発生します。