Создайте настройки импорта на основе содержимого файла
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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.