readtable

Составьте таблицу из файла

Синтаксис

T = readtable(filename)
T = readtable(filename,Name,Value)
T = readtable(filename,opts)
T = readtable(filename,opts,Name,Value)

Описание

пример

T = readtable(filename) составляет таблицу путем чтения данных в столбцах из файла.

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

  • txt dat или .csv для файлов разделенного текста

  • .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx или .ods для файлов электронной таблицы

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

пример

T = readtable(filename,Name,Value) составляет таблицу из файла с дополнительными опциями, заданными одним или несколькими аргументами в виде пар "имя-значение".

Например, можно задать, читает ли readtable первую строку файла как имена переменных или как данные.

пример

T = readtable(filename,opts) составляет таблицу с помощью настроек импорта opts.

T = readtable(filename,opts,Name,Value) составляет таблицу с помощью настроек импорта и с дополнительными опциями, заданными одним или несколькими из этих аргументов в виде пар "имя-значение": ReadVariableNames, ReadRowNames, DateLocale, Encoding, Sheet и Basic.

Примеры

свернуть все

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

filename = fullfile(matlabroot,'examples','matlab','myCsvTable.dat');

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

T = readtable(filename)
T=5×6 table
     LastName     Gender    Age    Height    Weight    Smoker
    __________    ______    ___    ______    ______    ______

    'Smith'        'M'      38       71       176        1   
    'Johnson'      'M'      43       69       163        0   
    'Williams'     'F'      38       64       131        0   
    'Jones'        'F'      40       67       133        0   
    'Brown'        'F'      49       64       119        0   

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

filename = fullfile(matlabroot,'examples','matlab','mySpaceDelimTable.txt');

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

T = readtable(filename,...
    'Delimiter',' ','ReadVariableNames',false)
T=3×5 table
    Var1    Var2    Var3    Var4     Var5  
    ____    ____    ____    ____    _______

    'M'      45      45     'NY'    'true' 
    'F'      41      32     'CA'    'false'
    'M'      40      34     'MA'    'false'

T содержит имена переменных по умолчанию.

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

filename = fullfile(matlabroot,'examples','matlab','myCsvTable.dat');

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

T = readtable(filename,'Format','%s%s%u%f%f%s')
T=5×6 table
     LastName     Gender    Age    Height    Weight    Smoker
    __________    ______    ___    ______    ______    ______

    'Smith'        'M'      38       71       176       '1'  
    'Johnson'      'M'      43       69       163       '0'  
    'Williams'     'F'      38       64       131       '0'  
    'Jones'        'F'      40       67       133       '0'  
    'Brown'        'F'      49       64       119       '0'  

Спецификаторами преобразования является %s для массива ячеек из символьных векторов, %f для double и %u для uint32.

Считайте немецкие даты из файла и добавьте их к таблице как английские даты.

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

filename = fullfile(matlabroot,'examples','matlab','german_dates.txt');

Считайте файл примера с помощью readtable. Спецификаторы преобразования являются датами %D и %f для значений с плавающей точкой. Задайте кодирование файла с помощью аргумента в виде пар "имя-значение" FileEncoding. Задайте формат и локаль дат с помощью аргумента в виде пар "имя-значение" DateLocale.

T = readtable(filename,'ReadVariableNames',false,...
    'Format','%{dd MMMM yyyy}D %f %f',...
    'FileEncoding','ISO-8859-15',...
    'DateLocale','de_DE')
T=3×3 table
          Var1          Var2    Var3 
    ________________    ____    _____

     01 January 2014    20.2    100.5
    01 February 2014    21.6    102.7
       01 March 2014    20.7     99.8

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

T = readtable('patients.xls','ReadRowNames',true);

Отобразите первые пять строк и сначала четыре переменные таблицы.

T(1:5,1:4)
ans=5×4 table
                 Gender     Age             Location              Height
                ________    ___    ___________________________    ______

    Smith       'Male'      38     'County General Hospital'        71  
    Johnson     'Male'      43     'VA Hospital'                    69  
    Williams    'Female'    38     'St. Mary's Medical Center'      64  
    Jones       'Female'    40     'VA Hospital'                    67  
    Brown       'Female'    49     'County General Hospital'        64  

Просмотрите свойство DimensionNames таблицы.

T.Properties.DimensionNames
ans = 1x2 cell array
    {'LastName'}    {'Variables'}

'LastName' является именем в первом столбце первой строки электронной таблицы.

Составьте таблицу с помощью данных из заданной области электронной таблицы patients.xls. Используйте данные из 5 3 прямоугольной области между углами C2 и E6. Не используйте первую строку этой области как имена переменных.

T = readtable('patients.xls',...
    'Range','C2:E6',...
    'ReadVariableNames',false)
T = 

    Var1               Var2                Var3
    ____    ___________________________    ____

    38      'County General Hospital'      71  
    43      'VA Hospital'                  69  
    38      'St. Mary's Medical Center'    64  
    40      'VA Hospital'                  67  
    49      'County General Hospital'      64  

T содержит имена переменных по умолчанию.

Создайте настройки импорта, адаптируйте типы данных для нескольких переменных, и затем считайте данные.

Создайте объект настроек импорта из текстового файла.

opts = detectImportOptions('airlinesmall.csv')
opts = 
  DelimitedTextImportOptions with properties:

   Format Properties:
                    Delimiter: {','}
                   Whitespace: '\b\t '
                   LineEnding: {'\n'  '\r'  '\r\n'}
                 CommentStyle: {}
    ConsecutiveDelimitersRule: 'split'
        LeadingDelimitersRule: 'keep'
                EmptyLineRule: 'skip'
                     Encoding: 'UTF-8'

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'
             ExtraColumnsRule: 'addvars'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
                VariableTypes: {'double', 'double', 'double' ... and 26 more}
        SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
              VariableOptions: Show all 29 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts

   Location Properties:
                    DataLines: [2 Inf]
            VariableNamesLine: 1
               RowNamesColumn: 0
            VariableUnitsLine: 0
     VariableDescriptionsLine: 0 
	To display a preview of the table, use preview

Исследуйте свойство Type переменных TaxiIn и TaxiOut.

getvaropts(opts,{'TaxiIn','TaxiOut'})
ans = 
  1x2 TextVariableImportOptions array with properties:

    WhitespaceRule
    Type
    FillValue
    Name
    QuoteRule
    TreatAsMissing
    Prefixes
    Suffixes
    EmptyFieldRule

Измените тип переменных TaxiIn и TaxiOut к double.

 opts = setvartype(opts,{'TaxiIn','TaxiOut'},'double');

Задайте подмножество переменных, чтобы импортировать и исследовать.

opts.SelectedVariableNames = {'TaxiIn','TaxiOut'};

Используйте функцию readtable наряду с объектом опций импортировать выбранные переменные. Отобразите сводные данные таблицы.

T = readtable('airlinesmall.csv',opts);
summary(T)
Variables:

    TaxiIn: 123523x1 double

        Values:

            Min            0      
            Median         5      
            Max            1451   
            NumMissing     37383  

    TaxiOut: 123523x1 double

        Values:

            Min             0      
            Median          13     
            Max             755    
            NumMissing      37364  

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

Создайте объект настроек импорта из файла.

opts = detectImportOptions('patients.xls')
opts = 
  SpreadsheetImportOptions with properties:

   Sheet Properties:
                        Sheet: ''

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
                VariableTypes: {'char', 'char', 'double' ... and 7 more}
        SelectedVariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
              VariableOptions: Show all 10 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts

   Range Properties:
                    DataRange: 'A2' (Start Cell)
           VariableNamesRange: 'A1'
                RowNamesRange: ''
           VariableUnitsRange: ''
    VariableDescriptionsRange: '' 
	To display a preview of the table, use preview

Измените объект опций задать который переменные импортировать.

opts.SelectedVariableNames = {'Systolic','Diastolic'};

Используйте readtable наряду с объектом опций импортировать заданные переменные.

T = readtable('patients.xls',opts);
summary(T)
Variables:

    Systolic: 100x1 double

        Values:

            Min          109    
            Median       122    
            Max          138    

    Diastolic: 100x1 double

        Values:

            Min            68    
            Median       81.5    
            Max            99    

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

свернуть все

Имя файла, чтобы читать, заданный как вектор символа или скаляр строки. Если файл находится в текущей папке или в папке на пути MATLAB®, то задайте имя файла в filename. Например, 'myFile.csv'.

Если filename включает расширение файла, то readtable определяет формат файла от расширения. В противном случае необходимо задать аргументы в виде пар "имя-значение" 'FileType', чтобы указать на тип файла.

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

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

Форма

Файл в папке

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

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

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

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

(Amazon S3™, устройство хранения данных Windows Azure® Blob и HDFS™)

Если файл хранится в удаленном местоположении, то filename должен содержать полный путь файла, заданного как интернационализировавший идентификатор ресурса (IRI) формы:
scheme_name://path_to_file.

scheme_name может быть одним из этих значений: s3, wasb, wasbs или hdfs.

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

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

В системах Windows® с программным обеспечением Microsoft® Excel® readtable читает любой формат файла электронной таблицы Excel, распознанный вашей версией Excel. Если ваша система не имеет Excel для Windows или если вы используете MATLAB Online™, readtable действует с набором свойств UseExcel к false и читает только файлы .xls, .xlsx, .xlsm, .xltx, and .xltm.

Для файла разделенного текста readtable преобразовывает пустые поля в файле к любому NaN (для числовой переменной) или пустой символьный вектор (для текстовой переменной). Все строки в текстовом файле должны иметь то же количество разделителей. readtable игнорирует незначительный пробел в файле.

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

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

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

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

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'ReadVariableNames', ложь указывает, что первая строка файла не соответствует именам переменных.

При чтении:

  • Текстовые файлы, только эти названия параметра применяются: FileType, ReadVariableNames, ReadRowNames, TreatAsEmpty, DatetimeType, Delimiter, HeaderLines, Format, EmptyValue, MultipleDelimsAsOne, CollectOutput, CommentStyle, ExpChars, EndOfLine, DateLocale и Encoding.

  • Файлы электронной таблицы, только эти названия параметра применяются: FileType, ReadVariableNames, ReadRowNames, TreatAsEmpty, DatetimeType, Sheet, Range, Basic и TextType.

  • Текст или файлы электронной таблицы с настройками импорта opts, только эти названия параметра применяются: ReadVariableNames, ReadRowNames, DateLocale, Encoding, Sheet и Basic.

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

свернуть все

Тип файла, заданного как пара, разделенная запятой, состоящая из 'FileType' и вектора символа или скаляра строки, содержащего 'text' или 'spreadsheet'.

Задайте аргумент в виде пар "имя-значение" 'FileType', когда filename не включает расширение файла или если расширение отличается от одного из следующих.

  • txt dat или .csv для файлов разделенного текста

  • .xls, .xlsb, .xlsm, .xlsx, .xltm, .xltx или .ods для файлов электронной таблицы

Пример: 'Тип файла', 'текст'

Пример: 'Тип файла', "текст"

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

Индикатор для чтения первой строки как имена переменных, заданные как пара, разделенная запятой, состоящая из 'ReadVariableNames' и или true, false, 1 или 0. Если незаданный, readtable автоматически обнаруживает присутствие имен переменных.

Индикатор

Описание

tRUE

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

ложь

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

незаданный Когда оставлено незаданный, readtable автоматически обнаруживает true или false и доходы соответственно.

Примечание: Если и 'ReadVariableNames' и 'ReadRowNames', логические индикаторы верны, то readtable сохраняет имя в первом столбце первой строки области, чтобы читать как первое имя размерности в свойстве, T.Properties.DimensionNames.

Если вы задаете аргумент ReadVariableNames в дополнение к opts настройки импорта, то поведение readtable изменяется на основе спецификации:

  • Если ReadVariableNames является true, то считанный имена переменных из заданного файла при помощи VariableNamesRange или свойства VariableNamesLine объекта настроек импорта.

  • Если ReadVariableNames является false, то считанный имена переменных из свойства VariableNames объекта настроек импорта.

Индикатор для чтения первого столбца как строка называет, заданный как пара, разделенная запятой, состоящая из 'ReadRowNames' и или false, true, 0 или 1.

Индикатор

Описание

ложь

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

tRUE

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

незаданныйКогда оставлено незаданный, readtable принимает false.

Примечание: Если и 'ReadVariableNames' и 'ReadRowNames', логические индикаторы верны, то readtable сохраняет имя в первом столбце первой строки области, чтобы читать как первое имя размерности в свойстве, T.Properties.DimensionNames.

Если вы задаете аргумент ReadRowNames в дополнение к opts настройки импорта, то поведение readtable изменяется на основе спецификации:

  • Если ReadRowNames является true, то считанный имена строки из заданного файла при помощи RowNamesRange или свойства RowNameColumn объекта настроек импорта.

  • Если ReadRowNames является false, то не импортируйте имена строки.

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

'TreatAsEmpty' только применяется к числовым столбцам в файле, и readtable не принимает числовые литералы, такие как '-99'.

Пример: 'TreatAsEmpty', and/A' или 'TreatAsEmpty', "N/A" устанавливает N/A в рамках числовых столбцов к NaN.

Пример: 'TreatAsEmpty' .', 'NA', and/A'} или 'TreatAsEmpty', [". ", "NA", "N/A"] наборы., NA и N/A в рамках числовых столбцов к NaN.

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

Тип выходных данных текста, заданного как пара, разделенная запятой, состоящая из 'TextType' и вектора символа или скаляра строки, содержащего 'char' или 'string'. Если вы задаете значение 'char', то readtable возвращает текст как массив ячеек из символьных векторов. Если вы задаете значение 'string', то readtable возвращает текст как массив типа string.

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

Введите для импортированных данных даты и времени, заданных как пара, разделенная запятой, состоящая из 'DatetimeType' и одно из этих значений: 'datetime', 'text' или 'exceldatenum'. Значение 'exceldatenum' применим только для файлов электронной таблицы и не допустим для текстовых файлов.

ЗначениеВведите для импортированных данных даты и времени
datetime

MATLAB тип данных datetime

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

Текст

Если 'DatetimeType' задан как 'text', то тип для импортированных данных даты и времени зависит от значения, заданного в параметре 'TextType':

  • Если 'TextType' является 'char', то readtable возвращает даты как массив ячеек из символьных векторов.

  • Если 'TextType' является 'string', то readtable возвращает даты как массив строк.

'exceldatenum'

Excel последовательные числа даты

Последовательный номер даты является единственным номером, равным номеру дней с данной ссылочной даты. Excel последовательные числа даты использует различную ссылочную дату, чем MATLAB последовательные числа даты. Для получения дополнительной информации о датах Excel смотрите https://support.microsoft.com/en-us/kb/214330.

Пример: 'DatetimeType', 'текст'

Пример: 'DatetimeType', "datetime"

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

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

свернуть все

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

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

Спецификатор

Разделитель полей

','

'comma'

Запятая

' '

'space'

Пробел

T

'tab'

Вкладка

';'

'semi'

Точка с запятой

'|'

панель

Вертикальная панель

незаданный

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

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

Пример: 'Разделитель''', или 'Разделитель', 'запятая'

Типы данных: char | представляет в виде строки | ячейка

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

Типы данных: single | double

Формат столбца файла, заданного как пара, разделенная запятой, состоящая из 'Format' и вектора символа или скаляра строки одного или нескольких спецификаторов преобразования. Спецификаторы преобразования совпадают со спецификаторами, принятыми функцией textscan.

Определение формата может значительно улучшить скорость для некоторых больших файлов. Если вы не задаете значение для Format, то readtable использует %q, чтобы интерпретировать нечисловые столбцы. Спецификатор %q читает текст и не использует двойные кавычки (") в подходящих случаях.

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

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

Возвращенное значение для пустых числовых полей в файлах разделенного текста, заданных как пара, разделенная запятой, состоящая из 'EmptyValue' и скаляра.

Несколько обработка разделителя, заданная как пара, разделенная запятой, состоящая из 'MultipleDelimsAsOne' и или true или false. Если true, то функция импорта обрабатывает последовательные разделители как единственный разделитель. Повторные разделители, разделенные пробелом, также обработаны как единственный разделитель. Необходимо также задать опцию Delimiter.

Пример: 'MultipleDelimsAsOne', 1

Логический индикатор, определяющий конкатенацию данных, заданную как пара, разделенная запятой, состоящая из 'CollectOutput' и или true или false. Если true, то функция импорта конкатенирует последовательные выходные ячейки того же основного класса MATLAB в единый массив.

Символы, определяющие текст проигнорировать, заданный как пара, разделенная запятой, состоящая из 'CommentStyle' и вектора символа, массива ячеек из символьных векторов, строки или массива строк.

Например, задайте символ, такой как '%', чтобы проигнорировать текст после символа на той же строке. Задайте массив ячеек двух векторов символов, таких как {'/*','*/'}, чтобы проигнорировать любой текст между теми последовательностями.

MATLAB проверяет на комментарии только в начале каждого поля, не в поле.

Пример: CommentStyle

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

Символы экспоненты, заданные как пара, разделенная запятой, состоящая из 'ExpChars' и вектора символа или строки. Символами экспоненты по умолчанию является e, E, d и D.

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

Символы конца строки, заданные как пара, разделенная запятой, состоящая из 'EndOfLine' и вектора символа или строки. Вектором символа должен быть '\r\n', или это должно задать отдельный символ. Общие символы конца строки являются символом новой строки ('\n') или возврат каретки ('\r'). Если вы задаете '\r\n', то функция импорта обрабатывает любой \r, \n и комбинацию двух (\r\n) как символы конца строки.

Последовательностью конца строки по умолчанию является \n, \r или \r\n, в зависимости от содержимого вашего файла.

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

Пример: 'EndOfLine' :'

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

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

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

  • xx является строчным двух-алфавитным кодом ISO 639-1, указывающим на язык

Для списка общих ценностей для локали смотрите аргумент в виде пар "имя-значение" Locale для функции datetime.

При использовании спецификатора формата %D, чтобы считать текст как значения datetime, используйте DateLocale, чтобы задать локаль, в которой readtable должен интерпретировать имена месяца и дня недели и сокращения.

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

Пример: 'DateLocale', 'ja_JP'

Пример: 'DateLocale', "ja_JP"

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

'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 в дополнение к opts настройки импорта, то функция readtable использует заданное значение для аргумента Encoding, заменяя кодирование, заданное в настройках импорта.

Пример: 'Кодирование', 'UTF-8'

Пример: "Кодирование", "UTF-8"

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

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

Тип выходных данных данных длительности от текстовых файлов, заданных как пара, разделенная запятой, состоящая из 'DurationType' и или 'duration' или 'text'.

ЗначениеВведите для импортированных данных длительности
длительность

MATLAB тип данных duration

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

Текст

Если 'DurationType' задан как 'text', то тип для импортированных данных длительности зависит от значения, заданного в параметре 'TextType':

  • Если 'TextType' является 'char', то функция импорта возвращает данные длительности как массив ячеек из символьных векторов.

  • Если 'TextType' является 'string', то функция импорта возвращает данные длительности как массив строк.

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

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

свернуть все

Рабочий лист, чтобы читать, заданный как пара, разделенная запятой, состоящая из 'Sheet' и положительного целого числа, указывающего на индекс рабочего листа или вектор символа или строку, содержащую имя рабочего листа. Имя рабочего листа не может содержать двоеточие (:). Чтобы определить имена листов в файле электронной таблицы, используйте [status,sheets] = xlsfinfo(filename). Для получения дополнительной информации смотрите xlsfinfo.

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

Пример: 'Покройте', 2

Пример: 'Лист', 'MySheetName'

Пример: 'Покройте', "MySheetName"

Типы данных: char | представляет в виде строки | единственный | дважды | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

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

'Corner1:Corner2'

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

Задайте область значений с помощью синтаксиса 'Corner1:Corner2', где Corner1 и Corner2 являются двумя противостоящими углами, которые задают область. Например, 'D2:H4' представляет прямоугольную область 3 на 5 между этими двумя углами D2 и H4 на рабочем листе. Аргумент в виде пар "имя-значение" 'Range' не является чувствительным к регистру, и использует стиль ссылки Excel A1 (см. справку Excel).

Пример: 'Расположитесь', 'Corner1:Corner2'

''

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

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

Пример: Область значений

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

'Row1:Row2'

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

Можно идентифицировать область значений путем определения начала и конечного использования строк указатели строки Excel. Затем readtable автоматически обнаруживает используемую область значений столбца в обозначенных строках. Например, readtable интерпретирует спецификацию области значений '1:7' как инструкция считать все столбцы в используемой области значений в строках 1 - 7 (включительно).

Пример: 'Расположитесь', '1:7'

'Column1:Column2'

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

Можно идентифицировать область значений путем определения начала и конечного использования столбцов указатели столбца Excel. Затем readtable автоматически обнаруживает используемую область значений строки в рамках обозначенных столбцов. Например, readtable интерпретирует спецификацию области значений 'A:F' как инструкция считать все строки в используемой области значений в столбцах A через F (включительно).

Пример: 'Расположитесь', 'A:F'

'NamedRange'

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

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

Пример: 'Расположитесь', 'myTable'

Пример: 'Расположитесь', 'A1:F10'

Пример: 'Расположитесь', "A1:F10"

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

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

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

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

  • tRUE Функция readtable запускает экземпляр Microsoft Excel при чтении файла. Эта установка является значением по умолчанию для систем Windows с установленным Excel.

  • ложь Функция readtable не запускает экземпляр Microsoft Excel при чтении файла. На Windows без Excel, Mac и Linux®, значением по умолчанию является false. При работе в этом режиме функциональность readtable отличается в поддержку форматов файлов и интерактивных функций, таких как формулы и макросы.

UseExcel

tRUE

ложь

Поддерживаемые форматы файлов

.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods

.xls, .xlsx, .xlsm, .xltx, .xltm

Поддержка интерактивных функций, таких как формулы и макросы

Да

Нет

Выходные аргументы

свернуть все

Выведите таблицу, возвращенную как таблица. Таблица может сохранить метаданные, такие как описания, переменные модули, имена переменных и имена строки. Для получения дополнительной информации смотрите раздел Properties table.

Советы

  • Большие файлы в формате XLSX иногда медленно загружают. Для лучшего импорта и производительности экспорта, Microsoft рекомендует, чтобы вы использовали формат XLSB.

Введенный в R2013b

Была ли эта тема полезной?