setvaropts
Установите переменные настройки импорта
Синтаксис
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.