exponenta event banner

cdfwrite

Запишите данные к файлу Формата общих данных (CDF)

Примечание

cdfwrite не рекомендуется. Используйте низкоуровневые функции cdflib вместо этого.

Синтаксис

cdfwrite(filename,variablelist)
cdfwrite(...,'PadValues',padvals)
cdfwrite(...,'GlobalAttributes',gattrib)
cdfwrite(..., 'VariableAttributes', vattrib)
cdfwrite(...,'WriteMode',mode)
cdfwrite(...,'Format',format)

Описание

cdfwrite(filename,variablelist) выписывает файл Формата общих данных (CDF), к имени файла, обозначенному в filename. Задайте filename как вектор символов или представьте скаляр в виде строки. Аргумент variablelist является массивом ячеек упорядоченных пар, каждая из которых включает имя переменной CDF (заданный как вектор символов или скаляр строки) и соответствующее значение переменных CDF. Чтобы выписать несколько записей для переменной, поместите значения в массив ячеек, где каждый элемент в массиве ячеек представляет запись.

Примечание

Поскольку cdfwrite создает временные файлы, и целевая директория для файла и текущая рабочая директория должны быть writeable.

cdfwrite(...,'PadValues',padvals) выписывает значения клавиатуры для данных имен переменных. padvals является массивом ячеек упорядоченных пар, каждая из которых включает имя переменной (заданный как вектор символов или скаляр строки) и соответствующее значение клавиатуры. Значения клавиатуры являются значениями по умолчанию, сопоставленными с переменной, когда за пределы к записи получают доступ. Имена переменных, которые появляются в padvals, должны появиться в variablelist.

cdfwrite(...,'GlobalAttributes',gattrib) пишет структура gattrib как глобальные метаданные для CDF-файла. Каждое поле структуры является именем глобального атрибута. Значение каждого поля содержит значение атрибута. Чтобы выписать несколько значений для атрибута, поместите значения в массив ячеек, где каждый элемент в массиве ячеек представляет запись.

Примечание

Чтобы задать глобальное название атрибута, которое недопустимо в вашем приложении MATLAB®, создайте поле под названием 'CDFAttributeRename' в структуре атрибута. Значение этого поля должно иметь значение, которое является массивом ячеек упорядоченных пар. Упорядоченная пара состоит из имени исходного атрибута, как перечислено в структуре GlobalAttributes и соответствующем имени атрибута, который будет записан в CDF-файл.

cdfwrite(..., 'VariableAttributes', vattrib) пишет структура vattrib как переменные метаданные для CDF. Каждое поле struct является именем переменного атрибута. Значение каждого поля должно быть массивом ячеек M-2, где M является количеством переменных с атрибутами. Первый элемент в массиве ячеек должен быть именем переменной, и второй элемент должен быть значением атрибута для той переменной.

Примечание

Чтобы задать переменное название атрибута, которое недопустимо в MATLAB, создайте поле под названием 'CDFAttributeRename' в структуре атрибута. Значение этого поля должно иметь значение, которое является массивом ячеек упорядоченных пар. Упорядоченная пара состоит из имени исходного атрибута, как перечислено в struct VariableAttributes и соответствующем имени атрибута, который будет записан в CDF-файл. Если вы задаете переменный атрибут переменной CDF, которую вы переименовываете, имя переменной в структуре VariableAttributes должно совпасть с переименованной переменной.

cdfwrite(...,'WriteMode',mode), то, где mode является или 'overwrite' или 'append', указывает, должны ли заданные переменные быть добавлены к CDF-файлу, если файл уже существует. По умолчанию cdfwrite перезаписывает существующие переменные и атрибуты.

cdfwrite(...,'Format',format), то, где format является или 'multifile' или 'singlefile', указывает, выписаны ли данные как многофайловый CDF. В многофайловом CDF каждая переменная хранится в разделять файле с именем *.vN, где N является количеством переменной, которая выписана к CDF. По умолчанию cdfwrite выписывает одному файлу CDF. Когда 'WriteMode' установлен в 'Append', опция 'Format' проигнорирована, и формат существования ранее, CDF используется.

Примеры

Выпишите файлу 'example.cdf', содержащий переменную 'Longitude' со значением [0:360].

cdfwrite('example', {'Longitude', 0:360});

Выпишите файл, который 'example.cdf', содержащий переменные 'Longitude' и 'Latitude' с переменной 'Latitude', имеющей значение клавиатуры 10 для всех за пределы, записывает, к которым получают доступ.

cdfwrite('example', {'Longitude', 0:360, 'Latitude', 10:20}, ...
         'PadValues', {'Latitude', 10});

Выпишите файлу 'example.cdf', содержа переменную 'Longitude' со значением [0:360], и с переменным атрибутом 'validmin' со значением 10.

varAttribStruct.validmin = {'Longitude' [10]};
cdfwrite('example', {'Longitude' 0:360}, 'VariableAttributes', ...
         varAttribStruct);

Ограничения

  • CDF-файлы не поддерживают закодированные входные параметры non-ASCII. Имена переменных, имена атрибутов, значения переменных и значения атрибута должны иметь 7-битное кодирование ASCII. Попытка записать non-ASCII закодировала входные результаты по ошибкам или данным с поврежденными символами.

Смотрите также

| |

Представлено до R2006a