Считайте массив ячеек из файла
C = readcell(filename)
C = readcell(filename,opts)
C = readcell(___,Name,Value)
C = readcell(
создает массив ячеек путем чтения данных в столбцах из файла.filename
)
readcell
определяет формат файла от расширения файла:
.txt
, .dat
или .csv
для файлов разделенного текста
.xls
, .xlsb
, .xlsm
, .xlsx
, .xltm
, .xltx
или .ods
для файлов электронной таблицы
C = readcell(___,
создает массив ячеек из файла с дополнительными опциями, заданными одним или несколькими аргументами пары "имя-значение". Используйте любой из входных параметров от предыдущих синтаксисов прежде, чем задать пары "имя-значение".Name,Value
)
Чтобы установить определенные настройки импорта для ваших данных, можно или использовать объект opts
, или можно задать пары "имя-значение". Когда вы задаете пары "имя-значение" в дополнение к opts
, затем readcell
поддерживает только эти пары "имя-значение":
Текстовые файлы — DateLocale
, Encoding
Файлы электронной таблицы — Sheet
, UseExcel
Отобразите содержимое basic_cell.txt
, и затем импортируйте смешанные данные в массив ячеек.
type basic_cell.txt
1,2,3 hello,world,NaN 10-Oct-2018 10:27:56,1,
C = readcell('basic_cell.txt')
C = 3x3 cell array
{[ 1]} {[ 2]} {[ 3]}
{'hello' } {'world'} {[ NaN]}
{[10-Oct-2018 10:27:56]} {[ 1]} {1x1 missing}
Импортируйте смешанные табличные данные от basic_cell.xls
в массив ячеек.
C = readcell('basic_cell.xls')
C = 3x3 cell array
{[ 1]} {[ 2]} {[ 3]}
{'hello' } {'world'} {1x1 missing}
{[10-Oct-2018 10:27:56]} {[ 1]} {1x1 missing}
Предварительно просмотрите данные из файла электронной таблицы и импортируйте смешанные данные в массив ячеек от заданного листа и области значений.
Файл электронной таблицы airlinesmall_subset.xlsx
содержит данные в нескольких рабочих листах в течение многих лет между 1 996 и 2008. Каждый рабочий лист имеет данные в течение данного года. Предварительно просмотрите данные из файла airlinesmall_subset.xlsx
. Функция preview
показывает данные из из первого рабочего листа по умолчанию.
opts = detectImportOptions('airlinesmall_subset.xlsx'); preview('airlinesmall_subset.xlsx',opts)
ans=8×29 table
Year Month DayofMonth DayOfWeek DepTime CRSDepTime ArrTime CRSArrTime UniqueCarrier FlightNum TailNum ActualElapsedTime CRSElapsedTime AirTime ArrDelay DepDelay Origin Dest Distance TaxiIn TaxiOut Cancelled CancellationCode Diverted CarrierDelay WeatherDelay SDelay SecurityDelay LateAircraftDelay
____ _____ __________ _________ _______ __________ _______ __________ _____________ _________ ________ _________________ ______________ _______ ________ ________ ______ _____ ________ ______ _______ _________ ________________ ________ ____________ ____________ ______ _____________ _________________
1996 1 18 4 2117 2120 2305 2259 'HP' 415 'N637AW' 108 99 85 6 -3 'COS' 'PHX' 551 5 18 0 '' 0 '' '' '' '' ''
1996 1 12 5 1252 1245 1511 1500 'HP' 610 'N905AW' 79 75 58 11 7 'LAX' 'PHX' 370 3 18 0 '' 0 '' '' '' '' ''
1996 1 16 2 1441 1445 1708 1721 'HP' 211 'N165AW' 87 96 74 -13 -4 'RNO' 'PHX' 601 4 9 0 '' 0 '' '' '' '' ''
1996 1 1 1 2258 2300 2336 2335 'HP' 1245 'N183AW' 38 35 20 1 -2 'TUS' 'PHX' 110 6 12 0 '' 0 '' '' '' '' ''
1996 1 4 4 1814 1814 1901 1910 'US' 683 'N963VJ' 47 56 34 -9 0 'DTW' 'PIT' 201 6 7 0 '' 0 '' '' '' '' ''
1996 1 31 3 1822 1820 1934 1925 'US' 757 'N912VJ' 72 65 52 9 2 'PHL' 'PIT' 267 6 14 0 '' 0 '' '' '' '' ''
1996 1 18 4 729 730 841 843 'US' 1564 'N941VJ' 72 73 58 -2 -1 'DCA' 'PVD' 357 3 11 0 '' 0 '' '' '' '' ''
1996 1 26 5 1704 1705 1829 1839 'NW' 1538 'N960N' 85 94 69 -10 -1 'DTW' 'RIC' 456 3 13 0 '' 0 '' '' '' '' ''
Импортируйте десять строк данных для переменных 7
, 8
и 9
из рабочего листа под названием '2007'
. Область значений Excel 'G2:I11'
представляет столбцы 7
через 9
и десять строк, запускающихся в строке 2
после имен переменных.
M = readcell('airlinesmall_subset.xlsx','Sheet','2007','Range','G2:I11')
M = 10x3 cell array
{[ 935]} {[ 935]} {'WN'}
{[1041]} {[1040]} {'WN'}
{[1430]} {[1500]} {'WN'}
{[ 940]} {[ 950]} {'WN'}
{[1515]} {[1515]} {'WN'}
{[2042]} {[2035]} {'WN'}
{[2116]} {[2130]} {'WN'}
{[1604]} {[1605]} {'WN'}
{[1258]} {[1230]} {'WN'}
{[1134]} {[1145]} {'WN'}
fileName
Имя файла, чтобы читатьИмя файла, чтобы читать, заданный как вектор символов или скаляр строки.
В зависимости от местоположения вашего файла filename
может взять одну из следующих форм.
Местоположение | Форма | ||||||||
---|---|---|---|---|---|---|---|---|---|
Текущая папка или папка на пути MATLAB® | Задайте имя файла в Пример: | ||||||||
Файл в папке | Если файл не находится в текущей папке или в папке на пути MATLAB, то задайте полное имя или относительный путь в Пример:
Пример:
| ||||||||
Удаленное местоположение | Если файл хранится в удаленном местоположении, то
На основе вашего удаленного местоположения
Для получения дополнительной информации смотрите работу с Удаленными данными. Пример: |
Если filename
включает расширение файла, то функция импорта определяет формат файла от расширения. В противном случае необходимо задать аргументы пары "имя-значение" 'FileType'
, чтобы указать на тип файла.
В системах Windows® с программным обеспечением Microsoft® Excel® функция импорта читает любой формат файла электронной таблицы Excel, распознанный вашей версией Excel.
Если ваша система не имеет Excel для Windows или если вы используете MATLAB Online™, функция импорта действует с набором свойств UseExcel
к false
и читает только файлы .xls, .xlsx, .xlsm, .xltx, and .xltm
.
Для файлов разделенного текста функция импорта преобразовывает пустые поля в файле к любому NaN
(для числовой переменной) или пустой символьный вектор (для текстовой переменной). Все строки в текстовом файле должны иметь то же количество разделителей. Функция импорта игнорирует незначительный пробел в файле.
Типы данных: char | string
opts
— Настройки импорта файлаSpreadsheetImportOptions
| DelimitedtextImportOptions
| FixedWidthImportOptions
Настройки импорта файла, заданные как SpreadsheetImportOptions
, DelimitedTextImportOptions
или объект FixedWidthImportOptions
, создаются функцией detectImportOptions
. Объект opts
содержит свойства, которые управляют процессом импорта данных. Для получения дополнительной информации о свойствах каждого объекта смотрите соответствующую объектную страницу.
Тип файлов | Вывод |
---|---|
Файлы электронной таблицы | Объект SpreadsheetImportOptions |
Текстовые файлы | Объект DelimitedTextImportOptions |
Текстовые файлы фиксированной ширины | Объект FixedWidthImportOptions |
Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми.
Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение.
Name
должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.
'NumHeaderLines',5
указывает, что первые пять строк, которые предшествуют табличным данным, являются строками заголовка.FileType
Тип файла'text'
| 'spreadsheet'
Тип файла, заданного как пара, разделенная запятой, состоящая из 'FileType'
и 'text'
или 'spreadsheet'
.
Задайте аргумент пары "имя-значение" 'FileType'
, когда filename
не включает расширение файла или если расширение отличается от одного из следующего:
.txt
, .dat
или .csv
для файлов разделенного текста
.xls
, .xlsb
, .xlsm
, .xlsx
, .xltm
, .xltx
или .ods
для файлов электронной таблицы
Пример: 'FileType','text'
Типы данных: char | string
NumHeaderLines
Количество строк заголовкаКоличество строк заголовка в файле, заданном как пара, разделенная запятой, состоящая из 'NumHeaderLines'
и положительного целого числа. Если незаданный, функция импорта автоматически обнаруживает количество строк заголовка в файле.
Пример: 'NumHeaderLines',7
Типы данных: single | double
'ExpectedNumVariables'
— Ожидаемое количество переменныхОжидаемое количество переменных, заданных как пара, разделенная запятой, состоящая из 'ExpectedNumVariables'
и положительного целого числа. Если незаданный, функция импорта автоматически обнаруживает количество переменных.
Типы данных: single | double
Область значений
Фрагмент данных, чтобы читатьФрагмент данных, чтобы читать из текста или файлов электронной таблицы, заданных как запятая разделенная пара, состоящая из 'Range'
и вектора символов, представляет в виде строки скаляр или числовой вектор в одной из следующих форм.
Способы задать Range | Описание |
---|---|
Запуск ячейки
| Задайте стартовую ячейку для данных как вектор символов или представьте в виде строки скаляр или два элемента числовой вектор.
Используя стартовую ячейку, функция импорта автоматически обнаруживает степень данных путем начала импорта в ячейке запуска и окончания в последней пустой строке или области значений нижнего колонтитула. Пример:
|
Прямоугольная область значений
| Задайте точную область значений, чтобы считать использование прямоугольной области значений в одной из следующих форм.
Функция импорта только считывает данные, содержавшиеся в заданной области значений. Любые пустые поля в заданной области значений импортируются как недостающие ячейки. |
Область значений строки или область значений столбца
| Задайте область значений путем идентификации начала и конечного использования строк номера строк Excel. Используя заданную область значений строки, функция импорта автоматически обнаруживает степень столбца путем чтения из первого непустого столбца в конец данных и создает одну переменную для каждого столбца. Пример:
Также задайте область значений путем идентификации начала и конечного использования столбцов буквы столбца Excel или числа. Используя заданную область значений столбца, функция импорта автоматически обнаруживает степень строки путем чтения из первой непустой строки в конец данных или области значений нижнего колонтитула. Количество столбцов в заданной области значений должно совпадать с номером, заданным в свойстве Пример:
|
Запуск номера строки
| Задайте первую строку, содержащую данные с помощью индекса строки положительной скалярной величины. Используя заданный индекс строки, функция импорта автоматически обнаруживает степень данных путем чтения из заданной первой строки в конец данных или области значений нижнего колонтитула. Пример 5 |
Именованная область значений Excel
| В Excel можно создать имена, чтобы идентифицировать области значений в электронной таблице. Например, можно выбрать прямоугольный фрагмент электронной таблицы и вызвать ее Пример:
|
Незаданный или пустой
| Если незаданный, функция импорта автоматически обнаруживает используемую область значений. Пример:
Примечание: Используемая Область значений относится к прямоугольному фрагменту электронной таблицы, которая на самом деле содержит данные. Функция импорта автоматически обнаруживает используемую область значений путем обрезки любого продвижения и запаздывающих строк и столбцов, которые не содержат данные. Текст, который является только пробелом, рассматривается данными и получен в используемой области значений. |
Типы данных: char
| string
| double
TextType
Введите для данных об импортируемом тексте 'char'
(значение по умолчанию) | 'string'
Введите для данных об импортируемом тексте, заданных как пара, разделенная запятой, состоящая из 'TextType'
и или 'char'
или 'string'
.
'char'
Импортируйте текстовые данные в MATLAB как векторы символов.
Строка
Импортируйте текстовые данные в MATLAB как строковые массивы.
Пример: 'TextType','char'
'DatetimeType'
Введите для импортированных данных о дате и времени'datetime'
(значение по умолчанию) | 'text'
| 'exceldatenum'
(только файлы электронной таблицы)Введите для импортированных данных о дате и времени, заданных как пара, разделенная запятой, состоящая из 'DatetimeType'
и одно из этих значений: 'datetime'
, 'text'
или 'exceldatenum'
. Значение 'exceldatenum'
применим только для файлов электронной таблицы и не допустим для текстовых файлов.
Значение | Введите для импортированных данных о дате и времени |
---|---|
'datetime' | MATLAB тип данных Для получения дополнительной информации смотрите |
'text' | Если
|
'exceldatenum' | Excel последовательные числа даты Последовательный номер даты является одним номером, равным номеру дней с данной ссылочной даты. Excel последовательные числа даты использует различную ссылочную дату, чем MATLAB последовательные числа даты. Для получения дополнительной информации о датах Excel смотрите |
Типы данных: char | string
'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
'Encoding'
— Схема кодировки символов'system'
| 'UTF-8'
| 'ISO-8859-1'
| 'windows-1251'
| 'windows-1252'
|...Схема кодировки символов сопоставлена с файлом, заданным как пара, разделенная запятой, состоящая из 'Encoding'
и 'system'
или имени схемы кодирования стандартного символа, такого как одно из значений в этой таблице.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
|
Пример: 'Encoding','system'
использует кодирование системного значения по умолчанию.
Типы данных: char | string
'DurationType'
— Тип выходных данных данных о длительности'duration'
(значение по умолчанию) | 'text'
Тип выходных данных данных о длительности из текстовых файлов, заданных как пара, разделенная запятой, состоящая из 'DurationType'
и или 'duration'
или 'text'
.
Значение | Введите для импортированных данных о длительности |
---|---|
'duration' | MATLAB тип данных Для получения дополнительной информации смотрите |
'text' | Если
|
Типы данных: char | string
'DateLocale'
Локаль для чтения датЛокаль для чтения дат, заданных как пара, разделенная запятой, состоящая из 'DateLocale'
и вектора символов или скаляра строки формы
, где:xx_YY
YY
является прописной альфой ISO 3166-1 2 кода, указывающие на страну.
xx
является строчный ISO 639-1 двухбуквенный код, указывающий на язык.
Для списка общих ценностей для локали смотрите аргумент пары "имя-значение" Locale
для функции datetime
.
При использовании спецификатора формата %D
, чтобы считать текст как значения datetime
, используйте DateLocale
, чтобы задать локаль, в которой функция импорта должна интерпретировать имена месяца и дня недели и сокращения.
Если вы задаете аргумент DateLocale
в дополнение к opts
настройки импорта, то функция импорта использует заданное значение для аргумента DateLocale
, заменяя локаль, заданную в настройках импорта.
Пример: 'DateLocale','ja_JP'
ConsecutiveDelimitersRule
Процедура, чтобы обработать последовательные разделители'split'
| 'join'
| 'error'
Процедура, чтобы обработать последовательные разделители, заданные как одно из значений в этой таблице.
ConsecutiveDelimitersRule | Поведение |
---|---|
'split' | Разделите последовательные разделители в несколько полей. |
'join' | Соедините разделители в один разделитель. |
'error' | Возвратите ошибку и прервите операцию импорта. |
Типы данных: char | string
LeadingDelimitersRule
Процедура, чтобы управлять ведущими разделителями'keep'
| 'ignore'
| 'error'
Процедура, чтобы управлять ведущими разделителями, заданными как одно из значений в этой таблице.
LeadingDelimitersRule | Поведение |
---|---|
'keep' | Сохраните разделитель. |
'ignore' | Проигнорируйте разделитель. |
'error' | Возвратите ошибку и прервите операцию импорта. |
'Sheet'
— Покройте, чтобы читать из''
пустой символьный массив (значение по умолчанию) | вектор символов | представляет скаляр в виде строки | положительное скалярное целое числоПокройте, чтобы читать из, заданный как пустой символьный массив, вектор символов или представить в виде строки скаляр, содержащий имя листа или положительное скалярное целое число, обозначающее индекс листа. На основе значения, заданного для свойства Sheet
, функция импорта ведет себя, как описано в таблице.
Спецификация | Поведение |
---|---|
'' (значение по умолчанию) | Импортируйте данные от первого листа. |
Имя | Импортируйте данные с соответствующего имени листа, независимо от порядка листов в файле электронной таблицы. |
Целое число | Импортируйте данные от листа в положении, обозначенном целым числом, независимо от имен листа в файле электронной таблицы. |
Типы данных: char
| string
| single
| double
'UseExcel'
— Отметьте, чтобы запустить экземпляр Microsoft Excel для Windowstrue
| false
Отметьте, чтобы запустить экземпляр Microsoft Excel для Windows при чтении данных об электронной таблице, заданных как пара, разделенная запятой, состоящая из 'UseExcel'
и или true
или false
.
Когда чтение из файлов электронной таблицы на платформах Windows, если вы не хотите запускать экземпляр Microsoft Excel, затем установило параметр 'UseExcel'
на false
.
Можно установить параметр 'UseExcel'
на одно из этих значений:
tRUE
Функция импорта запускает экземпляр Microsoft Excel при чтении файла. Эта установка является значением по умолчанию для систем Windows с установленным Excel.
ложь
Функция импорта не запускает экземпляр Microsoft Excel при чтении файла. На Windows без Excel, Mac и Linux®, значением по умолчанию является false
. При работе в этом режиме функциональность функции импорта отличается в поддержку форматов файлов и интерактивных функций, таких как формулы и макросы.
UseExcel |
|
|
---|---|---|
Поддерживаемые форматы файлов |
|
|
Поддержка интерактивных функций, таких как формулы и макросы | Да | Нет |
readmatrix
| readtable
| readtimetable
| readvars
| writecell
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.