Main Content

hdfinfo

HDF4 ファイルまたは HDF-EOS2 ファイルに関する情報

構文

S = hdfinfo(filename)
S = hdfinfo(filename,mode)

説明

S = hdfinfo(filename) は、HDF4 ファイルまたは HDF-EOS2 ファイルの内容に関する情報を含むフィールドをもつ S 構造体を返します。filename には、HDF4 ファイルまたは HDF-EOS2 ファイルの名前を含む文字ベクトルまたは string スカラーを指定します。

S = hdfinfo(filename,mode) は、mode'hdf' の場合に HDF4 ファイルとしてファイルを読み取り、mode'eos' の場合に HDF-EOS2 ファイルとして読み取ります。mode'eos' の場合は、HDF-EOS データオブジェクトのみがクエリされます。HDF4 オブジェクトと HDF-EOS オブジェクトを共に含むファイルの情報すべてを取得するには、mode'hdf' としてください。

メモ

hdfinfo は、HDF4 ファイルまたは HDF-EOS2 ファイルに使用できます。HDF5 ファイルの情報を取得するには、h5info を使用します。

返される S 構造体の中のフィールド群は、個々のファイルに依存しています。S 構造体の中に存在するフィールドを次の表に示します。

モード

フィールド名

説明

戻り値の型

HDF

Attributes

データセットの属性

構造体配列

 

Description

注釈の説明

cell 配列

 

Filename

ファイル名

文字ベクトル

 

Label

注釈ラベル

cell 配列

 

Raster8

8 ビット ラスター イメージの説明

構造体配列

 

Raster24

24 ビット ラスター イメージの説明

構造体配列

 

SDS

科学データセットの説明

構造体配列

 

Vdata

Vdata セットの説明

構造体配列

 

Vgroup

Vgroup の説明

構造体配列

EOS

Filename

ファイル名

文字ベクトル

 

Grid

グリッド データ

構造体配列

 

Point

ポイント データ

構造体配列

 

Swath

swath データ

構造体配列

上記の表のフィールドで構造体配列を含むフィールドについて、次の表に詳細を示します。

返される構造体配列に共通なフィールド

関数 hdfinfo で返される構造体配列には、いくつかの共通フィールドを含んでいます。これらを、下の表に示します。すべての構造体配列で、これらすべてのフィールドを含んでいることに注意してください。

フィールド名

説明

データ型

Attributes

データセット属性。フィールド Name および Value を含む。

構造体配列

Description

注釈の説明

cell 配列

Filename

ファイル名

文字ベクトル

Label

注釈ラベル

cell 配列

Name

データセットの名前

文字ベクトル

Rank

データセットの次元数

double

Ref

データセット リファレンス番号

double

Type

HDF オブジェクトまたは HDF-EOS オブジェクトのタイプ

文字ベクトル

ある構造体固有のフィールド

関数 hdfinfo で返される構造体配列には、個々の構造体に対して一意のフィールドを含んでいます。次の表に示します。

Attribute 構造体のフィールド

フィールド名

説明

データ型

Name

属性名

文字ベクトル

Value

属性値または説明

数値またはテキスト

Raster8 と Raster24 構造体のフィールド

フィールド名

説明

データ型

HasPalette

イメージにパレットが関連付けられている場合は 1 (true) を、その他の場合は 0 (false) を返します (8 ビットのみ)。

logical

Height

イメージの高さ (ピクセル単位)

数値

Interlace

イメージのインターレース モード (24 ビットのみ)

文字ベクトル

Name

イメージ名

文字ベクトル

Width

イメージの幅 (ピクセル単位)

数値

SDS 構造体のフィールド

フィールド名

説明

データ型

DataType

データ精度

文字ベクトル

Dims

データセットの次元。フィールド NameDataTypeSizeScale、および Attributes が含まれます。Scale は次元に沿って配置された数の配列で、データセット内に境界を設けるものです。

構造体配列

Index

SDS のインデックス

数値

Vdata 構造体のフィールド

フィールド名

説明

データ型

DataAttributes

すべてのデータセットの属性。フィールド Name および Value を含む。

構造体配列

Class

データセットのクラス名

文字ベクトル

Fields

Vdata のフィールド。フィールド Name および Attributes を含む。

構造体配列

NumRecords

データセット レコードの数

double

IsAttribute

Vdata がある属性の場合は 1 (true) を、その他の場合は 0 (false) を返します。

logical

Vgroup 構造体のフィールド

フィールド名

説明

データ型

Class

データセットのクラス名

文字ベクトル

Raster8

8 ビット ラスター イメージの説明

構造体配列

Raster24

24 ビット ラスター イメージの説明

構造体配列

SDS

科学データセットの説明

構造体配列

Tag

Vgroup のタグ

数値

Vdata

Vdata セットの説明

構造体配列

Vgroup

Vgroups の説明

構造体配列

Grid 構造体のフィールド

フィールド名

説明

データ型

Columns

グリッド内の列数

数値

DataFields

グリッドの各 Grid フィールド内のデータ フィールドの説明。フィールド NameRankDimsNumberTypeFillValue、および TileDims を含む。

構造体配列

LowerRight

右下隅の位置 (単位: メートル)

数値

Origin Code

グリッドに対する原点の位置

数値

PixRegCode

ピクセルのレジストレーション コード

数値

Projection

投影コード、帯域コード、球面コード、グリッドの投影パラメーター。フィールド ProjCodeZoneCodeSphereCode、および ProjParam を含む。

構造体

Rows

グリッド内の行数

数値

UpperLeft

左上隅の位置 (単位: メートル)

数値

Point 構造体のフィールド

フィールド名

説明

データ型

Level

ポイントの個々のレベルの説明。フィールド NameNumRecordsFieldNamesDataType、および Index を含む。

構造体

Swath 構造体のフィールド

フィールド名

説明

データ型

DataFields

swath 内のデータ フィールド。フィールド NameRankDimsNumberType、および FillValue を含む。

構造体配列

GeolocationFields

swath 内の幾何学的な位置のフィールド。フィールド NameRankDimsNumberType、および FillValue を含む。

構造体配列

IdxMapInfo

幾何学的な位置のマッピングのインデックス付き要素間の関連。フィールド Map および Size を含む。

構造体

MapInfo

データと幾何学的な位置を表すフィールドとの関係。フィールド MapOffset、および Increment を含む。

構造体

ファイル example.hdf に関する情報を抽出します。

fileinfo = hdfinfo('example.hdf')

fileinfo = 
    Filename: 'example.hdf'
         SDS: [1x1 struct]
       Vdata: [1x1 struct]

example.hdf の中の科学データセットについて、これを使って抽出します。

sds_info = fileinfo.SDS

sds_info = 
       Filename: 'example.hdf'
           Type: 'Scientific Data Set'
           Name: 'Example SDS'
           Rank: 2
       DataType: 'int16'
     Attributes: []
           Dims: [2x1 struct]
          Label: {}
    Description: {}
          Index: 0

バージョン履歴

R2006a より前に導入

参考