readmatrix

Считайте матрицу из файла

Синтаксис

A = readmatrix(filename)

A = readmatrix(filename,opts)

A = readmatrix(___,Name,Value)

Описание

A = readmatrix(filename) создает массив путем чтения данных в столбцах из файла. readmatrix функция выполняет автоматическое обнаружение параметров импорта для вашего файла.

readmatrix определяет формат файла из расширения файла:

.txt, .dat, или .csv для файлов разделенного текста
.xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx, или .ods для файлов электронной таблицы

Для файлов, содержащих, смешался числовой и текстовые данные, readmatrix импортирует данные как числовой массив по умолчанию.

пример

A = readmatrix(filename,opts) дополнительно использует настройки импорта opts.

пример

A = readmatrix(___,Name,Value) создает массив из файла с дополнительными опциями, заданными одним или несколькими аргументами пары "имя-значение". Используйте любой из входных параметров от предыдущих синтаксисов прежде, чем задать пары "имя-значение".

Чтобы установить определенные настройки импорта для ваших данных, можно или использовать opts возразите или можно задать пары "имя-значение". Когда вы задаете пары "имя-значение" в дополнение к opts, затем readmatrix поддержки только эти пары "имя-значение":

Текстовые файлы — DateLocale, Encoding
Файлы электронной таблицы — Sheet, UseExcel

Примеры

свернуть все

Считайте матрицу из текстового файла

Скрипт Open Live Script

Отобразите содержимое basic_matrix.txt и затем импортируйте данные в матрицу.

type basic_matrix.txt

6,8,3,1
5,4,7,3
1,6,7,10
4,2,8,2
2,7,5,9

M = readmatrix('basic_matrix.txt')

M = 5×4

     6     8     3     1
     5     4     7     3
     1     6     7    10
     4     2     8     2
     2     7     5     9

Считайте матрицу из файла электронной таблицы

Скрипт Open Live Script

Импортируйте числовые данные от basic_matrix.xls в матрицу.

M = readmatrix('basic_matrix.xls')

M = 5×4

     6     8     3     1
     5     4     7     3
     1     6     7    10
     4     2     8     2
     2     7     5     9

Считайте матрицу из заданного листа и области значений Используя настройки импорта

Скрипт Open Live Script

Предварительно просмотрите данные из файла электронной таблицы и импортируйте числовые данные как матрицу от заданного листа и области значений.

Файл электронной таблицы 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           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          12            5         1252         1245        1511         1500          {'HP'}           610       {'N905AW'}            79                 75            58          11           7       {'LAX'}    {'PHX'}      370         3         18           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          16            2         1441         1445        1708         1721          {'HP'}           211       {'N165AW'}            87                 96            74         -13          -4       {'RNO'}    {'PHX'}      601         4          9           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           1            1         2258         2300        2336         2335          {'HP'}          1245       {'N183AW'}            38                 35            20           1          -2       {'TUS'}    {'PHX'}      110         6         12           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           4            4         1814         1814        1901         1910          {'US'}           683       {'N963VJ'}            47                 56            34          -9           0       {'DTW'}    {'PIT'}      201         6          7           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          31            3         1822         1820        1934         1925          {'US'}           757       {'N912VJ'}            72                 65            52           9           2       {'PHL'}    {'PIT'}      267         6         14           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          18            4          729          730         841          843          {'US'}          1564       {'N941VJ'}            72                 73            58          -2          -1       {'DCA'}    {'PVD'}      357         3         11           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          26            5         1704         1705        1829         1839          {'NW'}          1538       {'N960N' }            85                 94            69         -10          -1       {'DTW'}    {'RIC'}      456         3         13           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}

Сконфигурируйте значения в объекте opts импортировать 10 строки для первых пяти переменных из рабочего листа под названием '2007'.

opts.Sheet = '2007';
opts.SelectedVariableNames = [1:5]; 
opts.DataRange = '2:11';
M = readmatrix('airlinesmall_subset.xlsx',opts)

M = 10×5

        2007           1           2           2         711
        2007           1           3           3         652
        2007           1           4           4        1116
        2007           1           5           5         825
        2007           1           7           7        1411
        2007           1           8           1        1935
        2007           1           9           2        2005
        2007           1          11           4        1525
        2007           1          12           5        1133
        2007           1          13           6         922

Считайте матрицу из заданного листа и области значений

Скрипт Open Live Script

Предварительно просмотрите данные из файла электронной таблицы и импортируйте числовые данные, как матрица, от заданного листа и области значений.

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           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          12            5         1252         1245        1511         1500          {'HP'}           610       {'N905AW'}            79                 75            58          11           7       {'LAX'}    {'PHX'}      370         3         18           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          16            2         1441         1445        1708         1721          {'HP'}           211       {'N165AW'}            87                 96            74         -13          -4       {'RNO'}    {'PHX'}      601         4          9           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           1            1         2258         2300        2336         2335          {'HP'}          1245       {'N183AW'}            38                 35            20           1          -2       {'TUS'}    {'PHX'}      110         6         12           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1           4            4         1814         1814        1901         1910          {'US'}           683       {'N963VJ'}            47                 56            34          -9           0       {'DTW'}    {'PIT'}      201         6          7           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          31            3         1822         1820        1934         1925          {'US'}           757       {'N912VJ'}            72                 65            52           9           2       {'PHL'}    {'PIT'}      267         6         14           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          18            4          729          730         841          843          {'US'}          1564       {'N941VJ'}            72                 73            58          -2          -1       {'DCA'}    {'PVD'}      357         3         11           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}    
    1996      1          26            5         1704         1705        1829         1839          {'NW'}          1538       {'N960N' }            85                 94            69         -10          -1       {'DTW'}    {'RIC'}      456         3         13           0           {0x0 char}          0         {0x0 char}      {0x0 char}     {0x0 char}     {0x0 char}         {0x0 char}

Импортируйте 10 строки первого 5 переменные из рабочего листа под названием '2007'.

M = readmatrix('airlinesmall_subset.xlsx','Sheet','2007','Range','A2:E11')

M = 10×5

        2007           1           2           2         711
        2007           1           3           3         652
        2007           1           4           4        1116
        2007           1           5           5         825
        2007           1           7           7        1411
        2007           1           8           1        1935
        2007           1           9           2        2005
        2007           1          11           4        1525
        2007           1          12           5        1133
        2007           1          13           6         922

Входные параметры

свернуть все

`filename` — Имя файла, чтобы читать
вектор символов | представляет скаляр в виде строки

Имя файла, чтобы читать, заданный как вектор символов или скаляр строки.

В зависимости от местоположения вашего файла, filename может взять одну из следующих форм.

Местоположение

Форма

Текущая папка или папка на пути MATLAB^®

Задайте имя файла в filename.

Пример: 'myFile.txt'

Файл в папке

Если файл не находится в текущей папке или в папке на пути MATLAB, то задайте полное имя или относительный путь в filename.

Пример: 'C:\myFolder\myFile.xlsx'

Пример: 'dataDir\myFile.txt'

Удаленное местоположение

Если файл хранится в удаленном местоположении, то filename должен содержать полный путь файла, заданного как универсальный локатор ресурса (URL) формы:

scheme_name://path_to_file/my_file.ext

На основе вашего удаленного местоположения, scheme_name может быть одно из значений в этой таблице.

Удаленное местоположение	`scheme_name`
Amazon S3™	`s3`
Устройство хранения данных Windows Azure^® Blob	`wasb`, `wasbs`
HDFS™	`hdfs`

Для получения дополнительной информации смотрите работу с Удаленными данными.

Пример: 's3://bucketname/path_to_file/my_file.csv'

Если 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`

Настройки импорта файла, заданные как SpreadsheetImportOptionsDelimitedTextImportOptions, или FixedWidthImportOptions объект создается detectImportOptions функция. opts объект содержит свойства, которые управляют процессом импорта данных. Для получения дополнительной информации о свойствах каждого объекта смотрите соответствующую объектную страницу.

Тип файлов	Вывод
Файлы электронной таблицы	`SpreadsheetImportOptions` объект
Текстовые файлы	`DelimitedTextImportOptions` объект
Текстовые файлы фиксированной ширины	`FixedWidthImportOptions` объект

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. 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' и вектор символов, представьте в виде строки скаляр или числовой вектор в одной из следующих форм.

Способы задать Range Описание

Способы задать `Range`	Описание
Запуск ячейки `'Cell'` или `[row col]`	Задайте стартовую ячейку для данных как вектор символов или представьте в виде строки скаляр или два элемента числовой вектор. Вектор символов или скаляр строки, содержащий букву столбца и номер строки с помощью Excel `A1` обозначение. Например, `A5` идентификатор для ячейки на пересечении столбца `A` и строка `5`. Два элемента числовой вектор формы `[row col]` указание на стартовую строку и столбец. Используя стартовую ячейку, функция импорта автоматически обнаруживает степень данных путем начала импорта в ячейке запуска и окончания в последней пустой строке или области значений нижнего колонтитула. Пример: `'A5'` или `[5 1]`
Прямоугольная область значений `'Corner1:Corner2'` или `[r1 c1 r2 c2]`	Укажите точный диапазон, чтобы считать использование прямоугольной области значений в одной из следующих форм. `'Corner1:Corner2'` — Укажите диапазон с помощью `Corner1` и `Corner2` которые являются двумя противостоящими углами, которые задают область, чтобы читать в Excel `A1` обозначение. Например, `'C2:N15'`. `[r1 c1 r2 c2]` — Укажите диапазон с помощью четырех элементов числовой вектор, содержащий начинать-строку, начальный столбец, строку конца и столбец конца. Например, `[2 3 15 13]`. Функция импорта только считывает данные, содержавшиеся в заданной области. Любые пустые поля в заданной области импортируются как недостающие ячейки.
Область значений строки или область значений столбца `'Row1:Row2'` или `'Column1:Column2'`	Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel. Используя указанный диапазон строки, функция импорта автоматически обнаруживает степень столбца путем чтения из первого непустого столбца в конец данных и создает одну переменную для каждого столбца. Пример: `'5:500'` В качестве альтернативы укажите диапазон путем идентификации начала и конечного использования столбцов буквы столбца Excel или числа. Используя указанный диапазон столбца, функция импорта автоматически обнаруживает степень строки путем чтения из первой непустой строки в конец данных или области значений нижнего колонтитула. Количество столбцов в заданной области должно совпадать с номером, заданным в `ExpectedNumVariables` свойство. Пример: `'A:K'`
Запуск номера строки `n`	Задайте первую строку, содержащую данные с помощью индекса строки положительной скалярной величины. Используя заданный индекс строки, функция импорта автоматически обнаруживает степень данных путем чтения из заданной первой строки в конец данных или области значений нижнего колонтитула. Пример 5
Именованная область значений Excel `'NamedRange'`	В Excel можно создать имена, чтобы идентифицировать области значений в электронной таблице. Например, можно выбрать прямоугольный фрагмент электронной таблицы и вызвать ее `'myTable'`. Если такие именованные области значений существуют в электронной таблице, то функция импорта может считать ту область значений с помощью своего имени. Пример: `'Range','myTable'`
Незаданный или пустой `''`	Если незаданный, функция импорта автоматически обнаруживает используемую область значений. Пример: `'Range',''` Примечание: Используемая Область значений относится к прямоугольному фрагменту электронной таблицы, которая на самом деле содержит данные. Функция импорта автоматически обнаруживает используемую область значений путем обрезки любого продвижения и запаздывающих строк и столбцов, которые не содержат данные. Текст, который является только пробелом, рассматривается данными и получен в используемой области значений.

Запуск ячейки

'Cell' или [row col]

Задайте стартовую ячейку для данных как вектор символов или представьте в виде строки скаляр или два элемента числовой вектор.

Вектор символов или скаляр строки, содержащий букву столбца и номер строки с помощью Excel A1 обозначение. Например, A5 идентификатор для ячейки на пересечении столбца A и строка 5.
Два элемента числовой вектор формы [row col] указание на стартовую строку и столбец.

Используя стартовую ячейку, функция импорта автоматически обнаруживает степень данных путем начала импорта в ячейке запуска и окончания в последней пустой строке или области значений нижнего колонтитула.

Пример: 'A5' или [5 1]

Прямоугольная область значений

'Corner1:Corner2' или [r1 c1 r2 c2]

Укажите точный диапазон, чтобы считать использование прямоугольной области значений в одной из следующих форм.

'Corner1:Corner2' — Укажите диапазон с помощью Corner1 и Corner2 которые являются двумя противостоящими углами, которые задают область, чтобы читать в Excel A1 обозначение. Например, 'C2:N15'.
[r1 c1 r2 c2] — Укажите диапазон с помощью четырех элементов числовой вектор, содержащий начинать-строку, начальный столбец, строку конца и столбец конца. Например, [2 3 15 13].

Функция импорта только считывает данные, содержавшиеся в заданной области. Любые пустые поля в заданной области импортируются как недостающие ячейки.

Область значений строки или область значений столбца

'Row1:Row2' или 'Column1:Column2'

Укажите диапазон путем идентификации начала и конечного использования строк номера строк Excel.

Используя указанный диапазон строки, функция импорта автоматически обнаруживает степень столбца путем чтения из первого непустого столбца в конец данных и создает одну переменную для каждого столбца.

Пример: '5:500'

В качестве альтернативы укажите диапазон путем идентификации начала и конечного использования столбцов буквы столбца Excel или числа.

Используя указанный диапазон столбца, функция импорта автоматически обнаруживает степень строки путем чтения из первой непустой строки в конец данных или области значений нижнего колонтитула.

Количество столбцов в заданной области должно совпадать с номером, заданным в ExpectedNumVariables свойство.

Пример: 'A:K'

Запуск номера строки

n

Задайте первую строку, содержащую данные с помощью индекса строки положительной скалярной величины.

Используя заданный индекс строки, функция импорта автоматически обнаруживает степень данных путем чтения из заданной первой строки в конец данных или области значений нижнего колонтитула.

Пример 5

Именованная область значений Excel

'NamedRange'

В Excel можно создать имена, чтобы идентифицировать области значений в электронной таблице. Например, можно выбрать прямоугольный фрагмент электронной таблицы и вызвать ее 'myTable'. Если такие именованные области значений существуют в электронной таблице, то функция импорта может считать ту область значений с помощью своего имени.

Пример: 'Range','myTable'

Незаданный или пустой

''

Если незаданный, функция импорта автоматически обнаруживает используемую область значений.

Пример: 'Range',''

Примечание: Используемая Область значений относится к прямоугольному фрагменту электронной таблицы, которая на самом деле содержит данные. Функция импорта автоматически обнаруживает используемую область значений путем обрезки любого продвижения и запаздывающих строк и столбцов, которые не содержат данные. Текст, который является только пробелом, рассматривается данными и получен в используемой области значений.

Типы данных: char | string | double

`'TreatAsMissing'` — Текст, чтобы интерпретировать как недостающие данные
вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

Текст, чтобы интерпретировать как недостающие данные, заданные как вектор символов, представляет в виде строки скаляр, массив ячеек из символьных векторов или массив строк.

Пример: 'TreatAsMissing',{'NA','TBD'} дает функции импорта команду обрабатывать любое вхождение NA или TBD как недостающие поля.

Типы данных: char | string | cell

`'OutputType'` — Тип выходных данных
вектор символов | представляет скаляр в виде строки

Тип выходных данных, заданный как разделенная запятой пара, состоящая из 'OutputType' и вектор символов или скаляр строки, содержащий имя любого из типов данных в этой таблице.

Тип данных	Тип выходных данных
Числовой	`'uint8'int8int16int32int64uint16uint32uint64единственный`, или `'double'`
Текст	`'char'` или `'string'`
Другие типы	`'datetime'длительность`, или `'categorical'`

Пример: 'OutputType','uint8'

Типы данных: 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' или имя схемы кодирования стандартного символа, такое как одно из значений в этой таблице.

`'Big5'`	`'ISO-8859-1'`	`'windows-847'`
`'Big5-HKSCS'`	`'ISO-8859-2'`	`'windows-949'`
`'CP949'`	`'ISO-8859-3'`	`'windows-1250'`
`'EUC-KR'`	`'ISO-8859-4'`	`'windows-1251'`
`'EUC-JP'`	`'ISO-8859-5'`	`'windows-1252'`
`'EUC-TW'`	`'ISO-8859-6'`	`'windows-1253'`
`'GB18030'`	`'ISO-8859-7'`	`'windows-1254'`
`'GB2312'`	`'ISO-8859-8'`	`'windows-1255'`
`'GBK'`	`'ISO-8859-9'`	`'windows-1256'`
`'IBM866'`	`'ISO-8859-11'`	`'windows-1257'`
`'KOI8-R'`	`'ISO-8859-13'`	`'windows-1258'`
`'KOI8-U'`	`'ISO-8859-15'`	`'US-ASCII'`
	`'Macintosh'`	`'UTF-8'`
	`'Shift_JIS'`

Пример: 'Encoding','system' использует кодирование системного значения по умолчанию.

Типы данных: 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'

`'DecimalSeparator'` — Символы, указывающие на десятичный разделитель
вектор символов | представляет скаляр в виде строки

Символы, указывающие на десятичный разделитель в числовых переменных, заданных как вектор символов или скаляр строки. Функция импорта использует символы, заданные в DecimalSeparator пара "имя-значение", чтобы отличить целую часть номера от десятичной части.

При преобразовании в целочисленные типы данных числа с десятичной частью округлены к самому близкому целому числу.

Пример: Если пара "имя-значение" задана как 'DecimalSeparator',',', затем функция импорта импортирует текст "3,14159" как номер 3.14159.

Типы данных: char | string

`'ThousandsSeparator'` — Символы, которые указывают на тысячи группировки
вектор символов | представляет скаляр в виде строки

Символы, которые указывают на тысячи группировки в числовых переменных, заданных как вектор символов, или представляют скаляр в виде строки. Тысячи группирующихся символов действуют как визуальные диафрагмы, группируя номер в каждых трех значениях места. Функция импорта использует символы, заданные в ThousandsSeparator пара "имя-значение", чтобы интерпретировать импортируемые числа.

Пример: Если пара "имя-значение" задана как 'ThousandsSeparator',',', затем функция импорта импортирует текст "1,234,000" как 1234000.

Типы данных: char | string

`'TrimNonNumeric'` — Удалите нечисловые символы
`false` (значение по умолчанию) | `true`

Удалите нечисловые символы из числовой переменной, заданной как логический true или false.

Пример: Если пара "имя-значение" задана как 'TrimNonNumeric',true, затем функция импорта читает '$500/-' как 500.

Типы данных: логический

`'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 для Windows
`false` (значение по умолчанию) | `true`

Отметьте, чтобы запустить экземпляр Microsoft Excel для Windows при чтении данных об электронной таблице, заданных как разделенная запятой пара, состоящая из 'UseExcel' и любой true, или false.

Можно установить 'UseExcel' параметр к одному из этих значений:

true — Функция импорта запускает экземпляр Microsoft Excel при чтении файла.
false — Функция импорта не запускает экземпляр Microsoft Excel при чтении файла. При работе в этом режиме функциональность функции импорта отличается в поддержку форматов файлов и интерактивных функций, таких как формулы и макросы.

UseExcel	`true`	`false`
Поддерживаемые форматы файлов	`.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods`	`.xls, .xlsx, .xlsm, .xltx, .xltm`
Поддержка интерактивных функций, таких как формулы и макросы	Да	Нет

Когда чтение из файлов электронной таблицы на платформах Windows, если вы хотите запустить экземпляр Microsoft Excel, затем установило 'UseExcel' параметр к true.

Документация

readmatrix

Синтаксис

Описание

Примеры

Считайте матрицу из текстового файла

Считайте матрицу из файла электронной таблицы

Считайте матрицу из заданного листа и области значений Используя настройки импорта

Считайте матрицу из заданного листа и области значений

Входные параметры

`filename` — Имя файла, чтобы читать
вектор символов | представляет скаляр в виде строки

`opts` — Настройки импорта файла
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions`

Аргументы в виде пар имя-значение

Текст и файлы электронной таблицы

`'FileType'` — Тип файла
`'text'` | `'spreadsheet'`

`'NumHeaderLines'` — Количество линий заголовка
положительное целое число

`'ExpectedNumVariables'` — Ожидаемое количество переменных
положительное целое число

`'Range'` — Фрагмент данных, чтобы читать
вектор символов | представляет скаляр в виде строки | числовой вектор

`'OutputType'` — Тип выходных данных
вектор символов | представляет скаляр в виде строки

Текстовые файлы только

`'Delimiter'` — Символы разделителя полей
вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

`'Whitespace'` — Символы, чтобы обработать как пробел
вектор символов | представляет скаляр в виде строки

`'CommentStyle'` — Стиль комментариев
вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

`'Encoding'` — Схема кодировки символов
`'system'` | `'UTF-8'` | `'ISO-8859-1'` | `'windows-1251'` | `'windows-1252'` | ...

`'DateLocale'` — Локаль для чтения дат
вектор символов | представляет скаляр в виде строки

`'DecimalSeparator'` — Символы, указывающие на десятичный разделитель
вектор символов | представляет скаляр в виде строки

`'ThousandsSeparator'` — Символы, которые указывают на тысячи группировки
вектор символов | представляет скаляр в виде строки

`'TrimNonNumeric'` — Удалите нечисловые символы
`false` (значение по умолчанию) | `true`

`'ConsecutiveDelimitersRule'` — Процедура, чтобы обработать последовательные разделители
`'split'` | `'join'` | `'error'`

`'LeadingDelimitersRule'` — Процедура, чтобы управлять ведущими разделителями
`'keep'` | `'ignore'` | `'error'`

Файлы электронной таблицы только

`'UseExcel'` — Отметьте, чтобы запустить экземпляр Microsoft Excel для Windows
`false` (значение по умолчанию) | `true`

Смотрите также

Введенный в R2019a

Документация MATLAB

Поддержка

Документация

readmatrix

Синтаксис

Описание

Примеры

Считайте матрицу из текстового файла

Считайте матрицу из файла электронной таблицы

Считайте матрицу из заданного листа и области значений Используя настройки импорта

Считайте матрицу из заданного листа и области значений

Входные параметры

filename — Имя файла, чтобы читать вектор символов | представляет скаляр в виде строки

opts — Настройки импорта файла SpreadsheetImportOptions | DelimitedtextImportOptions | FixedWidthImportOptions

Аргументы в виде пар имя-значение

Текст и файлы электронной таблицы

'FileType' — Тип файла 'text' | 'spreadsheet'

'NumHeaderLines' — Количество линий заголовка положительное целое число

'ExpectedNumVariables' — Ожидаемое количество переменных положительное целое число

'Range' — Фрагмент данных, чтобы читать вектор символов | представляет скаляр в виде строки | числовой вектор

'OutputType' — Тип выходных данных вектор символов | представляет скаляр в виде строки

Текстовые файлы только

'Delimiter' — Символы разделителя полей вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

'Whitespace' — Символы, чтобы обработать как пробел вектор символов | представляет скаляр в виде строки

'CommentStyle' — Стиль комментариев вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

'Encoding' — Схема кодировки символов 'system' | 'UTF-8' | 'ISO-8859-1' | 'windows-1251' | 'windows-1252' | ...

'DateLocale' — Локаль для чтения дат вектор символов | представляет скаляр в виде строки

'DecimalSeparator' — Символы, указывающие на десятичный разделитель вектор символов | представляет скаляр в виде строки

'ThousandsSeparator' — Символы, которые указывают на тысячи группировки вектор символов | представляет скаляр в виде строки

'TrimNonNumeric' — Удалите нечисловые символы false (значение по умолчанию) | true

'ConsecutiveDelimitersRule' — Процедура, чтобы обработать последовательные разделители 'split' | 'join' | 'error'

'LeadingDelimitersRule' — Процедура, чтобы управлять ведущими разделителями 'keep' | 'ignore' | 'error'

Файлы электронной таблицы только

'UseExcel' — Отметьте, чтобы запустить экземпляр Microsoft Excel для Windows false (значение по умолчанию) | true

Смотрите также

Введенный в R2019a

Документация MATLAB

Поддержка

`filename` — Имя файла, чтобы читать
вектор символов | представляет скаляр в виде строки

`opts` — Настройки импорта файла
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions`

`'FileType'` — Тип файла
`'text'` | `'spreadsheet'`

`'NumHeaderLines'` — Количество линий заголовка
положительное целое число

`'ExpectedNumVariables'` — Ожидаемое количество переменных
положительное целое число

`'Range'` — Фрагмент данных, чтобы читать
вектор символов | представляет скаляр в виде строки | числовой вектор

`'OutputType'` — Тип выходных данных
вектор символов | представляет скаляр в виде строки

`'Delimiter'` — Символы разделителя полей
вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

`'Whitespace'` — Символы, чтобы обработать как пробел
вектор символов | представляет скаляр в виде строки

`'CommentStyle'` — Стиль комментариев
вектор символов | представляет скаляр в виде строки | массив ячеек из символьных векторов | массив строк

`'Encoding'` — Схема кодировки символов
`'system'` | `'UTF-8'` | `'ISO-8859-1'` | `'windows-1251'` | `'windows-1252'` | ...

`'DateLocale'` — Локаль для чтения дат
вектор символов | представляет скаляр в виде строки

`'DecimalSeparator'` — Символы, указывающие на десятичный разделитель
вектор символов | представляет скаляр в виде строки

`'ThousandsSeparator'` — Символы, которые указывают на тысячи группировки
вектор символов | представляет скаляр в виде строки

`'TrimNonNumeric'` — Удалите нечисловые символы
`false` (значение по умолчанию) | `true`

`'ConsecutiveDelimitersRule'` — Процедура, чтобы обработать последовательные разделители
`'split'` | `'join'` | `'error'`

`'LeadingDelimitersRule'` — Процедура, чтобы управлять ведущими разделителями
`'keep'` | `'ignore'` | `'error'`

`'UseExcel'` — Отметьте, чтобы запустить экземпляр Microsoft Excel для Windows
`false` (значение по умолчанию) | `true`