info = struct with fields:
      Filename: '/mathworks/devel/bat/filer/batfs2566-0/Bdoc24b.2725827/build/runnable/matlab/toolbox/matlab/demos/example.h5'
          Name: '/'
        Groups: [4x1 struct]
      Datasets: []
     Datatypes: []
         Links: []
    Attributes: [2x1 struct]

グループに関する情報

ライブスクリプトを開く

グループ g4 に関する情報を返します。

info = h5info('example.h5','/g4')

info = struct with fields:
      Filename: '/mathworks/devel/bat/filer/batfs2566-0/Bdoc24b.2725827/build/runnable/matlab/toolbox/matlab/demos/example.h5'
          Name: '/g4'
        Groups: []
      Datasets: [4x1 struct]
     Datatypes: []
         Links: []
    Attributes: []

特定のデータセットに関する情報

ライブスクリプトを開く

グループ g4 内のデータセット time に関する情報を返します。

info = h5info('example.h5','/g4/time')

info = struct with fields:
      Filename: '/mathworks/devel/bat/filer/batfs2566-0/Bdoc24b.2725827/build/runnable/matlab/toolbox/matlab/demos/example.h5'
          Name: 'time'
      Datatype: [1x1 struct]
     Dataspace: [1x1 struct]
     ChunkSize: 10
     FillValue: 0
       Filters: []
    Attributes: [2x1 struct]

入力引数

すべて折りたたむ

`filename` — ファイル名
string スカラー | 文字ベクトル

既存の HDF5 ファイルのファイル名。string スカラーまたは文字ベクトルとして指定します。

ファイルの場所に応じて、filename は次の形式のいずれかをとります。

場所

形式

現在のフォルダー

ファイル名を filename で指定します。

例: "myFile.h5"

その他のフォルダー

ファイルが現在のフォルダーまたは MATLAB^® パス上のフォルダーにない場合は、filename に絶対パスまたは相対パスを指定します。

例: "C:\myFolder\myFile.h5"

例: "myFolder\myFile.h5"

Uniform Resource Locator (URL) (R2024b 以降)

ファイルをインターネット URL で指定する場合、filename には http:// などのプロトコルタイプが含まれていなければなりません。詳細については、リモートデータの操作を参照してください。

例: "http://my_hostname/my_path/my_file.h5"

リモートの場所

リモートの場所に保存されたファイルの場合、filename は次の形式の Uniform Resource Locator (URL) として指定されたファイルの絶対パスを含まなければなりません。

scheme_name://path_to_file/filename

リモートの場所に基づいて、scheme_name には次の表の値のいずれかを指定できます。

リモートの場所	`scheme_name`
Amazon S3™	`s3`
Windows Azure^® Blob Storage	`wasb`, `wasbs`
HDFS™	`hdfs`

詳細については、リモートデータの操作を参照してください。

例: "s3://myBucket/myFolder/myFile.h5"

ファイルが Family ドライバーを使用して複数の物理ファイルで構成されている場合は、書式指定子を使用して filename を指定します。たとえば、family0.h5 と family1.h5 の 2 つのファイルを含む Family ドライバーを使用するには、filename を "family%d.h5" と指定します。
ファイルが Multi ドライバーまたは Split ドライバーを使用して複数の物理ファイルで構成されている場合は、物理ファイルの名前の先頭にある接頭辞を filename として指定します。たとえば、multi-b.h5、multi-g.h5、multi-l.h5、multi-o.h5、multi-r.h5、および multi-s.h5 の 6 つのファイルを含む Multi ドライバーを使用するには、filename を "multi" と指定します。

`loc` — ファイル内の位置
文字ベクトル | string スカラー

ファイル内の位置。グループのファイルパス、データセット、またはファイル内の名前付きデータ型を含む文字ベクトルまたは string スカラーとして指定します。ファイル全体に関する情報を返すには、場所として '/' を指定します。

出力引数

すべて折りたたむ

`info` — ファイル情報
構造体

構造体として返されるファイル情報。loc 引数がファイルまたはグループ、データセット、または名前付きデータ型を指しているかに応じて、構造体にはさまざまなフィールドがあります。次の表に、場所タイプごとに存在するフィールドを示します。

ファイルとグループ

フィールド	説明
`Name`	グループまたはデータセットの名前を指定する文字ベクトル。HDF5 ファイル名のみを指定する場合、関数はルートグループに関する情報を返します。
`Groups`	サブグループを記述する構造体の配列。
`Datasets`	データセットを記述する構造体の配列。
`Datatypes`	名前付きデータ型を記述する構造体の配列。
`Links`	ソフト、外部、ユーザー定義、および所定のハードリンクを記述する構造体の配列。
`Attributes`	グループ属性を記述する構造体の配列。

データセット

フィールド	説明
`Name`	データセットの名前を指定する文字ベクトル。
`Datatype`	データ型を記述する構造体。
`Dataspace`	データセットのサイズを記述する構造体。
`ChunkSize`	定義されている場合は、データセットのチャンクサイズの次元。
`FillValue`	定義されている場合は、欠損データの埋め込み値。
`Filter`	圧縮など、定義済みフィルターを記述する構造体の配列。
`Attributes`	データセット属性を記述する構造体の配列。

名前付きデータ型

フィールド	説明
`Name`	データ型オブジェクトの名前を指定する文字ベクトル。
`Class`	名前付きデータ型の HDF5 クラス。
`Type`	データ型をさらに記述する文字ベクトルまたは構造体。
`Size`	名前付きデータ型のサイズ (バイト)

制限

MATLAB では、認証が必要なインターネット URL はサポートされていません。
MATLAB Online™ では Microsoft^® OneDrive™ ファイルおよびフォルダーに関連付けられたインターネット URL はサポートされていますが、MATLAB のインストールバージョンではローカル OneDrive ファイルのみがサポートされています。

バージョン履歴

R2011a で導入

すべて展開する

R2024b: HTTP および HTTPS を介した HDF5 ファイルに関する情報の読み取り

インターネット URL を指定して h5info 関数を使用することで、主要なオンラインソースに保存されている HDF5 ファイルに関する情報を読み取ることができます。

R2020b: リモートの場所にある HDF5 ファイルの情報の読み取り

Amazon S3、Windows Azure Blob Storage、HDFS などのリモートの場所にある HDF5 ファイルに関する情報を読み取ることができます。

R2020b: Unicode の名前をもつ HDF5 ファイルに関する情報の読み取り

Unicode 文字としてエンコードされた名前をもつ HDF5 ファイルに関する情報を読み取ることができます。

参考

h5read | h5write | h5disp | h5readatt

h5info

構文

説明

例

HDF5 ファイル全体に関する情報