Exponenta Banner
exponenta event banner

h5read

Считывание данных из набора данных HDF5

свернуть все на странице

Синтаксис

data = h5read (имя файла, ds)
data = h5read (имя файла, ds, начало, число)
data = h5read (имя файла, ds, начало, число, шаг)

Описание

пример

data = h5read(filename,ds) считывает все данные из набора данных ds содержится в файле HDF5 filename.

пример

data = h5read(filename,ds,start,count) считывает подмножество данных из набора данных, начиная с местоположения, указанного в start. count указывает количество элементов для чтения вдоль каждого размера.

пример

data = h5read(filename,ds,start,count,stride) возвращает подмножество данных с интервалом между индексами каждого измерения набора данных, указанного stride.

Примеры

свернуть все

Открыть сценарий в реальном времени

Получите метаданные для набора данных из файла HDF5, а затем прочитайте набор данных.

Отображение метаданных для набора данных /g4/lat из файла HDF5 example.h5. 

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, а затем прочитайте подмножество набора данных.

Отображение метаданных для набора данных /g4/world из файла HDF5 example.h5. 

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
Открыть сценарий в реальном времени

Считывание данных из набора данных, где данные дискретизируются с заданным интервалом между индексами набора данных вдоль каждого измерения.

Сначала просмотрите метаданные для набора данных /g4/lon из файла HDF5 example.h5. Переменная в наборе данных имеет одно измерение с 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. Значение 1 в stride обращается к смежным значениям в соответствующем измерении, в то время как значение 2 получает доступ ко всем другим значениям в соответствующем измерении и т.д.

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

Входные аргументы

свернуть все

Имя файла, указанное как вектор символов или скаляр строки, содержащий имя существующего файла HDF5.

В зависимости от расположения файла, filename может принять одну из этих форм.

Местоположение

Форма

Текущая папка

Укажите имя файла в filename.

Пример: 'myFile.h5'

Другие папки

Если файл находится не в текущей папке или в папке по пути MATLAB ®, укажите полный или относительный путь вfilename.

Пример: 'C:\myFolder\myFile.h5'

Пример: 'myFolder\myFile.h5'

Удаленное расположение

Если файл хранится в удаленном местоположении, то filename должен содержать полный путь к файлу, указанному как унифицированный указатель ресурса (URL) формы:

scheme_name://path_to_file/my_file.ext

В зависимости от вашего удаленного местоположения, scheme_name может быть одним из значений в этой таблице.

Удаленное расположениеscheme_name
Амазонский S3™s3
Хранилище больших двоичных объектов Windows Azure ®wasb, wasbs
HDFS™hdfs

Дополнительные сведения см. в разделе Работа с удаленными данными.

Пример: 's3://bucketname/path_to_file/myFile.h5'

Имя набора данных, указанное как вектор символов или строковый скаляр, содержащий имя набора данных в файле HDF5. Набор данных HDF5 представляет собой многомерный массив элементов данных вместе с поддерживающими метаданными.

Начальное расположение, указанное как числовой вектор положительных целых чисел. Для N-мерный набор данных, start - вектор длины N, содержащий индексы на основе 1. Элементы start соответствуют, по порядку, переменным размерам.

Если не указать start, то h5read функция начинает считывать набор данных из первого индекса по каждому измерению.

Число считываемых элементов, указанное как числовой вектор положительных целых чисел. Для N-мерный набор данных, count - вектор длины N, указывая количество элементов для чтения вдоль каждого размера. Элементы count соответствуют, по порядку, переменным размерам. Если какой-либо элемент count является Inf, то h5read считывает до конца соответствующего измерения.

Если не указать count, то h5read функция считывает данные до конца каждого измерения.

Пространство между индексами вдоль каждого измерения набора данных, определяемое как числовой вектор целых чисел. Для N- размерная переменная в наборе данных, stride - вектор длины N. Элементы stride вектор соответствует по порядку переменным размерам. Значение 1 обращается к смежным значениям переменной в соответствующем измерении. Тогда как, значение 2 получает доступ ко всем другим значениям переменной в соответствующем измерении и т.д.

Если не указать stride, то h5read функция считывает данные с интервалом по умолчанию, равным 1 вдоль каждого размера.

См. также

| | |

Темы

Представлен в R2011a

Документация MATLAB

Поддержка