readtable
Составьте таблицу из файла
Синтаксис
T = readtable(filename)T = readtable(filename,opts)T = readtable(___,Name,Value)Описание
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
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
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
Входные параметры
Выходные аргументы
Советы
Большие файлы в формате XLSX иногда медленно загружают. Для лучшего импорта и производительности экспорта, Microsoft рекомендует, чтобы вы использовали формат XLSB.
Смотрите также
Инструмент для импорта | detectImportOptions | preview | readcell | readmatrix | readtimetable | readvars | table | textscan | writetable