h5create

Набор данных Create HDF5

Описание

пример

h5create(filename,ds,sz) создает набор данных ds чье имя включает свое все местоположение в файл HDF5 filename, и с размером, заданным sz.

пример

h5create(filename,ds,sz,Name,Value) задает один или несколько дополнительных аргументов пары "имя-значение".

Например, 'ChunkSize',[5 5] задает фрагменты 5 на 5 набора данных, который может храниться индивидуально в файле HDF5.

Примеры

свернуть все

Создайте фиксированный размер 100 200 300 наборами данных 'myDataset' чей полный путь задан как '/g1/g2/myDataset'.

h5create('myfile.h5','/g1/g2/myDataset',[100 200 300])

Запишите данные к 'myDataset'. Начиная с размерностей 'myDataset' фиксируются, объем данных, который будет записан в него, должен совпадать со своим размером.

mydata = ones(100,200,300);
h5write('myfile.h5','/g1/g2/myDataset',mydata)
h5disp('myfile.h5')
HDF5 myfile.h5 
Group '/' 
    Group '/g1' 
        Group '/g1/g2' 
            Dataset 'myDataset' 
                Size:  100x200x300
                MaxSize:  100x200x300
                Datatype:   H5T_IEEE_F64LE (double)
                ChunkSize:  []
                Filters:  none
                FillValue:  0.000000

Создайте с одинарной точностью 1000 2000 набор данных и примените высший уровень сжатия. Устройство хранения данных фрагмента должно использоваться при применении сжатия HDF5.

h5create('myfile.h5','/myDataset2',[1000 2000],'Datatype','single', ...
          'ChunkSize',[50 80],'Deflate',9)

Отобразите содержимое целого файла HDF5.

h5disp('myfile.h5')
HDF5 myfile.h5 
Group '/' 
    Dataset 'myDataset2' 
        Size:  1000x2000
        MaxSize:  1000x2000
        Datatype:   H5T_IEEE_F32LE (single)
        ChunkSize:  50x80
        Filters:  deflate(9)
        FillValue:  0.000000

Создайте двумерный набор данных '/myDataset3' это неограниченно вдоль второго измерения. ChunkSize должен быть задан, чтобы установить любую размерность набора данных к Inf.

h5create('myfile.h5','/myDataset3',[200 Inf],'ChunkSize',[20 20])

Запишите данные к '/myDataset3'. Можно записать данные любого размера вдоль второго измерения к '/myDataset3', поскольку его второе измерение неограниченно.

mydata = rand(200,500);
h5write('myfile.h5','/myDataset3',mydata,[1 1],[200 500])

Отобразите целое содержимое файла HDF5.

h5disp('myfile.h5')
HDF5 myfile.h5 
Group '/' 
    Dataset 'myDataset3' 
        Size:  200x500
        MaxSize:  200xInf
        Datatype:   H5T_IEEE_F64LE (double)
        ChunkSize:  20x20
        Filters:  none
        FillValue:  0.000000

Входные параметры

свернуть все

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

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

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

Форма

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

Чтобы записать в текущую папку, задайте имя файла в filename.

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

Другие папки

Чтобы записать в папку, отличающуюся от текущей папки, задайте полное имя или относительный путь в 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

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

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

  • Если filename уже не существует, h5create создает его.

  • Если вы задаете существующее имя файла HDF5 и новое имя набора данных, то h5create добавит новый набор данных к существующему файлу HDF5.

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

Размер набора данных в виде вектора-строки. Чтобы задать неограниченную размерность, укажите соответствующий элемент sz как Inf.

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Deflate','9'

Тип данных набора данных в виде разделенной запятой пары, состоящей из 'Datatype' и любой из следующих типов данных MATLAB®.

  • 'double'

  • 'single'

  • 'uint64'

  • 'int64'

  • 'uint32'

  • 'int32'

  • 'uint16'

  • 'int16'

  • 'uint8'

  • 'int8'

  • 'string'

Разделите размер на блоки в виде разделенной запятой пары, состоящей из 'ChunkSize' и вектор-строка, содержащий размерности фрагмента. Длина 'ChunkSize' должен равняться длине размера набора данных sz'ChunkSize' должен быть задан, чтобы установить любую размерность в sz к Inf.

gzip уровень сжатия в виде числового значения между 0 и 9, где 0 самый низкий уровень сжатия и 9, является самым высоким.

Заполните значение для недостающих данных в числовых наборах данных. FillValue должно быть числовое значение.

32-битная контрольная сумма Флетчера фильтрует в виде разделенной запятой пары, состоящей из 'Fletcher32' и числового или (TRUE) логической единицы или 0 (FALSE). Фильтр контрольной суммы Флетчера спроектирован, чтобы проверить, что переданные данные в файле безошибочны.

Переставьте фильтр в виде разделенной запятой пары, состоящей из 'Shuffle' и числовой или логический 1 TRUE) или 0 ложь). Фильтр перестановки является алгоритмом, спроектированным, чтобы улучшить коэффициент сжатия путем реорганизации порядка байтов данных, хранимых в памяти.

Текстовое кодирование в виде разделенной запятой пары, состоящей из 'TextEncoding' и одно из этих значений:

  • 'UTF-8' — Представляйте символы с помощью кодирования UTF-8.

  • 'system' — Представляйте символы как байты с помощью системного кодирования (не рекомендуемый).

Ограничения

  • h5create не поддерживает файлы создания, хранившие удаленно в HDFS™.

Больше о

свернуть все

Разделите устройство хранения данных на блоки в HDF5

Устройство хранения данных фрагмента обращается к методу хранения набора данных в памяти путем деления его на мелкие кусочки данных, известных как "фрагменты". Разделение на блоки набора данных может улучшать производительность при работе с подмножеством набора данных, поскольку фрагменты могут быть считаны и записаны в файл HDF5 индивидуально.

Введенный в R2011a
Для просмотра документации необходимо авторизоваться на сайте