このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
h5read
HDF5 データセットからのデータの読み取り
構文
説明
例
HDF5 データセット全体の読み取り
HDF5 ファイルからデータセットのメタデータを取得してから、そのデータセットを読み取ります。
HDF5 ファイル example.h5
のデータセット /g4/lat
のメタデータを表示します。
h5disp('example.h5','/g4/lat')
HDF5 example.h5 Dataset 'lat' Size: 19 MaxSize: 19 Datatype: H5T_IEEE_F64LE (double) ChunkSize: [] Filters: none FillValue: 0.000000 Attributes: 'units': 'degrees_north' 'CLASS': 'DIMENSION_SCALE' 'NAME': 'lat'
データセットを読み取ります。
data = h5read('example.h5','/g4/lat')
data = 19×1
-90
-80
-70
-60
-50
-40
-30
-20
-10
0
⋮
HDF5 データセットのサブセットの読み取り
HDF5 ファイルからデータセットのメタデータを取得してから、そのデータセットのサブセットを読み取ります。
HDF5 ファイル example.h5
のデータセット /g4/world
のメタデータを表示します。
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
データセットのデータの先頭から、5 行 3 列のデータのサブセットを読み取ります。
start = [1 1]; count = [5 3]; data = h5read('example.h5','/g4/world',start,count)
data = 5×3
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
指定されたインデックスの間隔で HDF5 データセットを読み取る
データセットからデータを読み取ります。このときに、各次元に沿って、指定されたデータセット インデックスの間隔でデータがサンプリングされます。
まず、HDF5 ファイル example.h5
のデータセット /g4/lon
のメタデータを表示します。このデータセットの変数は 1 次元で、36 個の要素があります。
h5disp('example.h5','/g4/lon')
HDF5 example.h5 Dataset 'lon' Size: 36 MaxSize: 36 Datatype: H5T_IEEE_F64LE (double) ChunkSize: [] Filters: none FillValue: 0.000000 Attributes: 'units': 'degrees_east' 'CLASS': 'DIMENSION_SCALE' 'NAME': 'lon'
読み取りは startLoc
の位置から開始し、stride
で指定された間隔で変数データを読み取ります。stride
の値が 1
の場合、対応する次元内の隣接する値にアクセスします。一方、値が 2
の場合、対応する次元内の値に 1 つおきにアクセスし、以降同様に繰り返されます。
startLoc = 1; count = 18; stride = 2; subsetData = h5read('example.h5','/g4/lon',startLoc,count,stride);
出力変数 subsetData
を調べます。
whos subsetData
Name Size Bytes Class Attributes subsetData 18x1 144 double
入力引数
filename
— ファイル名
文字ベクトル | string スカラー
ファイル名。既存の HDF5 ファイルの名前を含む文字ベクトルまたは string スカラーとして指定します。
ファイルの場所によって、filename
は次のいずれかの形式をとります。
場所 | 形式 | ||||||||
---|---|---|---|---|---|---|---|---|---|
現在のフォルダー | ファイル名を 例: | ||||||||
その他のフォルダー | ファイルが現在のフォルダーまたは MATLAB® パス上のフォルダーにない場合は、 例: 例: | ||||||||
リモートの場所 | リモートの場所に保存されたファイルの場合、
リモートの場所に基づいて、
詳細については、リモート データの操作を参照してください。 例: |
ds
— データセット名
文字ベクトル | string スカラー
データセット名。HDF5 ファイル内のデータセット名を含む文字ベクトルまたは string スカラーとして指定します。HDF5 データセットは、データ要素の多次元配列と、サポートするメタデータを併せたものです。
start
— 開始位置
1 のベクトル (既定値) | 数値ベクトル
開始位置。正の整数の数値ベクトルとして指定します。N
次元のデータセットについて、start
は 1 ベースのインデックスを含む、長さ N
のベクトルです。start
の要素は、変数の次元に同じ順序で対応しています。
start
を指定しない場合、関数 h5read
は各次元に沿って、最初のインデックスからデータセットの読み取りを開始します。
count
— 要素数
Inf
のベクトル (既定値) | 数値ベクトル
読み取る要素数。正の整数の数値ベクトルとして指定します。N
次元のデータセットについて、count
は各次元に沿って読み取る要素数を指定する長さ N
のベクトルです。count
の要素は、変数の次元に同じ順序で対応しています。count
のいずれかの要素が Inf
の場合、h5read
は対応する次元の末尾まで読み取りを行います。
count
を指定しない場合、関数 h5read
は各次元の末尾までデータを読み取ります。
stride
— インデックス間の間隔
1 のベクトル (既定値) | 数値ベクトル
データセットの各次元に沿った変数インデックスの間隔。整数の数値ベクトルとして指定します。データセットの N
次元の変数について、stride
は長さが N
のベクトルです。ベクトル stride
の要素は、変数の次元に、同じ順序で対応しています。値が 1
の場合、対応する次元内の変数の隣接する値にアクセスします。値が 2
の場合、対応する次元内の変数の値に 1 つおきにアクセスし、以降同様に繰り返されます。
stride
を指定しない場合、関数 h5read
は各次元に沿って既定の間隔 1
でデータを読み取ります。
制限
h5read
は、グループへの参照の読み取りをサポートしていません。
バージョン履歴
R2011a で導入R2020b: リモートの場所にある HDF5 ファイルからのデータの読み取り
Amazon S3、Windows Azure Blob Storage、HDFS などのリモートの場所にある HDF5 ファイルからデータを読み取ることができます。
R2020b: Unicode の名前をもつ HDF5 ファイルからのデータの読み取り
Unicode 文字としてエンコードされた名前をもつ HDF5 ファイルからデータを読み取ることができます。
R2020a: MATLAB string 配列としての非スカラーの string データの読み取り
h5read
は、HDF5 string 配列を、文字ベクトルの cell 配列ではなく MATLAB string 配列として返します。単一の (スカラー) HDF5 string は、MATLAB 文字ベクトルとして返されます。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)