Настройки импорта возражают для разделенного текста
DelimitedTextImportOptions
объект позволяет вам задать, как MATLAB® импортирует табличные данные из файлов разделенного текста. Объект содержит свойства, которые управляют процессом импорта данных, включая обработку ошибок и недостающих данных.
Можно создать DelimitedTextImportOptions
объект с помощью любого detectImportOptions
функционируйте или delimitedTextImportOptions
функция (описанный здесь):
Используйте detectImportOptions
обнаружить и заполнить свойства импорта на основе содержимого файла разделенного текста, заданного в filename
.
opts = detectImportOptions(filename);
Используйте delimitedTextImportOptions
задавать свойства импорта на основе ваших требований импорта.
opts = delimitedTextImportOptions
создает DelimitedTextImportOptions
объект с одной переменной.
opts = delimitedTextImportOptions('NumVariables',
создает объект с количеством переменных, заданных в numVars
)numVars
.
opts = delimitedTextImportOptions(___,
задает дополнительные свойства для Name,Value
)DelimitedTextImportOptions
объект с помощью одного или нескольких аргументов пары "имя-значение".
numVars
— Количество переменныхКоличество переменных в виде положительного скалярного целого числа.
VariableNames
Имена переменныхИмена переменных в виде массива ячеек из символьных векторов или массива строк. VariableNames
свойство содержит имена, чтобы использовать при импорте переменных.
Если данные содержат N
переменные, но никакие имена переменных обнаруживаются, затем VariableNames
свойство содержит {'Var1','Var2',...,'VarN'}
.
Чтобы поддержать недопустимые идентификаторы MATLAB как, имена переменных, такие как имена переменных, содержащие пробелы и символы non-ASCII, устанавливают значение VariableNamingRule
к 'preserve'
.
Пример: opts.VariableNames
возвращает текущие (обнаруженные) имена переменных.
Пример: opts.VariableNames(3) = {'Height'}
изменяет название третьей переменной к Height
.
Типы данных: char |
string
| cell
VariableNamingRule
— Отметьте, чтобы сохранить имена переменных'modify'
(значение по умолчанию) | 'preserve'
Отметьте, чтобы сохранить имена переменных в виде разделенной запятой пары, состоящей из VariableNamingRule
и любой true
, или false
.
'preserve'
— Сохраните имена переменных, которые не являются допустимыми идентификаторами MATLAB, такими как имена переменных, которые включают символы non-ASCII и пробелы.
'modify'
— Преобразуйте недопустимые имена переменных (как определено isvarname
функция) к допустимым идентификаторам MATLAB.
Начиная в R2019b, имена переменных и имена строки могут включать любые символы, включая символы non-ASCII и пробелы. Кроме того, они могут начать с любых символов, не только обозначает буквами. Переменная и имена строки не должны быть допустимыми идентификаторами MATLAB (как определено isvarname
функция. Чтобы сохранить эти имена переменных и имена строки, установите значение VariableNamingRule
к 'preserve'
.
Типы данных: char |
string
VariableTypes
— Типы данных переменныхТипы данных переменных в виде массива ячеек из символьных векторов или массива строк. VariableTypes
свойство определяет типы данных использовать при импорте переменных. При присвоении новых значений задайте VariableTypes
как массив ячеек допустимых имен типов данных.
Обновить VariableTypes
свойство, используйте setvartype
функция.
Пример: opts.VariableTypes
возвращает текущие (обнаруженные) типы данных переменных.
Пример: opts = setvartype(opts,'Height',{'double'})
изменяет тип данных переменной Height
к double
.
Типы данных: cell
| single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
| char
| string
| categorical
| datetime
SelectedVariableNames
— Подмножество переменных, чтобы импортироватьПодмножество переменных, чтобы импортировать в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов, массива строк или массива числовых индексов.
SelectedVariableNames
должно быть подмножество имен, содержавшихся в VariableNames
свойство. По умолчанию, SelectedVariableNames
содержит все имена переменных от VariableNames
свойство, что означает, что все переменные импортируются.
Используйте SelectedVariableNames
свойство импортировать только переменные интереса. Задайте подмножество переменных с помощью SelectedVariableNames
свойство и использование readtable
импортировать только то подмножество.
Чтобы поддержать недопустимые идентификаторы MATLAB как, имена переменных, такие как имена переменных, содержащие пробелы и символы non-ASCII, устанавливают значение VariableNamingRule
к 'preserve'
.
Пример: opts.SelectedVariableNames = {'Height','LastName'}
выбирает только две переменные, Height
и LastName
, для операции импорта.
Пример: opts.SelectedVariableNames = [1 5]
выбирает только две переменные, первую переменную и пятую переменную, для операции импорта.
Пример: T = readtable(filename,opts)
возвращает таблицу, содержащую только переменные, заданные в SelectedVariableNames
свойство opts
объект.
Типы данных: uint16
| uint32
| uint64
| char
| string
| cell
VariableOptions
— Введите определенные переменные настройки импортаВведите определенные переменные настройки импорта, возвращенные как массив переменных объектов настроек импорта. Массив содержит объект, соответствующий каждой переменной, заданной в VariableNames
свойство. Каждый объект в массиве содержит свойства, которые поддерживают импорт данных с определенным типом данных.
Параметры переменной поддерживают эти типы данных: числовой, текст, logical
datetime
, или categorical
.
Чтобы запросить ток (или обнаруженный) опции для переменной, используйте getvaropts
функция.
Чтобы установить и настроить опции для переменной, используйте setvaropts
функция.
Пример: opts.VariableOptions
возвращает набор VariableImportOptions
объекты, одно соответствие каждой переменной в данных.
Пример: getvaropts(opts,'Height')
возвращает VariableImportOptions
объект для Height
переменная.
Пример: opts = setvaropts(opts,'Height','FillValue',0)
устанавливает FillValue
свойство для переменной Height
к 0
.
DataLines
— Местоположение данныхМестоположение данных в виде положительного скалярного целого числа или N-
by-2
массив положительных скалярных целых чисел. Задайте DataLines
использование одной из следующих форм.
Задайте как |
Описание |
---|---|
|
Задайте первую линию, которая содержит данные. Определение значения с помощью
|
| Укажите диапазон линии, который содержит данные. Значения в массиве |
|
Укажите несколько диапазонов линии, чтобы читать с Допустимый массив нескольких областей значений линии должен:
При указывании нескольких диапазонов линии используйте |
Пример: opts.DataLines = 5
устанавливает DataLines
свойство к значению [5 inf]
. Считайте все строки данных, начинающих со строки 5
до конца файла.
Пример: opts.DataLines = [2 6]
устанавливает свойство прочитать строки 2
через 6
.
Пример: opts.DataLines = [1 3; 5 6; 8 inf]
устанавливает свойство считать строки 1
, 2, 3
, 5
, 6
, и все строки между
8
, и конец файла.
Типы данных: single
| double
| uint8
| uint16
| uint32
| uint64
RowNamesColumn
— Строка называет местоположение
(значение по умолчанию) | положительное скалярное целое числоСтрока называет местоположение в виде положительного скалярного целого числа. RowNamesColumn
свойство задает местоположение столбца, содержащего имена строки.
Если RowNamesColumn
задан как 0, затем не импортируйте имена строки. В противном случае импортируйте имена строки из заданного столбца.
Пример: opts.RowNamesColumn = 2;
Типы данных: single
| double
| uint8
| uint16
| uint32
| uint64
VariableNamesLine
— Местоположение имен переменных
(значение по умолчанию) | положительное скалярное целое числоМестоположение имен переменных в виде положительного скалярного целого числа. VariableNamesLine
свойство задает номер строки, где имена переменных расположены.
Если VariableNamesLine
задан как 0, затем не импортируйте имена переменных. В противном случае импортируйте имена переменных из заданной линии.
Пример: opts.VariableNamesLine = 6;
Типы данных: single
| double
| uint8
| uint16
| uint32
| uint64
VariableDescriptionsLine
— Местоположение описания переменной
(значение по умолчанию) | положительное скалярное целое числоМестоположение описания переменной в виде положительного скалярного целого числа. VariableDescriptionsLine
свойство задает номер строки, где описания переменной расположены.
Если VariableDescriptionsLine
задан как 0, затем не импортируйте описания переменной. В противном случае импортируйте описания переменной из заданной линии.
Пример: opts.VariableDescriptionsLine = 7;
Типы данных: single
| double
| uint8
| uint16
| uint32
| uint64
VariableUnitsLine
— Переменное модульное местоположение
(значение по умолчанию) | положительное скалярное целое числоПеременное модульное местоположение в виде положительного скалярного целого числа. VariableUnitsLine
свойство задает номер строки, где переменные модули расположены.
Если VariableUnitsLine
задан как 0, затем не импортируйте переменные модули. В противном случае импортируйте переменные модули из заданной линии.
Пример: opts.VariableUnitsLine = 8;
Типы данных: single
| double
| uint8
| uint16
| uint32
| uint64
Delimiter
— Символы разделителя полейСимволы разделителя полей в файле разделенного текста в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.
Пример: 'Delimiter','|'
Пример: 'Delimiter',{';','*'}
Типы данных: char |
string
| cell
Whitespace
— Символы, чтобы обработать как пробелСимволы, чтобы обработать как пробел в виде вектора символов или строкового скаляра, содержащего один или несколько символов.
Пример: 'Whitespace',' _'
Пример: 'Whitespace','?!.,'
LineEnding
— Символы конца линии{'\n','\r','\r\n'}
(значение по умолчанию) | вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строкСимволы конца линии в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.
Пример: 'LineEnding','\n'
Пример: 'LineEnding','\r\n'
Пример: 'LineEnding',{'\b',':'}
Типы данных: char |
string
| cell
CommentStyle
— Стиль комментариевСтиль комментариев в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.
Например, чтобы проигнорировать текст после знака процента на той же линии, задайте CommentStyle
как '%'
.
Пример: 'CommentStyle',{'/*'}
Типы данных: char |
string
| cell
ConsecutiveDelimitersRule
— Процедура, чтобы обработать последовательные разделители'split'
| 'join'
| 'error'
Процедура, чтобы обработать последовательные разделители в файле разделенного текста в виде одного из значений в этой таблице.
ConsecutiveDelimitersRule | Поведение |
---|---|
'split' | Разделите последовательные разделители в несколько полей. |
'join' | Соедините разделители в один разделитель. |
'error' | Возвратите ошибку и прервите операцию импорта. |
Типы данных: char |
string
LeadingDelimitersRule
— Процедура, чтобы управлять ведущими разделителями'keep'
| 'ignore'
| 'error'
Процедура, чтобы управлять ведущими разделителями в файле разделенного текста в виде одного из значений в этой таблице.
LeadingDelimitersRule | Поведение |
---|---|
'keep' | Сохраните разделитель. |
'ignore' | Проигнорируйте разделитель. |
'error' | Возвратите ошибку и прервите операцию импорта. |
TrailingDelimitersRule
— Процедура, чтобы справиться с запаздыванием разделителей'keep'
| 'ignore'
| 'error'
Процедура, чтобы справиться с запаздыванием разделителей в файле разделенного текста в виде одного из значений в этой таблице.
LeadingDelimitersRule | Поведение |
---|---|
'keep' | Сохраните разделитель. |
'ignore' | Проигнорируйте разделитель. |
'error' | Возвратите ошибку и прервите операцию импорта. |
Encoding
— Схема кодировки символов''
| 'UTF-8'
| 'system'
| 'ISO-8859-1'
| 'windows-1251'
| 'windows-1252'
| ...Схема кодировки символов, сопоставленная с файлом в виде разделенной запятой пары, состоящей из 'Encoding'
и 'system'
или имя схемы кодирования стандартного символа.
Когда вы не задаете кодирования, функция использует автоматическое обнаружение набора символов, чтобы определить кодирование при чтении файла.
Пример: 'Encoding','system'
использует кодирование системного значения по умолчанию.
Типы данных: char |
string
MissingRule
— Процедура, чтобы управлять недостающими данными'fill'
| 'error'
| 'omitrow'
| 'omitvar'
Процедура, чтобы управлять недостающими данными в виде одного из значений в этой таблице.
MissingRule | Поведение |
---|---|
'fill' | Замените недостающие данные на содержимое
|
'error' | Прекратите импортировать и отобразите сообщение об ошибке, показывающее недостающую запись и поле. |
'omitrow' | Не используйте строки, которые содержат недостающие данные. |
'omitvar' | Не используйте переменные, которые содержат недостающие данные. |
Пример: opts.MissingRule = 'omitrow';
Типы данных: char |
string
EmptyLineRule
— Процедура, чтобы обработать пустые линии'skip'
| 'read'
| 'error'
Процедура, чтобы обработать пустые линии в данных в виде 'skip'
чтение
, или 'error'
. Функция импорта интерпретирует пробел как пустой.
EmptyLineRule | Поведение |
---|---|
'skip' | Пропустите пустые линии. |
'read' | Импортируйте пустые линии. Функция импорта анализирует пустую линию с помощью значений, заданных в VariableWidths VariableOptions MissingRule , и другие соответствующие свойства, такие как Whitespace . |
'error' | Отобразите сообщение об ошибке и прервите операцию импорта. |
Пример: opts.EmptyLineRule = 'skip';
Типы данных: char |
string
ImportErrorRule
— Процедура, чтобы обработать ошибки импорта'fill'
| 'error'
| 'omitrow'
| 'omitvar'
Процедура, чтобы обработать ошибки импорта в виде одного из значений в этой таблице.
ImportErrorRule | Поведение |
---|---|
'fill' | Замените данные, где ошибка произошла с содержимым
|
'error' | Прекратите импортировать и отобразите сообщение об ошибке, показывающее вызывающую ошибку запись и поле. |
'omitrow' | Не используйте строки, где ошибки происходят. |
'omitvar' | Не используйте переменные, где ошибки происходят. |
Пример: opts.ImportErrorRule = 'omitvar';
Типы данных: char |
string
ExtraColumnsRule
— Процедура, чтобы обработать дополнительные столбцы'addvars'
| 'ignore'
| 'wrap'
| 'error'
Процедура, чтобы обработать дополнительные столбцы в данных в виде одного из значений в этой таблице.
ExtraColumnsRule | Поведение |
---|---|
'addvars' | Чтобы импортировать дополнительные столбцы, создайте новые переменные. Если существует ПРИМЕЧАНИЕ: дополнительные столбцы импортируются как текст с данными type |
'ignore' | Проигнорируйте дополнительные столбцы данных. |
'wrap' | Перенесите дополнительные столбцы данных к новым записям. Это действие не изменяет количество переменных. |
'error' | Отобразите сообщение об ошибке и прервите операцию импорта. |
Типы данных: char |
string
getvaropts | Получите переменные настройки импорта |
setvaropts | Установите переменные настройки импорта |
setvartype | Установите типы данных переменных |
preview | Предварительный просмотр восьми строк из файла с помощью параметров импорта |
Задайте объект настроек импорта считать несколько переменных из patients.dat
.
На основе содержимого вашего файла задайте эти переменные свойства: имена, типы, символ-разделитель, данные стартовое местоположение и правило дополнительного столбца.
varNames = {'LastName','Gender','Age','Location','Height','Weight','Smoker'} ; varTypes = {'char','categorical','int32','char','double','double','logical'} ; delimiter = ','; dataStartLine = 2; extraColRule = 'ignore';
Используйте delimitedTextImportOptions
функционируйте и ваша переменная информация, чтобы инициализировать объект opts
настроек импорта.
opts = delimitedTextImportOptions('VariableNames',varNames,... 'VariableTypes',varTypes,... 'Delimiter',delimiter,... 'DataLines', dataStartLine,... 'ExtraColumnsRule',extraColRule);
Используйте preview
функция с настройками импорта возражает, чтобы предварительно просмотреть данные.
preview('patients.dat',opts)
ans=8×7 table
LastName Gender Age Location Height Weight Smoker
____________ ______ ___ _____________________________ ______ ______ ______
{'Smith' } Male 38 {'County General Hospital' } 71 176 false
{'Johnson' } Male 43 {'VA Hospital' } 69 163 false
{'Williams'} Female 38 {'St. Mary's Medical Center'} 64 131 false
{'Jones' } Female 40 {'VA Hospital' } 67 133 false
{'Brown' } Female 49 {'County General Hospital' } 64 119 false
{'Davis' } Female 46 {'St. Mary's Medical Center'} 68 142 false
{'Miller' } Female 33 {'VA Hospital' } 64 142 false
{'Wilson' } Male 40 {'VA Hospital' } 68 180 false
Импортируйте данные с помощью readtable
.
T = readtable('patients.dat',opts); whos T
Name Size Bytes Class Attributes T 100x7 30564 table
Введенный в:
R2016b DelimitedTextImportOptions
объект
R2018b — delimitedTextImportOptions
функция
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.