Установите переменные настройки импорта
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
readtable функция автоматически обнаруживает шестнадцатеричные и двоичные числа с 0x и 0b префиксы. Чтобы импортировать такие числа, когда у них не будет префиксов, используйте объект настроек импорта.
Создайте объект настроек импорта для файла hexAndBinary.txt. Его третий столбец имеет шестнадцатеричные числа без 0x префикс.
opts = detectImportOptions('hexAndBinary.txt')opts =
DelimitedTextImportOptions with properties:
Format Properties:
Delimiter: {','}
Whitespace: '\b\t '
LineEnding: {'\n' '\r' '\r\n'}
CommentStyle: {}
ConsecutiveDelimitersRule: 'split'
LeadingDelimitersRule: 'keep'
TrailingDelimitersRule: 'ignore'
EmptyLineRule: 'skip'
Encoding: 'UTF-8'
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
ExtraColumnsRule: 'addvars'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableTypes: {'auto', 'auto', 'char' ... and 1 more}
SelectedVariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableOptions: Show all 4 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
VariableNamingRule: 'modify'
Location Properties:
DataLines: [1 Inf]
VariableNamesLine: 0
RowNamesColumn: 0
VariableUnitsLine: 0
VariableDescriptionsLine: 0
To display a preview of the table, use preview
Чтобы указать, что третий столбец должен быть импортирован, как, шестнадцатеричные значения, несмотря на отсутствие префикса, используют setvaropts функция. Установите тип переменной третьей переменной к int32. Установите систему счисления для импорта третьего столбца к hex.
opts = setvaropts(opts,3,'NumberSystem','hex','Type','int32')
opts =
DelimitedTextImportOptions with properties:
Format Properties:
Delimiter: {','}
Whitespace: '\b\t '
LineEnding: {'\n' '\r' '\r\n'}
CommentStyle: {}
ConsecutiveDelimitersRule: 'split'
LeadingDelimitersRule: 'keep'
TrailingDelimitersRule: 'ignore'
EmptyLineRule: 'skip'
Encoding: 'UTF-8'
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
ExtraColumnsRule: 'addvars'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableTypes: {'auto', 'auto', 'int32' ... and 1 more}
SelectedVariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableOptions: Show all 4 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
VariableNamingRule: 'modify'
Location Properties:
DataLines: [1 Inf]
VariableNamesLine: 0
RowNamesColumn: 0
VariableUnitsLine: 0
VariableDescriptionsLine: 0
To display a preview of the table, use preview
Считайте файл и импортируйте первые три столбца как числовые значения. readtable функция автоматически обнаруживает, что первые и вторые столбцы содержат шестнадцатеричные и двоичные значения. Объект настроек импорта указывает, что третий столбец также содержит шестнадцатеричные значения.
T = readtable('hexAndBinary.txt',opts)T=3×4 table
Var1 Var2 Var3 Var4
_____ ____ _____ ___________
255 255 51193 {'Device1'}
256 4 1471 {'Device2'}
43981 129 61455 {'Device3'}
Используйте 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
"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
NumberSystem: 'decimal'
Установите тип данных переменной к 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
________________ ________________
2002-02-01 12:18 2002-02-07 16:50
2003-01-23 00:49 2020-08-17 15:48
2003-02-07 21:15 2003-02-17 08:14
2004-04-06 05:44 2004-04-06 06:10
2002-03-16 06:18 2002-03-18 23:23
2003-06-18 02:49 2003-06-18 10:54
2004-06-20 14:39 2004-06-20 19:16
2002-06-06 19:28 2002-06-07 00:51
2003-07-16 16:23 2003-07-17 01:12
2004-09-27 11:09 2004-09-27 16:37
Используйте 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
NumberSystem: 'decimal'
preview(filename,opts)
ans=8×7 table
Text Categorical Double Datetime Logical Duration String
__________ ___________ ______ __________ __________ ________ __________
{'abc' } {'a' } 1 01/14/0018 {'TRUE' } 00:00:01 {'abc' }
{0x0 char} {'b' } 2 01/21/0018 {'FALSE' } 09:00:01 {'def' }
{'ghi' } {0x0 char} 3 01/31/0018 {'TRUE' } 02:00:01 {'ghi' }
{'jkl' } {'a' } NaN 02/23/2018 {'FALSE' } 03:00:01 {'jkl' }
{'mno' } {'a' } 4 NaT {'FALSE' } 04:00:01 {'mno' }
{'pqr' } {'b' } 5 01/23/0018 {0x0 char} 05:00:01 {'pqr' }
{'stu' } {'b' } 5 03/23/0018 {'FALSE' } NaN {'stu' }
{0x0 char} {'a' } 6 03/24/2018 {'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=10×1 table
Categorical
___________
a
b
<undefined>
a
a
b
b
a
a
<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=10×7 table
Text Categorical Double Datetime Logical Duration String
__________ ___________ ______ __________ _______ ________ _________
{'abc' } a 1 01/14/0018 true 00:00:01 "abc"
{0x0 char} b 2 01/21/0018 false 09:00:01 "def"
{'ghi' } <undefined> 3 01/31/0018 true 02:00:01 "ghi"
{'jkl' } a NaN 02/23/2018 false 03:00:01 "jkl"
{'mno' } a 4 NaT false 04:00:01 "mno"
{'pqr' } b 5 01/23/0018 false 05:00:01 "pqr"
{'stu' } b 5 03/23/0018 false NaN "stu"
{0x0 char} a 6 03/24/2018 true 07:00:01 ""
{0x0 char} a 7 03/25/2018 true 08:00:01 <missing>
{'xyz' } <undefined> NaN NaT true 06:00:01 "xyz"
В дополнение к 'missing' и 'auto', можно также установить EmptyFieldRule параметр к 'error'. Когда вы устанавливаете его на 'error', readtable функционируйте импортирует пустые поля путем выполнения процедуры, заданной в ImportErrorRule параметр.