h5read

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

Синтаксис

data = h5read(filename,datasetname)
data = h5read(filename,datasetname,start,count)
data = h5read(filename,datasetname,start,count,stride)

Описание

пример

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

пример

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

пример

data = h5read(filename,datasetname,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.

Типы данных: char | string

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

Типы данных: char | string

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

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

Типы данных: double

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

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

Типы данных: double

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

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

Типы данных: double

Введенный в R2011a