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^® path

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

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

Файл в папке

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

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

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

Интернет URL

Если файл задан как интернет-универсальный локатор ресурса (URL), то filename должен содержать тип протокола 'http://' или 'https://'.

Пример: 'http://hostname/path_to_file/my_data.csv'

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

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

scheme_name://path_to_file/my_file.ext

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

Удаленное местоположение	`scheme_name`
Amazon S3™	`s3`
Windows Azure^® Устройство хранения данных блоба	`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` | `XMLImportOptions`

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

Тип файлов	Вывод
Файлы электронной таблицы	`SpreadsheetImportOptions` объект (только доступный для `SheetDataRange` , и `VariableNames` свойства
Текстовые файлы	`DelimitedTextImportOptions` объект
Текстовые файлы фиксированной ширины	`FixedWidthImportOptions` объект
XML-файлы	`XMLImportOptions` объект

Аргументы name-value

Задайте дополнительные разделенные запятой пары 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` — Схема кодировки символов
`'UTF-8'` | `'ISO-8859-1'` | `'windows-1251'` | `'windows-1252'` | ...

Схема кодировки символов, сопоставленная с файлом в виде разделенной запятой пары, состоящей из 'Encoding' и 'system' или имя схемы кодирования стандартного символа. Когда вы не задаете кодирования, readmatrix функционируйте использует автоматическое обнаружение набора символов, чтобы определить кодирование при чтении файла.

Если вы задаете 'Encoding' аргумент в дополнение к настройкам импорта, затем readmatrix функционируйте использует заданное значение для 'Encoding', переопределение кодирования задано в настройках импорта.

Пример: 'Encoding','UTF-8' использование UTF-8 как кодирование.

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

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

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

Локаль для чтения дат в виде разделенной запятой пары, состоящей из 'DateLocale' и вектор символов или строковый скаляр формы xx_YY, где:

YY прописная альфа ISO 3166-1 2 кода, указывающие на страну.
xx строчный ISO 639-1 двухбуквенный код, указывающий на язык.

Эта таблица приводит некоторые общие значения для локали.

Локаль	Язык	Страна
`'de_DE'`	Немецкий язык	Германия
`'en_GB'`	Английский язык	Соединенное Королевство
`'en_US'`	Английский язык	Соединенные Штаты
`'es_ES'`	Испанский язык	Испания
`'fr_FR'`	Французский язык	Франция
`'it_IT'`	Итальянский язык	Италия
`'ja_JP'`	Японский язык	Япония
`'ko_KR'`	Корейский язык	Корея
`'nl_NL'`	Нидерландский язык	Нидерланды
`'zh_CN'`	Китайский язык (упрощен)	Китай

При использовании %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'`	Возвратите ошибку и прервите операцию импорта.

`TrailingDelimitersRule` — Процедура, чтобы справиться с запаздыванием разделителей
`'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.

Введенный в R2019a

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

readmatrix

Синтаксис

Описание

Примеры

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

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

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

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

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

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

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

Аргументы name-value

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

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

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

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

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

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

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

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

`LineEnding` — Символы конца линии
`{'\n','\r','\r\n'}` (значение по умолчанию) | вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

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

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

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

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

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

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

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

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

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

`Sheet` — Покройте, чтобы читать из
`''` пустой символьный массив (значение по умолчанию) | вектор символов | строковый скаляр | положительное скалярное целое число

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

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

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

Поддержка

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

readmatrix

Синтаксис

Описание

Примеры

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

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

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

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

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

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

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

Аргументы name-value

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

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

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

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

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

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

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

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

LineEnding — Символы конца линии {'\n','\r','\r\n'} (значение по умолчанию) | вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

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

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

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

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

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

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

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

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

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

Sheet — Покройте, чтобы читать из '' пустой символьный массив (значение по умолчанию) | вектор символов | строковый скаляр | положительное скалярное целое число

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

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

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

Поддержка

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

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

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

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

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

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

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

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

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

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

`LineEnding` — Символы конца линии
`{'\n','\r','\r\n'}` (значение по умолчанию) | вектор символов | строковый скаляр | массив ячеек из символьных векторов | массив строк

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

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

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

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

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

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

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

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

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

`Sheet` — Покройте, чтобы читать из
`''` пустой символьный массив (значение по умолчанию) | вектор символов | строковый скаляр | положительное скалярное целое число

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