Установите переменные настройки импорта
обновления все переменные в 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' 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 PreserveVariableNames: false 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' 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 PreserveVariableNames: false 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-01-29 12:47
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
функционируйте импортирует пустые поля в третьей переменной как 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 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=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 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 ""
{'xyz' } <undefined> NaN NaT true 06:00:01 "xyz"
{0x0 char} <undefined> NaN NaT false NaN ""
В дополнение к 'missing'
и 'auto'
, можно также установить EmptyFieldRule
параметр к 'error'
. Когда вы устанавливаете его на 'error'
, readtable
функционируйте импортирует пустые поля путем выполнения процедуры, заданной в ImportErrorRule
параметр.
opts
— Настройки импорта файлаSpreadsheetImportOptions
| DelimitedTextImportOptions
| FixedWidthImportOptions
Настройки импорта файла в виде SpreadsheetImportOptions
DelimitedTextImportOptions
, или FixedWidthImportOptions
объект создается detectImportOptions
функция. opts
объект содержит свойства, которые управляют процессом импорта данных, таким как переменные свойства, свойства местоположения данных, заменяющие правила и другие.
selection
— Выбранные переменныеВыбранные переменные в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов, массива строк, массива числовых индексов или логического массива.
Имена переменных (или индексы) должны быть подмножеством имен, содержавшихся в VariableNames
свойство opts
объект.
Пример: 'Height'
Пример: {'Height','LastName'}
Пример: [5 9]
Типы данных: char |
string
| cell
| uint64
| logical
Задайте дополнительные разделенные запятой пары Name,Value
аргументы. Name
имя аргумента и Value
соответствующее значение. Name
должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN
.
opts = setvaropts(opts,'Weight','FillValue',0)
устанавливает FillValue
для переменной Weight
к 0
.'Type'
— Тип данных переменных'char'
| 'string'
| 'single'
| 'double'
| 'int8'
| 'int16'
| ...Тип данных переменных в виде перечисленного в таблице типа данных.
Тип данных | Описание |
---|---|
| Текст. |
| Один - или числа плавающей точки двойной точности. |
| Целые числа со знаком или беззнаковое целое, сохраненное как 8-, 16-, 32-, или 64-битные целые числа. Целочисленные типы данных не задают значения, соответствующие числам с плавающей запятой
|
| Истинные или ложные значения (например, |
| Даты и времена, которые задают моменты времени (например, |
| Отрезки времени (например, 05:13:45 определение 5 часов, 13 минут и 45 секунд). |
| Числовой или текстовые данные, которые задают категории (например, |
'FillValue'
— Заменяющее значение для недостающих данныхtrue
| false
Заменяющее значение для недостающих данных, в зависимости от типа переменной в виде вектора символов, строкового скаляра, числовой скаляр, или логическое значение true
или false
.
Тип переменной | Описание |
---|---|
Текст | Текст замены, заданный как вектор символов или строковый скаляр. Пример:
|
Числовой | Скаляр, числовой, чтобы заменить недостающие экземпляры Функция импорта преобразует вход для Пример:
|
Логический |
Пример:
|
Datetime | Вектор символов или строковый скаляр или скалярное значение, представляющее данные о дате и времени. Для получения дополнительной информации о допустимом Пример:
Пример:
|
Длительность | Вектор символов или строковый скаляр или скалярное значение, представляющее данные о длительности. Для получения дополнительной информации о допустимом Пример:
|
Категориальный | Вектор символов или строковый скаляр, содержащий имя, чтобы использовать в заменяющей категории. Пример:
|
Чтобы направить импорт данных, которые отсутствуют, неконвертируемый, или это вызывает ошибки, используйте эти четыре свойства вместе: FillValue
'TreatAsMissing'
MissingRule
, и ErrorRule
. Функция импорта использует значение, заданное в FillValue
свойство, когда:
Данные неконвертируемы или совпадают со значением в TreatAsMissing
.
MissingRule
или ErrorRule
установлен в fill
.
'TreatAsMissing'
— Текст, чтобы интерпретировать как недостающие данныеТекст, чтобы интерпретировать как недостающие данные в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.
Когда функция импорта находит недостающие экземпляры, она использует спецификацию в MissingRule
свойство определить соответствующие меры.
Пример: 'TreatAsMissing',{'NA','TBD'}
дает функции импорта команду обрабатывать любое вхождение NA
или TBD
как недостающие поля.
Типы данных: char |
string
| cell
'QuoteRule'
— Процедура, чтобы управлять двойными кавычками'remove'
| 'keep'
| 'error'
Процедура, чтобы управлять двойными кавычками в данных в виде одного из значений в этой таблице.
'QuoteRule' | Процесс |
---|---|
'remove' | Если двойные кавычки ( Пример: Если два набора двойных кавычек ( Пример: Если пара открытия и закрытия заключает окружающие символы в кавычки, сопровождается синглом одинокие непарные двойные кавычки, то функция импорта игнорирует одинокую непарную двойную кавычку. Пример: |
'keep' | Сохраните все кавычки. |
'error' | Сообщите об ошибке при преобразовании данных, которые начинаются с двойной кавычки (" ). Используйте эту установку, если поле никогда не должно заключаться в кавычки. |
Пример: если 'QuoteRule'
установлен в 'remove'
, затем функция импорта импортирует "abc"def"
как abcdef"
.
Типы данных: char |
string
'EmptyFieldRule'
— Процедура, чтобы управлять пустыми полями'missing'
(значение по умолчанию) | 'error'
| 'auto'
Процедура, чтобы управлять пустыми полями в данных в виде одного из этих значений:
'missing'
— Используйте процедуру, заданную в MissingRule
свойство
'error'
— Используйте процедуру, заданную в ImportErrorRule
свойство
'auto'
— Используйте пустое значение на основе типа данных переменной
Тип данных | 'EmptyValue' |
---|---|
text | нулевая длина |
numeric |
0 |
duration |
|
datetime |
|
logical |
|
categorical |
|
Пример: opts = setvaropts(opts,'RestorationTime','EmptyFieldRule','auto');
Типы данных: char |
string
'Prefixes'
— Текст, чтобы удалить из префиксного положенияТекст, чтобы удалить из префиксного положения значения переменных в виде вектора символов, массива ячеек из символьных векторов, строкового скаляра или массива строк.
Пример: opts = setvaropts(opts,'Var1','Prefixes','$')
устанавливает Prefixes
опция для переменной Var1
. Если Var1
содержит значение '$500'
, затем readtable
чтения это как '500'
.
Типы данных: char |
string
| cell
'Suffixes'
— Текст, чтобы удалить из суффиксного положенияТекст, чтобы удалить из суффиксного положения значения переменных в виде вектора символов, массива ячеек из символьных векторов, строкового скаляра или массива строк.
Пример: opts = setvaropts(opts,'Var1','Suffixes','/-')
устанавливает Suffixes
опция для переменной Var1
. Если Var1
содержит значение '$500/-'
, затем readtable
чтения это как '$500'
.
Типы данных: char |
string
| cell
'WhiteSpaceRule'
— Процедура, чтобы управлять начальными и конечными пробелами'trim'
(значение по умолчанию) | 'trimleading'
| 'trimtrailing'
| 'preserve'
Процедура, чтобы управлять начальными и конечными пробелами при импортировании текстовых данных в виде одного из значений в таблице.
WhiteSpaceRule | Процесс |
---|---|
'trim' | Удалите любое продвижение или конечные пробелы из текста. Внутренний пробел незатронут. Пример: |
'trimleading' | Удалите только ведущие пробелы. Пример: |
'trimtrailing' | Удалите только конечные пробелы. Пример: |
'preserve' | Сохраните пробелы. Пример: |
Типы данных: char |
string
'ExponentCharacter'
— Символы, указывающие на экспонентуСимволы, указывающие на экспоненту в виде вектора символов или строкового скаляра. Функция импорта использует ExponentCharacter
свойство распознать символы, указывающие на экспоненту для номера, выраженного в экспоненциальном представлении.
Пример: если varOpts.ExponentCharacter = 'a'
, затем функция импорта импортирует текст "1.2a3"
как номер 1200
.
Типы данных: char |
string
'DecimalSeparator'
— Символы, указывающие на десятичный разделительСимволы, указывающие на десятичный разделитель в числовых переменных в виде вектора символов или строкового скаляра. Функция импорта использует символы, заданные в DecimalSeparator
пара "имя-значение", чтобы отличить целую часть номера от десятичной части.
При преобразовании в целочисленные типы данных числа с десятичной частью округлены к самому близкому целому числу.
Пример: Если пара "имя-значение" задана как 'DecimalSeparator',','
, затем функция импорта импортирует текст "3,14159"
как номер 3.14159
.
Типы данных: char |
string
'ThousandsSeparator'
— Символы, которые указывают на тысячи группировкиСимволы, которые указывают на тысячи группировки в числовых переменных в виде вектора символов или строкового скаляра. Тысячи группирующихся символов действуют как визуальные диафрагмы, группируя номер в каждых трех значениях места. Функция импорта использует символы, заданные в ThousandsSeparator
пара "имя-значение", чтобы интерпретировать импортируемые числа.
Пример: Если пара "имя-значение" задана как 'ThousandsSeparator',','
, затем функция импорта импортирует текст "1,234,000"
как 1234000
.
Типы данных: char |
string
'TrimNonNumeric'
— Удалите нечисловые символыfalse
(значение по умолчанию) | true
Удалите нечисловые символы из числовой переменной в виде логического true
или false
.
Пример: Если пара "имя-значение" задана как 'TrimNonNumeric',true
, затем функция импорта читает '$500/-'
как 500
.
Типы данных: логический
'NumberSystem'
— Система для интерпретации числовых переменных'decimal'
(значение по умолчанию) | 'hex'
| 'binary'
Система для интерпретации числовых переменных в виде 'decimal'
, 'hex'
, или 'binary'
.
Значение | Описание |
---|---|
|
|
|
|
|
|
'TrueSymbols'
— Текст, чтобы обработать как логическое значение true
Текст, чтобы обработать как логическое значение true
В виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.
Пример: если varOpts.TrueSymbols = {'t','TRUE'}
, затем функция импорта импортирует любые поля, содержащие t
или TRUE
как логическое значение true
.
Типы данных: char |
string
| cell
'FalseSymbols'
— Текст, чтобы обработать как логическое значение false
Текст, чтобы обработать как логическое значение false
В виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.
Пример: если varOpts.FalseSymbols = {'f','FALSE'}
, затем функция импорта импортирует любые поля, содержащие f
или FALSE
как логическое значение false
.
Типы данных: char |
string
| cell
'CaseSensitive'
— Индикатор, чтобы совпадать со случаемtrue
| false
Индикатор, чтобы совпадать со случаем в виде логического значения true
или false
.
Интерпретировать входные данные как пропавших без вести, true
, или false
, функция импорта совпадает с данными к значениям, заданным в TreatAsMissing
TrueSymbols
, и FalseSymbols
.
'DatetimeFormat'
Формат отображения'default'
| 'defaultdate'
| 'preserveinput'
| пользовательский формат | вектор символов | строковый скалярФормат отображения в виде вектора символов или строкового скаляра. DatetimeFormat
свойство управляет форматом отображения дат и времен в выходе. Задайте DatetimeFormat
как одно из этих значений.
Значение DatetimeFormat | Описание |
---|---|
| Используйте формат отображения по умолчанию. |
| Используйте формат отображения по умолчанию в стоимости datetime, созданной без компонентов времени. |
| Используйте формат, заданный форматом ввода, |
Пользовательские форматы | Используйте буквы |
Формат заводской настройки зависит от вашей системной локали. Чтобы изменить формат отображения по умолчанию, смотрите Формат datetime По умолчанию.
Типы данных: char |
string
'InputFormat'
— Формат входного текстаФормат входного текста, представляющего даты и времена в виде вектора символов или строкового скаляра, который содержит идентификаторы буквы.
Эта таблица показывает несколько общих форматов ввода и примеров отформатированного входа для даты, суббота, 19 апреля 2014 в 21:41:06 в Нью-Йорке.
Значение InputFormat | Пример |
---|---|
'yyyy-MM-dd' | 2014-04-19
|
'dd/MM/yyyy' | 19/04/2014
|
'dd.MM.yyyy' | 19.04.2014
|
'yyyy年 MM月 dd日' | 2014年 04月 19日
|
'MMMM d, yyyy' | April 19, 2014 |
'eeee, MMMM d, yyyy h:mm a' | Saturday, April 19, 2014 9:41 PM |
'MMMM d, yyyy HH:mm:ss Z' | April 19, 2014 21:41:06 -0400 |
'yyyy-MM-dd''T''HH:mmXXX' | 2014-04-19T21:41-04:00 |
Для полного списка допустимых идентификаторов буквы смотрите Format
свойство для массивов datetime.
Пример: 'InputFormat','eeee, MMMM d, yyyy HH:mm:ss'
Типы данных: char |
string
'DatetimeLocale'
— Локаль, чтобы интерпретировать датыЛокаль, чтобы интерпретировать даты в виде вектора символов или строкового скаляра. DatetimeLocale
значение определяет, как функция импорта интерпретирует текст, который представляет даты и времена.
Установите DatetimeLocale
к одному из этих значений:
'system'
— Задайте свою системную локаль.
Вектор символов или строковый скаляр — Использование форма
, где xx
_YY
xx
строчный ISO 639-1 двухбуквенный код, который задает язык и YY
прописная альфа ISO 3166-1 2 кода, которые задают страну.
Эта таблица приводит некоторые общие ценности для локали.
Локаль | Язык | Страна |
---|---|---|
'de_DE' | Немецкий язык | Германия |
'en_GB' | Английский язык | Соединенное Королевство |
'en_US' | Английский язык | Соединенные Штаты |
'es_ES' | Испанский язык | Испания |
'fr_FR' | Французский язык | Франция |
'it_IT' | Итальянский язык | Италия |
'ja_JP' | Японский язык | Япония |
'ko_KR' | Корейский язык | Корея |
'nl_NL' | Нидерландский язык | Нидерланды |
'zh_CN' | Китайский язык (упрощен) | Китай |
Пример: varOpts.DatetimeLocale = 'de_DE'
устанавливает локаль времени даты на немецкий язык.
Locale
значение определяет, как интерпретированы входные значения. Формат отображения и язык заданы опцией Локали в разделе формата Datetime панели Настроек. Чтобы изменить локаль datetime по умолчанию, см. Настройку параметров командного окна.
Типы данных: char |
string
'TimeZone'
TimeZone ''
(значение по умолчанию) | вектор символов | строковый скалярЧасовой пояс в виде вектора символов или строкового скаляра. Значение TimeZone
задает часовой пояс, что импорт функционирует использование, чтобы интерпретировать входные данные. TimeZone
также задает часовой пояс выходного массива. Если входные данные являются векторами символов, которые включают часовой пояс, то функция импорта преобразует все значения в зону требуемого времени.
TimeZone
используйте любое из этих значений:
''
, создавать “незонную” стоимость datetime, которая не принадлежит определенному часовому поясу.
Область часового пояса от Базы данных Часового пояса IANA; например, 'America/Los_Angeles'
. Имя области часового пояса составляет текущие и исторические правила для стандарта и смещений дневного света от UTC, которые наблюдаются в географической области.
Вектор символов ISO 8601 формы +HH:mm
или -HH:mm
. Например, '+01:00'
, задает часовой пояс, который является фиксированным смещением от UTC.
'UTC'
, создать стоимость datetime в универсальное время.
'UTCLeapSeconds'
, создать стоимость datetime в универсальное время, которая считает в течение секунд прыжка.
Эта таблица приводит некоторые общие названия областей часового пояса от Базы данных Часового пояса IANA.
Значение TimeZone | Смещение UTC | Смещение DST UTC |
---|---|---|
'Africa/Johannesburg' | +02:00 | +02:00 |
'America/Chicago' | −06:00 | −05:00 |
'America/Denver' | −07:00 | −06:00 |
'America/Los_Angeles' | −08:00 | −07:00 |
'America/New_York' | −05:00 | −04:00 |
'America/Sao_Paulo' | −03:00 | −02:00 |
'Asia/Hong_Kong' | +08:00 | +08:00 |
'Asia/Kolkata' | +05:30 | +05:30 |
'Asia/Tokyo' | +09:00 | +09:00 |
'Australia/Sydney' | +10:00 | +11:00 |
'Europe/London' | +00:00 | +01:00 |
'Europe/Zurich' | +01:00 | +02:00 |
Массивы datetime без заданного TimeZone
не может быть сравнен или объединен с массивами, которые имеют их TimeZone
набор свойств к определенному часовому поясу.
Типы данных: char |
string
'Categories'
— Ожидаемые категорииОжидаемые категории в виде массива ячеек из символьных векторов или массива строк, содержащего список названий категории.
Имена в полях ввода должны совпадать с одним из имен, заданных в Categories
свойство избежать ошибки преобразования.
Пример: varOpts.Categories = {'BareLand','Forest','Water','Roads','Buildings'};
'Protected'
— Индикатор защиты категорииtrue
| false
Индикатор защиты категории в виде логического true
или false
. Категории порядковых категориальных массивов всегда защищаются. Если Ordinal
свойство установлено в true
, затем значение по умолчанию для Protected
true
. В противном случае, значение для Protected
false
. Для получения дополнительной информации о категориальных массивах смотрите categorical
страница ссылки на функцию.
'Ordinal'
— Математический индикатор упорядоченного расположенияfalse
(значение по умолчанию) | true
| 0
| 1
Математический индикатор упорядоченного расположения в виде любого false
TRUE
, 0, или
1
. Для получения дополнительной информации о категориальных массивах смотрите categorical
страница ссылки на функцию.
'InputFormat'
— Формат входного текстаФормат входного текста, представляющего данные о длительности в виде вектора символов или массива строк.
Задайте InputFormat
как любой из следующих форматов, где dd
, hh
, mm
, и ss
представляйте дни, часы, минуты и секунды, соответственно:
'dd:hh:mm:ss'
'hh:mm:ss'
'mm:ss'
'hh:mm'
Любой из первых трех форматов, максимум с девятью S
символы, чтобы указать на цифры доли секунды, такие как 'hh:mm:ss.SSSS'
Пример: varOpts.InputFormat = 'dd:hh:mm:ss'
Типы данных: char |
string
'DurationFormat'
— Формат отображения для данных о длительностиФормат отображения для данных о длительности в виде вектора символов или строкового скаляра.
Для чисел с единицами измерения времени задайте одно из этих значений:
'y'
— Годы фиксированной длины, где 1 год равняется 365,2425 дням
'd'
— Дни фиксированной длины, где 1 день равняется 24 часам
'h'
часы
'm'
минуты
's'
секунды
Для цифрового таймера задайте один из этих форматов:
'dd:hh:mm:ss'
'hh:mm:ss'
'mm:ss'
'hh:mm'
Любой из первых трех форматов, максимум с девятью S
символы, чтобы указать на цифры доли секунды, такие как 'hh:mm:ss.SSSS'
Пример: DurationFormat
может быть любой один номер с единицами измерения времени (такими как 0.5 yr
) или цифровой таймер (такой как 10:30:15
в течение 10 часов, 30 минут и 15 секунд).
Типы данных: char |
string
'DecimalSeparator'
— Символы, разделяющие доли секунды.
(значение по умолчанию) | вектор символов | строковый скалярСимволы, разделяющие доли секунды в виде вектора символов или строкового скаляра. Функция импорта использует DecimalSeparator
свойство отличить целую часть значения длительности от части долей секунды.
Типы данных: char |
string
'FieldSeparator'
— Символы, указывающие на полевое разделение:
(значение по умолчанию) | вектор символов | строковый скалярСимволы, указывающие на полевое разделение в данных о длительности в виде вектора символов или строкового скаляра.
Типы данных: char |
string
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.