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

Добавление пакета к списку импорта

Добавьте путь matlab.io.hdf4.* к списку импорта.

import matlab.io.hdf4.*

Снабдите префиксом последующие вызовы функций в пакете matlat.io.hdf4.sd с sd, а не целый путь к пакету.

Создайте файл HDF4

Создайте новый файл HDF4 с помощью функции matlab.io.hdf4.sd.start. Эта функция соответствует стандартной программе SD API, SDstart.

sdID = sd.start('mydata.hdf','create');

sd.start создает файл и возвращает идентификатор файла под названием sdID.

Чтобы открыть существующий файл вместо того, чтобы создать новый, вызовите sd.start с доступом 'write' вместо 'create'.

Создайте набор данных HDF4

Создайте набор данных в файле для каждого массива MATLAB, который вы хотите экспортировать. Если вы пишете в существующий набор данных, можно перейти непосредственно к следующему шагу. В этом примере создайте один набор данных для массива выборочных данных, A, с помощью функции matlab.io.hdf4.sd.create. Эта функция соответствует стандартной программе SD API, SDcreate. Аргумент ds_type является вектором символов, задающим тип данных MATLAB набора данных.

A = [1 2 3 4 5 ; 6 7 8 9 10 ; 11 12 13 14 15]; 
ds_name = 'A';
ds_type = 'double';
ds_dims = size(A);
sdsID = sd.create(sdID,ds_name,ds_type,ds_dims);

sd.create возвращает идентификатор HDF4 SD набора данных, sdsID.

Запись данных MATLAB в файл HDF4

Запишите данные в A к набору данных в файле с помощью функции matlab.io.hdf4.sd.writedata. Эта функция соответствует стандартной программе SD API, SDwritedata. Аргумент start задает основанное на нуле начальное значение индекса.

start = [0 0];
sd.writeData(sdsID,start,A);

sd.writeData ставит операцию записи в очередь. Операции в очереди выполняются, когда вы закрываете файл HDF4.

Запишите данные MATLAB во фрагмент набора данных

Замените вторую строку набора данных с векторным B. Используйте входное значение start [1 0], чтобы начать запись во второй строке, первом столбце. start использует основанную на нуле индексацию.

B = [9 9 9 9 9];
start = [1 0];
sd.writeData(sdsID,start,B);

Запишите метаданные в файл HDF4

Создайте глобальный атрибут под названием creation_date со значением, которое является текущей датой и время. Используйте функцию matlab.io.hdf4.sd.setAttr, которая соответствует стандартной программе SD API, SDsetattr.

sd.setAttr(sdID,'creation_date',datestr(now));

sd.Attr создает атрибут файла, также названный глобальным атрибутом, сопоставленным с файлом HDF4, идентифицированным sdID.

Сопоставьте предопределенный атрибут, cordsys, к набору данных, идентифицированному sdsID. Возможные значения этого атрибута включают текстовые строки 'cartesian', 'polar' и 'spherical'.

attr_name = 'cordsys';
attr_value = 'polar';
sd.setAttr(sdsID,attr_name,attr_value);

Закрытие набора данных HDF4

Закройте доступ к набору данных, с помощью функции matlab.io.hdf4.sd.endAccess. Эта функция соответствует стандартной программе SD API, SDendaccess. Необходимо закрыть доступ ко всем наборам данных в и файлу HDF4 прежде, чем закрыть файл.

sd.endAccess(sdsID);

Закрытие файла HDF4

Закройте файл HDF4 с помощью функции matlab.io.hdf4.sd.close. Эта функция соответствует стандартной программе SD API, SDend.

sd.close(sdID);

Закрытие файла HDF4 выполняет все операции записи, которые были поставлены в очередь с помощью SDwritedata.