h5read

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

Описание

пример

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
Amazon S3™s3
Устройство хранения данных Windows Azure® Blobwasb, wasbs
HDFS™hdfs

Для получения дополнительной информации смотрите работу с Удаленными данными.

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

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

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

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

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

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

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

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

Введенный в R2011a