Exponenta Banner

h5read

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

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

Синтаксис

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

Описание

пример

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

пример

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

пример

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

Примеры

свернуть все

Открыть Live Script

Получите метаданные для набора данных из файла 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
      ⋮
Открыть Live Script

Получите метаданные для набора данных из файла 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
Открыть Live Script

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

Сначала отобразите метаданные для набора данных /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

Поддержка