exponenta event banner

экспорт

Класс: набор данных

(Не рекомендуется) Запись массива наборов данных в файл

dataset тип данных не рекомендуется. Для работы с разнородными данными используйте MATLAB ®table вместо этого тип данных. См. MATLAB table для получения дополнительной информации.

Синтаксис

export(DS,'file',filename)
export(DS)
export(DS,'file',filename,'Delimiter',delim)
export(DS,'XLSfile',filename)
export(DS,'XPTFile',filename)
export(DS,...,'WriteVarNames',false)
export(DS,...,'WriteObsNames',false)

Описание

export(DS,'file',filename) записывает массив наборов данных DS в текстовый файл с разделителями табуляции, включая имена переменных и имена наблюдений, если они имеются. Если имена наблюдений существуют, имя в первом столбце первой строки файла является именем первого размера для набора данных (по умолчанию: 'Observations'). export перезаписывает любой существующий файл с именем filename.

export(DS) запись в текстовый файл, имя которого по умолчанию является именем массива наборов данных DS в дополнение к '.txt'. Если export не может создать имя файла из входных данных массива наборов данных, он записывает в файл 'dataset.txt'. export перезаписывает любой существующий файл.

export(DS,'file',filename,'Delimiter',delim) записывает массив наборов данных DS в текстовый файл с помощью разделителя delim. delim должен быть одним из следующих:

  • ' ' или 'space'

  • '\t' или 'tab'

  • ',' или 'comma'

  • ';' или 'semi'

  • '|' или 'bar'

export(DS,'XLSfile',filename) записывает массив наборов данных DS в файл электронной таблицы Microsoft ® Excel ®, включая имена переменных и имена наблюдений (при их наличии). Можно указать 'Sheet' и 'Range' пары имя/значение параметра, со значениями параметра, принятыми xlsread функция. С тех пор export использует xlswrite внутренняя функция, этот синтаксис совместим только с Microsoft Excel для Windows ® и не работает на компьютере Mac. Дополнительные сведения см. в разделеxlswrite.

export(DS,'XPTFile',filename) записывает массив наборов данных DS в SAS XPORT форматировать файл. При записи в XPORT форматировать файл, переменные должны иметь скалярное значение. export сохраняет имена наблюдений в переменной с именем obsnames, если только WriteObsNames параметр, описанный ниже, false. XPORT формат ограничивает длину имен переменных восемью символами; более длинные имена переменных усекаются.

export(DS,...,'WriteVarNames',false) не записывает имена переменных в текстовый файл. export(DS,...,'WriteVarNames',true) по умолчанию, записывая имена в виде заголовков столбцов в первой строке файла.

export(DS,...,'WriteObsNames',false) не записывает имена наблюдений в текстовый файл. export(DS,...,'WriteObsNames',true) по умолчанию, записывая имена как первый столбец файла.

В некоторых случаях export создает текстовый файл, который не представляет A точно, как описано ниже. Если вы используете dataset для чтения файла обратно в MATLAB новый массив набора данных может иметь не совсем то же содержимое, что и исходный массив набора данных. Сохранить A как MAT-файл, если необходимо импортировать его снова как массив наборов данных.

export записывает числовые переменные с помощью long g formatи категориальные или символьные переменные как текст без кавычек.

Для несимвольных переменных с несколькими столбцами: export записывает несколько разделителей в каждой строке и создает подходящие заголовки столбцов для первой строки файла.

export записывает переменные, имеющие более двух измерений, как одно пустое поле в каждой строке файла.

Для переменных, возвращающих значение ячейки, export записывает содержимое каждой ячейки, только если ячейка содержит одну строку, и записывает одно пустое поле в противном случае.

В некоторых случаях export создает файл, который не может быть прочитан в MATLAB с помощью dataset. Запись массива набора данных, который содержит переменную с значением ячейки, содержимое которой не является скалярным, приводит к несоответствию в файле количества полей в каждой строке и количества заголовков столбцов в первой строке. При записи массива набора данных, содержащего переменную с значением ячейки, содержимое которой не совпадает по длине, в каждой строке файла появляется разное число полей. Поэтому, если может потребоваться повторный импорт массива наборов данных, сохраните его как .mat файл.

Примеры

Перемещение данных между внешними текстовыми файлами и массивами наборов данных в рабочей области MATLAB:

A = dataset('file','sat2.dat','delimiter',',')
A = 
    Test                  Gender          Score
    'Verbal'              'Male'          470  
    'Verbal'              'Female'        530  
    'Quantitative'        'Male'          520  
    'Quantitative'        'Female'        480  

export(A(A.Score > 500,:),'file','HighScores.txt')

B = dataset('file','HighScores.txt','delimiter','\t')
B = 
    Test                  Gender          Score
    'Verbal'              'Female'        530  
    'Quantitative'        'Male'          520 

См. также