h5readatt

HDF5 ファイルからの属性の読み取り

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

構文

attval = h5readatt(filename,loc,attr)

説明

attval = h5readatt(filename,loc,attr) は、HDF5 ファイルの指定された場所から指定された属性の値を取得します。

例

すべて折りたたむ

グループ属性の読み取り

ライブスクリプトを開く

HDF5 ファイル example.h5 のルートグループから属性 attr2 を読み取ります。

val = h5readatt('example.h5','/','attr2')

val = 2×2 int32 matrix

   0   2
   1   3

データセット属性の読み取り

ライブスクリプトを開く

HDF5 ファイル example.h5 内のデータセット lon から属性 units を読み取ります。

val = h5readatt('example.h5','/g4/lon','units')

val = 
'degrees_east'

入力引数

すべて折りたたむ

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

既存の 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 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 スカラーとして指定します。ファイルのルートグループから属性を読み取るには、場所として '/' を指定します。

`attr` — 属性名
文字ベクトル | string スカラー

属性名。グループまたはデータセットに属している属性の名前が含まれる文字ベクトルまたは string スカラーとして指定します。

制限

MATLAB では、認証が必要なインターネット URL はサポートされていません。
MATLAB Online™ では Microsoft^® OneDrive™ ファイルおよびフォルダーに関連付けられたインターネット URL はサポートされていますが、MATLAB のインストールバージョンではローカル OneDrive ファイルのみがサポートされています。
h5readatt 関数は、ファイル整合性チェックに失敗した属性およびデータセットに対してエラーを発行します。このような状況で属性を読み取るには、H5P.set_relax_file_integrity_checks 関数と低水準の HDF5 インターフェイスを使用します。 (R2024b 以降)

バージョン履歴

R2011a で導入

すべて展開する

R2024b: ファイル整合性チェックに失敗した属性およびデータセットのサポートを終了 (R2024b Update)

h5readatt 関数は、ファイル整合性チェックに失敗した属性およびデータセットに対してエラーを発行するようになりました。以前は、そのような属性やデータセットに対して、この関数でエラーは発行されませんでした。このような状況で属性を読み取るには、H5P.set_relax_file_integrity_checks 関数と低水準の HDF5 インターフェイスを使用します。低水準の HDF5 インターフェイスを使用するようにコードを更新する方法を次の表に示します。

R2024a 以前	R2024b 以降
myAttrValue = h5readatt("myFilename.h5","myDatasetName","myAttrName");	fapl = H5P.create("H5P_FILE_ACCESS"); H5P.set_relax_file_integrity_checks(fapl,"H5F_RFIC_UNUSUAL_NUM_UNUSED_NUMERIC_BITS") fid = H5F.open("myFilename.h5","H5F_ACC_RDONLY",fapl); dset_id = H5D.open(fid,"myDatasetName"); attrID = H5A.open(dset_id,"myAttrName"); myAttrValue = H5A.read(attrID); H5A.close(attrID) H5D.close(dset_id) H5F.close(fid) H5P.close(fapl)

R2024a 以前

R2024b 以降

myAttrValue = h5readatt("myFilename.h5","myDatasetName","myAttrName");

fapl = H5P.create("H5P_FILE_ACCESS");
H5P.set_relax_file_integrity_checks(fapl,"H5F_RFIC_UNUSUAL_NUM_UNUSED_NUMERIC_BITS")
fid = H5F.open("myFilename.h5","H5F_ACC_RDONLY",fapl);
dset_id = H5D.open(fid,"myDatasetName");
attrID = H5A.open(dset_id,"myAttrName");
myAttrValue = H5A.read(attrID);
H5A.close(attrID)
H5D.close(dset_id)
H5F.close(fid)
H5P.close(fapl)

R2024b: HTTP および HTTPS を介した HDF5 ファイルからの属性の読み取り

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

R2020b: リモートの場所にある HDF5 ファイルからの属性の読み取り

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

R2020b: Unicode の名前をもつ HDF5 ファイルからの属性の読み取り

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

R2020a: MATLAB string 配列としての非スカラーの string 属性の読み取り

h5readatt は、HDF5 string 配列属性を、文字ベクトルの cell 配列ではなく MATLAB string 配列として返します。単一の (スカラー) HDF5 string 属性は、MATLAB 文字ベクトルとして返されます。

参考

h5writeatt | h5info | h5disp

トピック

高水準 HDF5 関数を使用したデータのインポート