setvaropts
Установите переменные настройки импорта
Описание
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 datetime и RestorationTime.
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 20-Dec-2019 17:34:10
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 ismissing. Поэтому функция импорта обрабатывает пустые поля как пропавших без вести и заменяет их на FillValue значение для той переменной. Используя VariableOptions для третьей переменной предварительно просмотрите данные. Здесь, preview функционируйте импортирует пустые поля в третьей переменной как NaNs.
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' }
{0x0 char} {'b' } 2 21-Jan-0018 00:00:00 {'FALSE' } 09:00:01 {'def' }
{'ghi' } {0x0 char} 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 {0x0 char} 05:00:01 {'pqr' }
{'stu' } {'b' } 5 23-Mar-0018 00:00:00 {'FALSE' } NaN {'stu' }
{0x0 char} {'a' } 6 24-Mar-2018 00:00:00 {'TRUE' } 07:00:01 {0x0 char}
Установите 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"
{0x0 char} 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"
{0x0 char} a 6 24-Mar-2018 00:00:00 true 07:00:01 ""
{0x0 char} a 7 25-Mar-2018 00:00:00 true 08:00:01 ""
{'xyz' } <undefined> NaN NaT true 06:00:01 "xyz"
{0x0 char} <undefined> NaN NaT false NaN <missing>
В дополнение к 'missing' и 'auto', можно также установить EmptyFieldRule параметр к 'error'. Когда вы устанавливаете его на 'error', readtable функционируйте импортирует пустые поля путем выполнения процедуры, заданной в ImportErrorRule параметр.