Создайте настройки импорта на основе содержимого файла
opts = detectImportOptions(filename)opts = detectImportOptions(filename,Name,Value)определяет местоположение таблицы в файле и возвращает настройки импорта для импорта таблицы. Можно изменить объект опций и использовать его с opts = detectImportOptions(filename) readtable, чтобы управлять, как MATLAB® импортирует табличные данные. Тип возвращенных опций зависит от расширения файла. Например, функция возвращает объект SpreadsheetImportOptions, если filename является файлом электронной таблицы. Однако функция возвращает объект DelimitedTextImportOptions или FixedWidthImportOptions, если filename является текстовым файлом.
определяет местоположение таблицы в файле с помощью дополнительных параметров, заданных одним или несколькими аргументами пары opts = detectImportOptions(filename,Name,Value) Name,Value.
Обнаружьте настройки импорта для файла электронной таблицы, задайте переменные, чтобы импортировать, и затем считать данные.
Создайте объект настроек импорта из файла.
opts = detectImportOptions('patients.xls')opts =
SpreadsheetImportOptions with properties:
Sheet Properties:
Sheet: ''
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
VariableTypes: {'char', 'char', 'double' ... and 7 more}
SelectedVariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
VariableOptions: Show all 10 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
Range Properties:
DataRange: 'A2' (Start Cell)
VariableNamesRange: 'A1'
RowNamesRange: ''
VariableUnitsRange: ''
VariableDescriptionsRange: ''
To display a preview of the table, use preview
Измените объект опций задать который переменные импортировать.
opts.SelectedVariableNames = {'Systolic','Diastolic'};Используйте readtable наряду с объектом опций импортировать заданные переменные.
T = readtable('patients.xls',opts);
summary(T)Variables:
Systolic: 100x1 double
Values:
Min 109
Median 122
Max 138
Diastolic: 100x1 double
Values:
Min 68
Median 81.5
Max 99
Создайте настройки импорта, адаптируйте типы данных для нескольких переменных, и затем считайте данные.
Создайте объект настроек импорта из текстового файла.
opts = detectImportOptions('airlinesmall.csv')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: {'Year', 'Month', 'DayofMonth' ... and 26 more}
VariableTypes: {'double', 'double', 'double' ... and 26 more}
SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
VariableOptions: Show all 29 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
Location Properties:
DataLines: [2 Inf]
VariableNamesLine: 1
RowNamesColumn: 0
VariableUnitsLine: 0
VariableDescriptionsLine: 0
To display a preview of the table, use preview
Исследуйте свойство Type переменных TaxiIn и TaxiOut.
getvaropts(opts,{'TaxiIn','TaxiOut'})ans =
1x2 TextVariableImportOptions array with properties:
WhitespaceRule
Type
FillValue
Name
QuoteRule
TreatAsMissing
Prefixes
Suffixes
EmptyFieldRule
Измените тип переменных TaxiIn и TaxiOut к double.
opts = setvartype(opts,{'TaxiIn','TaxiOut'},'double');Задайте подмножество переменных, чтобы импортировать и исследовать.
opts.SelectedVariableNames = {'TaxiIn','TaxiOut'};Используйте функцию readtable наряду с объектом опций импортировать выбранные переменные. Отобразите сводные данные таблицы.
T = readtable('airlinesmall.csv',opts);
summary(T)Variables:
TaxiIn: 123523x1 double
Values:
Min 0
Median 5
Max 1451
NumMissing 37383
TaxiOut: 123523x1 double
Values:
Min 0
Median 13
Max 755
NumMissing 37364
Импортируйте текстовые данные как тип данных String путем определения настроек импорта.
Создайте объект опций для файла.
opts = detectImportOptions('outages.csv');Задайте который переменные импортировать использование readtable, и затем показать сводные данные. Типом данных выбранных переменных является char.
opts.SelectedVariableNames = {'Region','Cause'};
T = readtable('outages.csv',opts);
summary(T)Variables:
Region: 1468x1 cell array of character vectors
Cause: 1468x1 cell array of character vectors
Импортируйте текстовые данные как тип данных string, и затем создайте настройки импорта путем определения пары "имя-значение" TextType.
opts = detectImportOptions('outages.csv','TextType','string');
Задайте который переменные импортировать использование readtable, и затем показать сводные данные. Типом данных выбранных переменных является теперь string.
opts.SelectedVariableNames = {'Region','Cause'};
T = readtable('outages.csv',opts);
summary(T)Variables:
Region: 1468x1 string
Cause: 1468x1 string
fileName Имя файла, чтобы читатьИмя файла, чтобы читать, заданный как вектор символа или представить скаляр в виде строки. Если filename включает расширение файла, то detectImportOptions определяет формат файла от расширения. В противном случае необходимо задать пару "имя-значение" 'FileType', чтобы указать на тип файла.
В зависимости от местоположения вашего файла filename может взять одну из следующих форм.
Местоположение | Форма |
|---|---|
Файл в папке | Если файл не находится в текущей папке или в папке на пути MATLAB, задайте полное имя или относительный путь. Пример:
Пример:
|
Удаленное местоположение (Amazon S3™, устройство хранения данных Windows Azure® Blob и HDFS™) | Если файл хранится в удаленном местоположении, то
Для получения дополнительной информации смотрите работу с Удаленными данными. Пример:
|
Функция detectImportOptions поддерживает эти расширения файла: txt dat, .csv, .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx и .ods.
'FileExtensions' . xlsb и .ods только поддержаны на платформах с Excel® для Windows®.
Типы данных: char | string
Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.
'Тип файла', 'текст'FileType Тип файла'text' | 'spreadsheet'Тип файла, заданного как пара, разделенная запятой, состоящая из 'FileType' и или 'text' или 'spreadsheet'.
Задайте аргумент в виде пар "имя-значение" 'FileType', когда filename не включает расширение файла или если расширение отличается от одного из них:
txt dat или .csv для файлов разделенного текста
.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx или .ods для файлов электронной таблицы
'FileExtensions' . xlsb и .ods только поддержаны на платформах с Excel для Windows.
Пример: 'Тип файла', 'текст'
Типы данных: char | string
TextType Введите для данных импортируемого текста 'char' (значение по умолчанию) | 'string'Введите для данных импортируемого текста, заданных как пара, разделенная запятой, состоящая из 'TextType' и или 'char' или 'string'.
'char' Импортируйте текстовые данные в MATLAB как векторы символов.
Строка Импортируйте текстовые данные в MATLAB как массивы строк.
Пример: 'TextType', 'char'
'DatetimeType' Введите для импортированных данных даты и времени'datetime' (значение по умолчанию) | 'text' | 'exceldatenum' (только файлы электронной таблицы)Введите для импортированных данных даты и времени, заданных как пара, разделенная запятой, состоящая из 'DatetimeType' и одно из следующего: 'datetime', 'text' или 'exceldatenum'. Значение 'exceldatenum' только применим для файлов электронной таблицы и не позволен для текстовых файлов.
| Значение | Введите для данных даты и времени |
|---|---|
datetime | MATLAB тип данных Для получения дополнительной информации смотрите |
Текст |
|
'exceldatenum' | Excel последовательные числа даты Последовательный номер даты является единственным номером, равным номеру дней с данной ссылочной даты. Excel последовательные числа даты использует различную ссылочную дату, чем MATLAB последовательные числа даты. Для получения дополнительной информации о датах Excel смотрите |
Пример: 'DatetimeType', 'текст'
Типы данных: char | string
'NumVariables' Ожидаемое количество переменныхОжидаемое количество переменных, заданных как пара, разделенная запятой, состоящая из 'NumVariables' и положительного целого числа. Если незаданный, функция импорта автоматически обнаруживает количество переменных.
Пример: 'NumVariables', 10
Типы данных: single | double
NumHeaderLines Количество строк заголовкаКоличество строк заголовка в файле, заданном как пара, разделенная запятой, состоящая из 'NumHeaderLines' и положительного целого числа. Если незаданный, функция импорта автоматически обнаруживает количество строк заголовка в файле.
Пример: 'NumHeaderLines', 7
Типы данных: single | double
'Sheet' — Покройте, чтобы читать из'' пустой символьный массив (значение по умолчанию) | вектор символа | представляет скаляр в виде строки | положительное скалярное целое числоПокройте, чтобы читать из, заданный как пустой символьный массив, вектор символа или представить в виде строки скаляр, содержащий имя листа или положительное скалярное целое число, обозначающее индекс листа. На основе значения, заданного для свойства Sheet, функция импорта ведет себя, как описано в таблице.
| Спецификация | Поведение |
|---|---|
'' (значение по умолчанию) | Импортируйте данные от первого листа. |
| имя | Импортируйте данные с соответствующего имени листа, независимо от порядка листов в файле электронной таблицы. |
| целое число | Импортируйте данные от листа в положении, обозначенном целым числом, независимо от имен листа в файле электронной таблицы. |
Пример: 'Sheet7'
Пример 7
Типы данных: char | представляет в виде строки | единственный | дважды
Область значений Фрагмент рабочего листа, чтобы читатьФрагмент рабочего листа, чтобы читать, обозначенный как прямоугольная область, заданная запятой разделенная пара, состоящая из 'Range' и вектора символа или представить скаляр в виде строки в одной из следующих форм.
Способы задать Range | Описание |
|---|---|
Прямоугольная область значений | Задайте область значений с помощью синтаксиса Пример: |
Незаданный или пустой | Если незаданный, функция импорта автоматически обнаруживает используемую область значений. Пример: Примечание: Используемая Область значений относится к прямоугольному фрагменту электронной таблицы, которая на самом деле содержит данные. Функция импорта автоматически обнаруживает используемую область значений путем обрезки любого продвижения и запаздывающих строк и столбцов, которые не содержат данные. Текст, который является только пробелом, рассматривается данными и получен в используемой области значений. |
Область значений строки | Можно идентифицировать область значений путем определения начала и конечного использования строк указатели строки Excel. Затем Пример: |
Область значений столбца | Можно идентифицировать область значений путем определения начала и конечного использования столбцов указатели столбца Excel. Затем Пример: |
Именованная область значений Excel | В Excel можно создать имена, чтобы идентифицировать области значений в электронной таблице. Например, можно выбрать прямоугольный фрагмент электронной таблицы и вызвать ее Пример: |
Типы данных: char | string
'Delimiter' — Символы разделителя полейСимволы разделителя полей, заданные как вектор символа, представляют в виде строки скаляр, массив ячеек из символьных векторов или массив строк.
Пример: '|'
Пример: {';' ',* '}
Типы данных: char | представляет в виде строки | ячейка
'Whitespace' — Символы, чтобы обработать как пробелСимволы, чтобы обработать как пробел, заданный как вектор символа или представить в виде строки скаляр, содержащий один или несколько символов.
Пример: '_'
Пример:'?!.',
'LineEnding' Символы конца строки{'\n','\r','\r\n'} (значение по умолчанию) | вектор символа | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строкСимволы конца строки, заданные как вектор символа, представляют в виде строки скаляр, массив ячеек из символьных векторов или массив строк.
Пример: N
Пример: '\r\n'
Пример: B:'}
Типы данных: char | представляет в виде строки | ячейка
'Encoding' — Схема кодировки символов'UTF-8' | 'ISO-8859-1' | 'windows-1251' | 'windows-1252' |...Схема кодировки символов, сопоставленная с файлом, заданным как пара, разделенная запятой, состоящая из 'Encoding' и 'system' или схемы кодирования стандартного символа, называет как одно из значений в этой таблице.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
|
Пример: 'система' использует кодирование системного значения по умолчанию.
Типы данных: char | string
CommentStyle Стиль комментариевСтиль комментариев, заданных как вектор символа, представляет в виде строки скаляр, массив ячеек из символьных векторов или массив строк.
Например, чтобы проигнорировать текст после знака процента на той же строке, задайте CommentStyle как '%'.
Пример: {'/*'}
Типы данных: char | представляет в виде строки | ячейка
'DurationType' — Тип выходных данных данных длительности'duration' (значение по умолчанию) | 'text'Тип выходных данных данных длительности от текстовых файлов, заданных как пара, разделенная запятой, состоящая из 'DurationType' и или 'duration' или 'text'.
| Значение | Введите для импортированных данных длительности |
|---|---|
длительность |
MATLAB тип данных Для получения дополнительной информации смотрите |
Текст |
Если
|
Типы данных: char | string
opts — Настройки импорта для файлаSpreadsheetImportOptions | DelimitedtextImportOptions | FixedWidthImportOptionsНастройки импорта для заданного файла, возвращенного как объект SpreadsheetImportOptions или объект DelimitedTextImportOptions. Тип объекта опций зависит от типа заданного файла. Для текстовых файлов (.txt txt . dat или .csv), функция detectImportOptions возвращает объект DelimitedTextImportOptions или FixedWidthImportOptions. Для файлов электронной таблицы (.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx или .ods), функция detectImportOptions возвращает объект SpreadsheetImportOptions.
На основе содержимого заданного файла функция detectImportOptions автоматически обнаруживает и устанавливает эти параметры.
| Для файлов электронной таблицы | Для текстовых файлов |
|---|---|
VariableNames (если таковые имеются) | VariableNames (если таковые имеются) |
VariableTypes | VariableTypes |
DataRange | DataLine |
VariableNamesRange | VariableNamesLine |
Delimiter | |
LeadingDelimitersRule (если пробел является разделителем), | |
ConsecutiveDelimitersRule (если пробел является разделителем), | |
PartialFieldRule (для файлов фиксированной ширины) |
DelimitedTextImportOptions | FixedWidthImportOptions | SpreadsheetImportOptions | readtable
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.