readtable
Составьте таблицу из файла
Описание
T = readtable(filename)
readtable определяет формат файла из расширения файла:
.txt,.dat, или.csvдля файлов разделенного текста.xls,.xlsb,.xlsm,.xlsx,.xltm,.xltx, или.odsдля файлов электронной таблицы
readtable создает одну переменную в T для каждого столбца в файле и именах переменных чтений из первой строки файла. По умолчанию созданными переменными является double когда целый столбец является числовым, или массивы ячеек из символьных векторов, когда любой элемент в столбце не является числовым.
T = readtable(___,Name,Value)readtable читает первую строку файла как имена переменных или как данные.
Чтобы установить определенные настройки импорта для ваших данных, можно или использовать opts возразите или можно задать пары "имя-значение". Когда вы задаете пары "имя-значение" в дополнение к opts, затем readtable поддержки только эти пары "имя-значение":
Текст и параметры электронной таблицы —
ReadVariableNames'ReadRowNames'Текст только параметры —
DateLocale,EncodingЭлектронная таблица только параметры —
Sheet,UseExcel
Примеры
Составление таблицы от текстового файла
Загрузите файл myCsvTable.dat и предварительный просмотр его содержимое в текстовом редакторе. Снимок экрана показывают ниже. Заметьте, что файл содержит разделенные от запятой данные в столбцах.
filename = fullfile(matlabroot,'examples','matlab','myCsvTable.dat');
Составьте таблицу из разделенного от запятой текстового файла. Получившаяся таблица T содержит одну переменную для каждого столбца в файле и readtable обрабатывает записи в первой линии файла как имена переменных.
T = readtable(filename)
T=5×6 table
LastName Gender Age Height Weight Smoker
____________ ______ ___ ______ ______ ______
{'Smith' } {'M'} 38 71 176 1
{'Johnson' } {'M'} 43 69 163 0
{'Williams'} {'F'} 38 64 131 0
{'Jones' } {'F'} 40 67 133 0
{'Brown' } {'F'} 49 64 119 0
Составление таблицы от текстового файла без заголовков столбцов
Загрузите файл mySpaceDelimTable.txt и предварительный просмотр его содержимое в текстовом редакторе. Снимок экрана показывают ниже. Заметьте, что файл содержит разграниченный пробел, данные в столбцах.
filename = fullfile(matlabroot,'examples','matlab','mySpaceDelimTable.txt');
Составьте таблицу из файла разделенного текста пробела, который не содержит имена переменных как заголовки столбцов.
T = readtable(filename,... 'Delimiter',' ','ReadVariableNames',false)
T=3×5 table
Var1 Var2 Var3 Var4 Var5
_____ ____ ____ ______ _________
{'M'} 45 45 {'NY'} {'true' }
{'F'} 41 32 {'CA'} {'false'}
{'M'} 40 34 {'MA'} {'false'}
T содержит имена переменных по умолчанию.
Создание и таблица формата из текстового файла
Загрузите файл myCsvTable.dat и предварительный просмотр его содержимое в текстовом редакторе. Снимок экрана показывают ниже. Заметьте, что файл содержит разделенные от запятой данные в столбцах.
filename = fullfile(matlabroot,'examples','matlab','myCsvTable.dat');
Составьте таблицу из разделенного от запятой текстового файла. Импортируйте первые два столбца как векторы символов, третий столбец как uint32, и следующие два столбца как с двойной точностью, числа с плавающей запятой. Импортируйте записи последнего столбца как векторы символов.
T = readtable(filename,'Format','%s%s%u%f%f%s')
T=5×6 table
LastName Gender Age Height Weight Smoker
____________ ______ ___ ______ ______ ______
{'Smith' } {'M'} 38 71 176 {'1'}
{'Johnson' } {'M'} 43 69 163 {'0'}
{'Williams'} {'F'} 38 64 131 {'0'}
{'Jones' } {'F'} 40 67 133 {'0'}
{'Brown' } {'F'} 49 64 119 {'0'}
Спецификаторами преобразования является %s для массива ячеек из символьных векторов, %f для double, и %u для uint32.
Чтение дат иностранного языка из текстового файла
Считайте немецкие даты из файла и добавьте их в таблицу как английские даты.
Загрузите файл german_dates.txt и предварительный просмотр его содержимое в текстовом редакторе. Снимок экрана показывают ниже. Заметьте, что первый столбец значений содержит даты на немецком языке, и вторые и третьи столбцы являются числовыми значениями.
filename = fullfile(matlabroot,'examples','matlab','german_dates.txt');
Считайте файл примера с помощью readtable. Спецификаторами преобразования является %D даты и %f для значений с плавающей точкой. Задайте кодирование файла с помощью FileEncoding аргумент пары "имя-значение". Задайте формат и локаль дат с помощью DateLocale аргумент пары "имя-значение".
T = readtable(filename,'ReadVariableNames',false,... 'Format','%{dd MMMM yyyy}D %f %f',... 'FileEncoding','ISO-8859-15',... 'DateLocale','de_DE')
T=3×3 table
Var1 Var2 Var3
________________ ____ _____
01 January 2014 20.2 100.5
01 February 2014 21.6 102.7
01 March 2014 20.7 99.8
Составление таблицы из электронной таблицы включая имена строки
Составьте таблицу из электронной таблицы, которая содержит имена переменных в первой строке и имена строки в первом столбце.
T = readtable('patients.xls','ReadRowNames',true);
Отобразите первые пять строк и сначала четыре переменные таблицы.
T(1:5,1:4)
ans=5×4 table
Gender Age Location Height
__________ ___ _____________________________ ______
Smith {'Male' } 38 {'County General Hospital' } 71
Johnson {'Male' } 43 {'VA Hospital' } 69
Williams {'Female'} 38 {'St. Mary's Medical Center'} 64
Jones {'Female'} 40 {'VA Hospital' } 67
Brown {'Female'} 49 {'County General Hospital' } 64
Просмотрите DimensionNames свойство таблицы.
T.Properties.DimensionNames
ans = 1x2 cell array
{'LastName'} {'Variables'}
'LastName' имя в первом столбце первой строки электронной таблицы.
Чтение определенной области значений данных из электронной таблицы
Составьте таблицу с помощью данных из заданной области электронной таблицы patients.xls. Используйте данные из 5 3 прямоугольной области между углами C2 и E6. Не используйте первую строку этой области как имена переменных.
T = readtable('patients.xls',... 'Range','C2:E6',... 'ReadVariableNames',false)
T =
Var1 Var2 Var3
____ ___________________________ ____
38 'County General Hospital' 71
43 'VA Hospital' 69
38 'St. Mary's Medical Center' 64
40 'VA Hospital' 67
49 'County General Hospital' 64
T содержит имена переменных по умолчанию.
Обнаружьте и используйте настройки импорта в текстовых файлах
Создайте настройки импорта, адаптируйте типы данных для нескольких переменных, и затем считайте данные.
Создайте объект настроек импорта из текстового файла.
opts = detectImportOptions('airlinesmall.csv')opts =
DelimitedTextImportOptions with properties:
Format Properties:
Delimiter: {','}
Whitespace: '\b\t '
LineEnding: {'\n' '\r' '\r\n'}
CommentStyle: {}
ConsecutiveDelimitersRule: 'split'
LeadingDelimitersRule: 'keep'
EmptyLineRule: 'skip'
Encoding: 'UTF-8'
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
ExtraColumnsRule: 'addvars'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
VariableTypes: {'double', 'double', 'double' ... and 26 more}
SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
VariableOptions: Show all 29 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
PreserveVariableNames: false
Location Properties:
DataLines: [2 Inf]
VariableNamesLine: 1
RowNamesColumn: 0
VariableUnitsLine: 0
VariableDescriptionsLine: 0
To display a preview of the table, use preview
Исследуйте Type свойство переменных TaxiIn и TaxiOut.
getvaropts(opts,{'TaxiIn','TaxiOut'})ans =
1x2 TextVariableImportOptions array with properties:
Name
Type
FillValue
TreatAsMissing
QuoteRule
Prefixes
Suffixes
EmptyFieldRule
WhitespaceRule
Измените тип переменных TaxiIn и TaxiOut к double.
opts = setvartype(opts,{'TaxiIn','TaxiOut'},'double');Задайте подмножество переменных, чтобы импортировать и исследовать.
opts.SelectedVariableNames = {'TaxiIn','TaxiOut'};Используйте readtable функция наряду с опциями возражает, чтобы импортировать выбранные переменные. Отобразите сводные данные таблицы.
T = readtable('airlinesmall.csv',opts);
summary(T)Variables:
TaxiIn: 123523x1 double
Values:
Min 0
Median 5
Max 1451
NumMissing 37383
TaxiOut: 123523x1 double
Values:
Min 0
Median 13
Max 755
NumMissing 37364
Обнаружьте и используйте настройки импорта в файлах электронной таблицы
Обнаружьте настройки импорта для файла электронной таблицы, задайте переменные, чтобы импортировать, и затем считать данные.
Создайте объект настроек импорта из файла.
opts = detectImportOptions('patients.xls')opts =
SpreadsheetImportOptions with properties:
Sheet Properties:
Sheet: ''
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
VariableTypes: {'char', 'char', 'double' ... and 7 more}
SelectedVariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
VariableOptions: Show all 10 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
PreserveVariableNames: false
Range Properties:
DataRange: 'A2' (Start Cell)
VariableNamesRange: 'A1'
RowNamesRange: ''
VariableUnitsRange: ''
VariableDescriptionsRange: ''
To display a preview of the table, use preview
Измените объект опций задать который переменные импортировать.
opts.SelectedVariableNames = {'Systolic','Diastolic'};Используйте readtable наряду с опциями возражают, чтобы импортировать заданные переменные.
T = readtable('patients.xls',opts);
summary(T)Variables:
Systolic: 100x1 double
Values:
Min 109
Median 122
Max 138
Diastolic: 100x1 double
Values:
Min 68
Median 81.5
Max 99
Считайте табличные данные, содержащие произвольные имена переменных
Можно считать табличные данные при сохранении имен переменных, которые включают любые символы, включая символы non-ASCII и пробелы. Во-первых, составьте таблицу с произвольными именами переменных и запишите таблицу в текстовый файл. Затем считайте табличные данные назад при сохранении исходных имен переменных.
Составьте таблицу, содержащую произвольные имена переменных, и запишите табличные данные в файл 'sampletable.txt'.
LastName = {'Sanchez';'Johnson';'Li';'Diaz';'Brown'};
Age = [38;43;38;40;49];
Smoker = logical([1;0;1;0;1]);
varNames = {'Last Name','Age','Smoker (1 or 0)'};
T = table(LastName,Age,Smoker,'VariableNames',varNames)T=5×3 table
Last Name Age Smoker (1 or 0)
___________ ___ _______________
{'Sanchez'} 38 true
{'Johnson'} 43 false
{'Li' } 38 true
{'Diaz' } 40 false
{'Brown' } 49 true
writetable(T,'sampletable.txt')Считайте табличные данные назад с помощью readtable. По умолчанию MATLAB® преобразует любые имена переменных, которые включают пробелы и символы non-ASCII в допустимые идентификаторы MATLAB®. Например, MATLAB® преобразует имена переменных 'Last Name' к 'LastName', и 'Smoker (1 or 0)' к 'Smoker_1or0_'. Чтобы считать табличные данные при сохранении имен переменных, установите 'PreserveVariableNames' параметр к true.
T_preserve = readtable('sampletable.txt','PreserveVariableNames',true)
T_preserve=5×3 table
Last Name Age Smoker (1 or 0)
___________ ___ _______________
{'Sanchez'} 38 1
{'Johnson'} 43 0
{'Li' } 38 1
{'Diaz' } 40 0
{'Brown' } 49 1
Входные параметры
Выходные аргументы
Советы
Большие файлы в формате XLSX иногда медленно загружают. Для лучшей производительности импорта и экспорта Microsoft рекомендует, чтобы вы использовали формат XLSB.
Смотрите также
Инструмент для импорта | detectImportOptions | preview | readcell | readmatrix | readtimetable | readvars | table | textscan | writetable