Установите переменные настройки импорта
opts = setvaropts(opts,Name,Value)opts = setvaropts(opts,selection,Name,Value)opts = setvaropts(opts,Name,Value)opts, основанном на объектах на спецификациях в аргументах Name,Value и, возвращают объект opts.
opts = setvaropts(opts,selection,Name,Value)opts для переменных, заданных в аргументе selection, на основе спецификаций в аргументах Name,Value.
Создайте объект настроек импорта, установите опции для выбранных переменных и импортируйте данные с помощью адаптированных опций и функции readtable.
Создайте объект опций для электронной таблицы patients.xls.
opts = detectImportOptions('patients.xls');Установите свойство FillValue для Smoker, Diastolic и переменных Systolic.
opts = setvaropts(opts,'Smoker','FillValue',false); opts = setvaropts(opts,{'Diastolic','Systolic'},'FillValue',0);
Выберите переменные, которые вы хотите импортировать.
opts.SelectedVariableNames = {'Smoker','Diastolic','Systolic'};Импортируйте переменные и отобразите сводные данные.
T = readtable('patients.xls',opts);
summary(T) Variables:
Smoker: 100x1 logical
Values:
True 34
False 66
Diastolic: 100x1 double
Values:
Min 68
Median 81.5
Max 99
Systolic: 100x1 double
Values:
Min 109
Median 122
Max 138
Импортирование данных, которые имеют пропавших без вести или неполные поля, требует распознавания недостающих экземпляров и решения, как недостающие экземпляры будут импортированы. Используйте importOptions, чтобы получить и эти решения и выбрать данные с помощью readtable.
Создайте объект настроек импорта для файла, обновите свойства, которые управляют импортом недостающих данных, и затем используют readtable, чтобы импортировать данные. Обратите внимание на то, что набор данных airlinesmall.csv имеет две числовых переменные ArrDelay и DepDelay, которые содержат недостающие данные, обозначенные NA.
Создайте объект настроек импорта из файла.
opts = detectImportOptions('airlinesmall.csv');Используйте свойство TreatAsMissing задать символы в данных, которые являются заполнителями для недостающих экземпляров. В этом примере эти две числовые переменные ArrDelay и DepDelay содержат недостающие поля, которые содержат текст NA.
opts = setvaropts(opts,{'ArrDelay','DepDelay'},'TreatAsMissing','NA');Задайте действие для функции импорта, чтобы взять при импорте недостающих экземпляров. Смотрите страницу свойств ImportOptions для большего количества опций.
opts.MissingRule = 'fill';Задайте значение, чтобы использовать, когда функция импорта найдет недостающий экземпляр. Здесь недостающие экземпляры в переменных ArrDelay и DepDelay заменяются 0.
opts = setvaropts(opts,{'ArrDelay','DepDelay'},'FillValue',0);Выберите переменные, с которыми вы хотите работать и импортировать их использующий readtable.
opts.SelectedVariableNames = {'ArrDelay','DepDelay'};
T = readtable('airlinesmall.csv',opts);Исследуйте значения в ArrDelay и DepDelay. Проверьте, что функция импорта заменила отсутствующие значения, обозначенные NA.
T(166:180,:)
ans=15×2 table
ArrDelay DepDelay
________ ________
-1 0
102 105
-11 0
0 0
-1 0
0 0
1 0
1 0
14 0
-14 0
5 0
25 38
0 -5
0 0
6 0
Используйте функцию setvaropts, чтобы обновить свойства, которые управляют импортом текстовых данных. Во-первых, получите объект настроек импорта для файла. Затем, исследуйте и обновите опции для текстовых переменных. Наконец, импортируйте переменные с помощью функции readtable.
Предварительно просмотрите данные в patients.xls. Заметьте текстовые данные в столбце LastName. Только предварительный просмотр первых 10 строк показывают здесь.
Получите объект настроек импорта.
opts = detectImportOptions('patients.xls');Получите и исследуйте VariableImportOptions на переменную LastName.
getvaropts(opts,'LastName')ans =
TextVariableImportOptions with properties:
Variable Properties:
Name: 'LastName'
Type: 'char'
FillValue: ''
TreatAsMissing: {}
QuoteRule: 'remove'
Prefixes: {}
Suffixes: {}
EmptyFieldRule: 'missing'
String Options:
WhitespaceRule: 'trim'
Установите тип данных переменной к string.
opts = setvartype(opts,'LastName','string');
Установите свойство FillValue переменной заменить отсутствующие значения на 'NoName'.
opts = setvaropts(opts,'LastName','FillValue','NoName');
Выберите, считайте и отобразите предварительный просмотр первых 10 строк переменной.
opts.SelectedVariableNames = 'LastName'; T = readtable('patients.xls',opts); T.LastName(1:10)
ans = 10x1 string array
"Smith"
"Johnson"
"Williams"
"Jones"
"Brown"
"Davis"
"Miller"
"Wilson"
"Moore"
"Taylor"
Используйте функцию setvaropts, чтобы обновить свойства, которые управляют импортом данных logical. Во-первых, получите объект настроек импорта для файла. Затем, исследуйте и обновите опции для логических переменных. Наконец, импортируйте переменные с помощью функции readtable.
Предварительно просмотрите данные в airlinesmall_subset.xlsx. Заметьте логические данные в столбце Cancelled. Только предварительный просмотр строк 30 - 40 показывают здесь.
Получите объект настроек импорта.
opts = detectImportOptions('airlinesmall_subset.xlsx');Получите и исследуйте VariableImportOptions на переменную Cancelled.
getvaropts(opts,'Cancelled')ans =
NumericVariableImportOptions with properties:
Variable Properties:
Name: 'Cancelled'
Type: 'double'
FillValue: NaN
TreatAsMissing: {}
QuoteRule: 'remove'
Prefixes: {}
Suffixes: {}
EmptyFieldRule: 'missing'
Numeric Options:
ExponentCharacter: 'eEdD'
DecimalSeparator: '.'
ThousandsSeparator: ''
TrimNonNumeric: 0
Установите тип данных переменной к logical.
opts = setvartype(opts,'Cancelled','logical');
Установите свойство FillValue переменной заменить отсутствующие значения на true.
opts = setvaropts(opts,'Cancelled','FillValue',true);
Выберите, считайте и отобразите сводные данные переменной.
opts.SelectedVariableNames = 'Cancelled'; T = readtable('airlinesmall_subset.xlsx',opts); summary(T)
Variables:
Cancelled: 1338x1 logical
Values:
True 29
False 1309
Используйте свойства DatetimeVariableImportOptions управлять импортом данных datetime. Во-первых, получите объект ImportOptions для файла. Затем, исследуйте и обновите VariableImportOptions для переменных datetime. Наконец, импортируйте переменные с помощью readtable.
Предварительный просмотр данных в outages.csv. Заметьте данные о дате и времени в столбцах OutageTime и RestorationTime. Только первые 10 строк показывают здесь.
Получите объект настроек импорта.
opts = detectImportOptions('outages.csv');Получите и исследуйте VariableImportOptions на переменные OutageTime и RestorationTime datetime.
varOpts = getvaropts(opts,{'OutageTime','RestorationTime'})varOpts =
1x2 DatetimeVariableImportOptions array with properties:
Name
Type
FillValue
TreatAsMissing
QuoteRule
Prefixes
Suffixes
EmptyFieldRule
DatetimeFormat
DatetimeLocale
TimeZone
InputFormat
Установите свойство FillValue переменных заменить отсутствующие значения на текущую дату и время.
opts = setvaropts(opts,{'OutageTime','RestorationTime'},...
'FillValue','now');Выберите, считайте и предварительно просмотрите эти две переменные. Заметьте, что отсутствующее значение во второй строке RestorationTime было заполнено текущей датой и время.
opts.SelectedVariableNames = {'OutageTime','RestorationTime'};
T = readtable('outages.csv',opts);
T(1:10,:)ans=10×2 table
OutageTime RestorationTime
____________________ ____________________
01-Feb-2002 12:18:00 07-Feb-2002 16:50:00
23-Jan-2003 00:49:00 21-Feb-2019 20:47:53
07-Feb-2003 21:15:00 17-Feb-2003 08:14:00
06-Apr-2004 05:44:00 06-Apr-2004 06:10:00
16-Mar-2002 06:18:00 18-Mar-2002 23:23:00
18-Jun-2003 02:49:00 18-Jun-2003 10:54:00
20-Jun-2004 14:39:00 20-Jun-2004 19:16:00
06-Jun-2002 19:28:00 07-Jun-2002 00:51:00
16-Jul-2003 16:23:00 17-Jul-2003 01:12:00
27-Sep-2004 11:09:00 27-Sep-2004 16:37:00
Используйте функцию setvaropts, чтобы обновить свойства, которые управляют импортом данных categorical. Во-первых, получите объект настроек импорта для файла. Затем, исследуйте и обновите опции для категориальных переменных. Наконец, импортируйте переменные с помощью функции readtable.
Предварительно просмотрите данные в outages.csv. Заметьте категориальные данные в столбцах Region и Cause. Эта таблица показывает только первые 10 строк.
Получите объект настроек импорта.
opts = detectImportOptions('outages.csv');Получите и исследуйте опции на переменные Region и Cause.
getvaropts(opts,{'Region','Cause'})ans =
1x2 TextVariableImportOptions array with properties:
Name
Type
FillValue
TreatAsMissing
QuoteRule
Prefixes
Suffixes
EmptyFieldRule
WhitespaceRule
Установите тип данных переменных к categorical.
opts = setvartype(opts,{'Region','Cause'},'categorical');Установите свойство FillValue переменных заменить отсутствующие значения на название категории 'Miscellaneous'. Установите свойство TreatAsMissing на 'unknown'.
opts = setvaropts(opts,{'Region','Cause'},...
'FillValue','Miscellaneous',...
'TreatAsMissing','unknown');Выберите, считайте и отобразите сводные данные этих двух переменных.
opts.SelectedVariableNames = {'Region','Cause'};
T = readtable('outages.csv',opts);
summary(T)Variables:
Region: 1468x1 categorical
Values:
MidWest 142
NorthEast 557
SouthEast 389
SouthWest 26
West 354
Cause: 1468x1 categorical
Values:
Miscellaneous 24
attack 294
earthquake 2
energy emergency 188
equipment fault 156
fire 25
severe storm 338
thunder storm 201
wind 95
winter storm 145
Импортируйте табличные данные содержащие переменные, которые имеют нежелательные префиксные и суффиксные символы. Во-первых, создайте, настройки импорта возражают и предварительно просматривают данные. Затем выберите переменные интереса и установите их типы переменных и свойства удалить нежелательные символы. Наконец, импортируйте данные интереса.
Создайте настройки импорта для файла и предварительно просмотрите таблицу.
filename = 'pref_suff_trim.csv';
opts = detectImportOptions(filename);
preview(filename,opts)ans=8×5 table
Time DayOfWeek Power Total_Fees Temperature
_______________________ _______________ ____________ __________ ___________
'Timestamp:1/1/06 0:00' '& Sun %20' '54.5448 MW' '$1.23' '-7.2222 C'
'Timestamp:1/2/06 1:00' '& Thu %20' '.3898 MW' '$300.00' '-7.3056 C'
'Timestamp:1/3/06 2:00' '& Sun %20' '51.6344 MW' '£2.50' '-7.8528 C'
'Timestamp:1/4/06 3:00' '& Sun %20' '51.5597 MW' '$0.00' '-8.1778 C'
'Timestamp:1/5/06 4:00' '& Wed %20' '51.7148 MW' 'Â¥4.00' '-8.9343 C'
'Timestamp:1/6/06 5:00' '& Sun %20' '52.6898 MW' '$0.00' '-8.7556 C'
'Timestamp:1/7/06 6:00' '& Mon %20' '55.341 MW' '$50.70' '-8.0417 C'
'Timestamp:1/8/06 7:00' '& Sat %20' '57.9512 MW' '$0.00' '-8.2028 C'
Выберите переменные интереса, задайте их типы и исследуйте их переменные значения настроек импорта.
opts.SelectedVariableNames = {'Time','Total_Fees','Temperature'};
opts = setvartype(opts,'Time','datetime');
opts = setvaropts(opts,'Time','InputFormat','MM/dd/uu HH:mm'); % Specify datetime format
opts = setvartype(opts,{'Total_Fees','Temperature'},'double');
getvaropts(opts,{'Time','Total_Fees','Temperature'})ans =
1x3 VariableImportOptions array with properties:
Variable Options:
(1) | (2) | (3)
Name: 'Time' | 'Total_Fees' | 'Temperature'
Type: 'datetime' | 'double' | 'double'
FillValue: [NaT] | [NaN] | [NaN]
TreatAsMissing: {} | {} | {}
QuoteRule: 'remove' | 'remove' | 'remove'
Prefixes: {} | {} | {}
Suffixes: {} | {} | {}
To access sub-properties of each variable, use getvaropts
Установите Prefixes, Suffixes, и свойства TrimNonNumeric переменных настроек импорта удалить 'Timestamp:' из переменной Time, удалить суффиксный 'C' из переменной Temperature и удалить все нечисловые символы из переменной Total_Fees. Предварительно просмотрите таблицу с новыми настройками импорта.
opts = setvaropts(opts,'Time','Prefixes','Timestamp:'); opts = setvaropts(opts,'Temperature','Suffixes','C'); opts = setvaropts(opts,'Total_Fees','TrimNonNumeric',true); preview(filename,opts)
ans=8×3 table
Time Total_Fees Temperature
______________ __________ ___________
01/01/06 00:00 1.23 -7.2222
01/02/06 01:00 300 -7.3056
01/03/06 02:00 2.5 -7.8528
01/04/06 03:00 0 -8.1778
01/05/06 04:00 4 -8.9343
01/06/06 05:00 0 -8.7556
01/07/06 06:00 50.7 -8.0417
01/08/06 07:00 0 -8.2028
Импортируйте данные с помощью readtable.
T = readtable(filename,opts);
Создайте объект настроек импорта для файла, содержащего пустые поля. Используйте параметр EmptyFieldRule, чтобы управлять импортом пустых полей в ваших данных. Во-первых, предварительно просмотрите данные, и затем установите параметр EmptyFieldRule для определенной переменной. Наконец, установите EmptyFieldRule для всех переменных и импортируйте данные.
Создайте объект настроек импорта для файла, содержащего пустые поля. Получите первые восемь строк таблицы с помощью функции preview. Значением по умолчанию для EmptyFieldRule является 'missing'. Поэтому функция импорта обрабатывает пустые поля как пропавших без вести и заменяет их на значение FillValue для той переменной. Используя VariableOptions для третьей переменной, предварительно просмотрите данные. Здесь, функция preview импортирует пустые поля в третьей переменной как NaN s.
filename = 'DataWithEmptyFields.csv'; opts = detectImportOptions(filename); opts.VariableOptions(3) % Display the Variable Options for the 3rd Variable
ans =
NumericVariableImportOptions with properties:
Variable Properties:
Name: 'Double'
Type: 'double'
FillValue: NaN
TreatAsMissing: {}
QuoteRule: 'remove'
Prefixes: {}
Suffixes: {}
EmptyFieldRule: 'missing'
Numeric Options:
ExponentCharacter: 'eEdD'
DecimalSeparator: '.'
ThousandsSeparator: ''
TrimNonNumeric: 0
preview(filename,opts)
ans=8×7 table
Text Categorical Double Datetime Logical Duration String
_____ ___________ ______ ____________________ _______ ________ ______
'abc' 'a' 1 14-Jan-0018 00:00:00 'TRUE' 00:00:01 'abc'
'' 'b' 2 21-Jan-0018 00:00:00 'FALSE' 09:00:01 'def'
'ghi' '' 3 31-Jan-0018 00:00:00 'TRUE' 02:00:01 'ghi'
'jkl' 'a' NaN 23-Feb-2018 00:00:00 'FALSE' 03:00:01 'jkl'
'mno' 'a' 4 NaT 'FALSE' 04:00:01 'mno'
'pqr' 'b' 5 23-Jan-0018 00:00:00 '' 05:00:01 'pqr'
'stu' 'b' 5 23-Mar-0018 00:00:00 'FALSE' NaN 'stu'
'' 'a' 6 24-Mar-2018 00:00:00 'TRUE' 07:00:01 ''
Установите EmptyFieldRule для второй переменной в таблице. Во-первых, выберите переменную, и затем установите EmptyFieldRule на 'auto'. Здесь, функция readtable импортирует пустые поля переменной categorical как <undefined>.
opts.SelectedVariableNames = 'Categorical'; opts = setvartype(opts,'Categorical','categorical'); opts = setvaropts(opts,'Categorical','EmptyFieldRule','auto'); T = readtable(filename,opts)
T=11×1 table
Categorical
___________
a
b
<undefined>
a
a
b
b
a
a
<undefined>
<undefined>
Затем, установите параметр EmptyFieldRule для всех переменных в таблице. Во-первых, обновите типы данных переменных соответственно. В данном примере установите тип данных пятых и седьмых переменных к logical и string, соответственно. Затем установите EmptyFieldRule для всех переменных к 'auto'. Функция импорта импортирует пустые поля на основе типа данных переменной. Здесь, функция readtable импортирует пустые поля переменной logical как 0 и пустые поля переменной categorical как <undefined>.
VariableNames = opts.VariableNames; opts.SelectedVariableNames = VariableNames; % select all variables opts = setvartype(opts,{'Logical','String'},{'logical','string'}); opts = setvaropts(opts,VariableNames,'EmptyFieldRule','auto'); T = readtable(filename,opts)
T=11×7 table
Text Categorical Double Datetime Logical Duration String
_____ ___________ ______ ____________________ _______ ________ _________
'abc' a 1 14-Jan-0018 00:00:00 true 00:00:01 "abc"
'' b 2 21-Jan-0018 00:00:00 false 09:00:01 "def"
'ghi' <undefined> 3 31-Jan-0018 00:00:00 true 02:00:01 "ghi"
'jkl' a NaN 23-Feb-2018 00:00:00 false 03:00:01 "jkl"
'mno' a 4 NaT false 04:00:01 "mno"
'pqr' b 5 23-Jan-0018 00:00:00 false 05:00:01 "pqr"
'stu' b 5 23-Mar-0018 00:00:00 false NaN "stu"
'' a 6 24-Mar-2018 00:00:00 true 07:00:01 ""
'' a 7 25-Mar-2018 00:00:00 true 08:00:01 ""
'xyz' <undefined> NaN NaT true 06:00:01 "xyz"
'' <undefined> NaN NaT false NaN <missing>
В дополнение к 'missing' и 'auto', можно также установить параметр EmptyFieldRule на 'error'. Когда вы устанавливаете его на 'error', функция readtable импортирует пустые поля путем выполнения процедуры, заданной в параметре ImportErrorRule.