Настройки импорта возражают для разделенного текста
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 свойство. Каждый объект в массиве содержит свойства, которые поддерживают импорт данных с определенным типом данных.
Параметры переменной поддерживают эти типы данных: числовой, текст, logicaldatetime, или 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' | Импортируйте пустые линии. Функция импорта анализирует пустую линию с помощью значений, заданных в VariableWidthsVariableOptions 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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.