h5disp

HDF5 ファイルの内容の表示

ページ内をすべて折りたたむ

構文

h5disp(filename)
h5disp(filename,loc)
h5disp(filename,loc,mode)
h5disp(___,'TextEncoding','UTF-8')

説明

h5disp(filename) は、指定された HDF5 ファイルの構造を記述するメタデータを表示します。

例

h5disp(filename,loc) は、ファイル内の指定した場所のメタデータを表示します。

例

h5disp(filename,loc,mode) はグループとデータセット名のみを表示します。ここで、mode は 'min' です。mode の既定値は 'simple' です。これは、データセットのメタデータと属性値を表示します。

例

h5disp(___,'TextEncoding','UTF-8') は、オブジェクトと属性名を強制的に UTF-8 エンコード済みテキストとして処理します。HDF5 ファイルが UTF-8 エンコードの使用を正確に指定する場合、こうした用途は必要ありません。

例

すべて折りたたむ

ライブ スクリプトを開く

5 行 5 列のチャンク サイズを使用して、50 行 50 列のデータセットを作成します。 

h5create('exampleFile2.h5','/exampleDataset',[50,50],'ChunkSize',[5 5])

HDF5 ファイルのメタデータを表示します。この例では、HDF5 ファイルにはそのルート グループ内の 1 つのデータセットが含まれています。データセットに属する属性がその名前の下に表示されます。

h5disp('exampleFile2.h5')
HDF5 exampleFile2.h5 
Group '/' 
    Dataset 'exampleDataset' 
        Size:  50x50
        MaxSize:  50x50
        Datatype:   H5T_IEEE_F64LE (double)
        ChunkSize:  5x5
        Filters:  none
        FillValue:  0.000000
ライブ スクリプトを開く

ファイル example.h5 内のデータセット /g4/world の属性を表示します。HDF5 ファイル内のデータセットの絶対パスを指定した場合、h5disp はデータセットの属性のみを表示します。

h5disp('example.h5','/g4/world')
HDF5 example.h5 
Dataset 'world' 
    Size:  36x19
    MaxSize:  36x19
    Datatype:   H5T_IEEE_F64LE (double)
    ChunkSize:  []
    Filters:  none
    FillValue:  0.000000
ライブ スクリプトを開く

表示モード 'min' を指定することで、グループとデータセット名のみを表示します。 

h5disp('example.h5','/g4/world','min')
HDF5 example.h5 
Dataset 'world'

入力引数

すべて折りたたむ

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

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

場所

形式

現在のフォルダー、または MATLAB® パス上のフォルダー

ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにある場合は、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 Storagewasb, 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" と指定します。

ファイル内の位置。ファイル内の場所への絶対パスを含む文字ベクトルまたは string スカラーとして指定します。ファイル全体のメタデータを表示するには、場所として '/' を指定します。loc がグループの場合、h5disp は、グループ内のすべてのオブジェクトを表示します。

表示モード。次の値のいずれかとして指定します。

  • 'simple' — 属性が整数、浮動小数点、またはスカラー string の場合、データセット名および属性値を表示する。

  • 'min' — グループとデータセット名のみを表示する。

制限

  • MATLAB では、認証が必要なインターネット URL はサポートされていません。

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

  • h5disp 関数の出力は、ファイル整合性チェックに失敗したデータセットおよび属性に関する情報を省略します。 (R2024b 以降)

バージョン履歴

R2011a で導入

すべて展開する

参考

| | |

トピック