readtimetable

Создание объекта Timetable из файла

Описание

пример

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

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

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

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

  • .xml для Расширяемого языка разметки (XML) файлы.

Для текста и файлов электронной таблицы, readtimetable создает одну переменную в TT для каждого столбца в файле и именах переменных чтений из первой строки файла. Для XML-файлов, readtimetable создает одну переменную в T для каждого элемента или узла атрибута, обнаруженного как переменная расписания. Имена переменных соответствуют элементу и названиям атрибута.

readtimetable устанавливает первый столбец типа datetime или duration в табличных данных, чтобы быть временами строки расписания. Остальные столбцы становятся переменными расписания.

пример

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

пример

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

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

  • Текст и параметры электронной таблицы — ReadVariableNamesRowTimes , SampleRate, TimeStepВремя начала

  • Текст только параметры — DateLocale, Encoding

  • Электронная таблица только параметры — Sheet, UseExcel

Примеры

свернуть все

Составьте таблицу из разделенного от запятой текстового файла.

TT = readtimetable('outages.csv');

Отобразите сводные данные таблицы. При создании расписания, если вы не задаете параметров в течение времен строки, затем readtimetable функция обнаруживает и определяет первый datetime или переменную длительности в данных, OutageTime, как переменная времен строки. Остающиеся переменные становятся переменными расписания.

summary(TT)
RowTimes:

    OutageTime: 1468x1 datetime
        Values:
            Min         2002-02-01 12:18 
            Median      2010-03-18 21:05 
            Max         2014-01-15 02:41 

Variables:

    Region: 1468x1 cell array of character vectors

    Loss: 1468x1 double

        Values:

            Min             0       
            Median          180.26  
            Max             23418   
            NumMissing      604     

    Customers: 1468x1 double

        Values:

            Min             0           
            Median          75765       
            Max             5.9689e+06  
            NumMissing      328         

    RestorationTime: 1468x1 datetime

        Values:

            Min             2002-02-07 16:50  
            Median          2010-03-31 10:54  
            Max             2042-09-18 23:31  
            NumMissing      29                

    Cause: 1468x1 cell array of character vectors

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

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

opts = detectImportOptions('outages.csv');
opts.VariableOptions
ans = 
  1x6 heterogeneous VariableImportOptions (TextVariableImportOptions, DatetimeVariableImportOptions, NumericVariableImportOptions) array with properties:

    Name
    Type
    FillValue
    TreatAsMissing
    QuoteRule
    Prefixes
    Suffixes
    EmptyFieldRule

Измените объект опций задать желаемые типы данных для переменных в данных. Измените типы данных для переменных Region и Cause к категориальному.

opts = setvartype(opts,{'Region','Cause'},{'categorical','categorical'});

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

TT = readtimetable('outages.csv',opts);
summary(TT)
RowTimes:

    OutageTime: 1468x1 datetime
        Values:
            Min         2002-02-01 12:18 
            Median      2010-03-18 21:05 
            Max         2014-01-15 02:41 

Variables:

    Region: 1468x1 categorical

        Values:

            MidWest        142   
            NorthEast      557   
            SouthEast      389   
            SouthWest       26   
            West           354   

    Loss: 1468x1 double

        Values:

            Min             0       
            Median          180.26  
            Max             23418   
            NumMissing      604     

    Customers: 1468x1 double

        Values:

            Min             0           
            Median          75765       
            Max             5.9689e+06  
            NumMissing      328         

    RestorationTime: 1468x1 datetime

        Values:

            Min             2002-02-07 16:50  
            Median          2010-03-31 10:54  
            Max             2042-09-18 23:31  
            NumMissing      29                

    Cause: 1468x1 categorical

        Values:

            attack                294   
            earthquake              2   
            energy emergency      188   
            equipment fault       156   
            fire                   25   
            severe storm          338   
            thunder storm         201   
            unknown                24   
            wind                   95   
            winter storm          145   

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

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

opts = detectImportOptions('outages.csv');
preview('outages.csv',opts)
ans=8×6 table
       Region           OutageTime        Loss     Customers     RestorationTime            Cause       
    _____________    ________________    ______    __________    ________________    ___________________

    {'SouthWest'}    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    {'winter storm'   }
    {'SouthEast'}    2003-01-23 00:49    530.14    2.1204e+05                 NaT    {'winter storm'   }
    {'SouthEast'}    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    {'winter storm'   }
    {'West'     }    2004-04-06 05:44    434.81    3.4037e+05    2004-04-06 06:10    {'equipment fault'}
    {'MidWest'  }    2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    {'severe storm'   }
    {'West'     }    2003-06-18 02:49         0             0    2003-06-18 10:54    {'attack'         }
    {'West'     }    2004-06-20 14:39    231.29           NaN    2004-06-20 19:16    {'equipment fault'}
    {'West'     }    2002-06-06 19:28    311.86           NaN    2002-06-07 00:51    {'equipment fault'}

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

TT = readtimetable('outages.csv','RowTimes','RestorationTime');
summary(TT)
RowTimes:

    RestorationTime: 1468x1 datetime
        Values:
            Min             2002-02-07 16:50 
            Median          2010-03-31 10:54 
            Max             2042-09-18 23:31 
            NumMissing      29               

Variables:

    Region: 1468x1 cell array of character vectors

    OutageTime: 1468x1 datetime

        Values:

            Min       2002-02-01 12:18
            Median    2010-03-18 21:05
            Max       2014-01-15 02:41

    Loss: 1468x1 double

        Values:

            Min             0       
            Median          180.26  
            Max             23418   
            NumMissing      604     

    Customers: 1468x1 double

        Values:

            Min             0           
            Median          75765       
            Max             5.9689e+06  
            NumMissing      328         

    Cause: 1468x1 cell array of character vectors

Создайте расписание из файла электронной таблицы и отформатируйте входные данные. Например, создайте расписание из файла quarterlyFinances1999To2019.csv, задайте дату начала меток времени и время между каждым из них и удалите символ "$" из данных.

Считайте данные в файле quarterlyFinances1999To2019.csv как расписание. Задайте отрезок времени между временами строки подряд, чтобы быть одним календарным кварталом, начиная в день 1 января 1999. Установите 'VariableNamingRule' к preserve сохранить пробел в именах переменных и установить 'TrimNonNumeric' к true удалить символ "$" перед числовыми значениями в данных.

TT = readtimetable("quarterlyFinances1999To2019.csv","TimeStep", calquarters(1),"StartTime", datetime(1999, 1, 1),...
    "VariableNamingRule", "preserve", "TrimNonNumeric", true);

Отобразите сводные данные данных.

summary(TT)
RowTimes:

    Time: 80x1 datetime
        Values:
            Min         01-Jan-1999 
            Median      16-Nov-2008 
            Max         01-Oct-2018 

Variables:

    Net Sales: 80x1 double

        Values:

            Min            35066
            Median    1.0407e+05
            Max       1.7684e+05

    Cost of Sales: 80x1 double

        Values:

            Min        18106  
            Median     48624  
            Max        77742  

    Gross Margin: 80x1 double

        Values:

            Min        14563  
            Median     56719  
            Max        99097  

    Research and Development Expenses: 80x1 double

        Values:

            Min        4904.9 
            Median      24637 
            Max         45234 

    Administrative Expenses: 80x1 double

        Values:

            Min        1047.4 
            Median     2015.3 
            Max        2811.5 

    Total Operating Expenses: 80x1 double

        Values:

            Min        5992.5 
            Median      26518 
            Max         48045 

    Net Income: 80x1 double

        Values:

            Min        7634.3 
            Median      28586 
            Max         51051 

    Total Shares: 80x1 double

        Values:

            Min           822 
            Median     1820.5 
            Max          2710 

    Earnings per Share: 80x1 double

        Values:

            Min          6.52 
            Median     15.515 
            Max         24.62 

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

свернуть все

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

В зависимости от местоположения вашего файла, 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

Настройки импорта файла в виде 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' аргумент пары "имя-значение", когда filename не включает расширение файла или если расширение отличается от одного из следующего:

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

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

Пример: 'FileType','text'

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

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

Пример: 'NumHeaderLines',7

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

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

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

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

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

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

Введите для данных об импортируемом тексте в виде разделенной запятой пары, состоящей из 'TextType' и любой 'char' или 'string'.

  • 'char' — Импортируйте текстовые данные в MATLAB как векторы символов.

  • 'string' — Импортируйте текстовые данные в MATLAB как строковые массивы.

Пример: 'TextType','char'

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

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

MATLAB datetime тип данных

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

'text'

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

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

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

'exceldatenum'

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

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

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

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

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

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

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

Индикатор

Описание

true

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

false

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

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

Когда вы задаете ReadVariableNames пара "имя-значение" в дополнение к opts, затем импорт функционирует доходы можно следующим образом.

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

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

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

Переменная времен строки в виде разделенной запятой пары, состоящей из 'RowTimes' и имя переменной или временной вектор.

  • Имя переменной должно быть вектором символов или строковым скаляром, содержащим имя любой переменной во входной таблице, которая содержит datetime или duration значения. Переменная, заданная именем переменной, обеспечивает метки времени строки для строк. Остающиеся переменные входной таблицы становятся переменными расписания.

  • Временным вектором должен быть datetime вектор или duration вектор. Число элементов временного вектора должно равняться количеству строк входной таблицы. Временные стоимости во временном векторе не должны быть уникальными, не отсортированы, или регулярными. Все переменные входной таблицы становятся переменными расписания.

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

Частота дискретизации в течение времен строки в виде разделенной запятой пары, состоящей из 'SampleRate' и положительный числовой скаляр. Частота дискретизации является количеством отсчетов в секунду (Гц) временного вектора выходного расписания.

Когда вы используете 'SampleRate' чтобы задать временной вектор строки расписания, первое время строки по умолчанию (время начала) является нулевой секундой. Чтобы установить время начала кроме нуля, задайте the'StartTime' пара "имя-значение".

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

Временной шаг между временами строки в виде разделенной запятой пары, состоящей из 'TimeStep' и скаляр длительности или calendarDuration скаляр. Значение 'TimeStep' параметр задает отрезок времени между временами строки подряд. Функция импорта использует значение временного шага, чтобы вычислить расположенные с равными интервалами времена строки.

Когда вы используете 'TimeStep' чтобы задать временной вектор строки расписания, первое время строки по умолчанию (время начала) является нулевой секундой. Чтобы установить время начала кроме нуля, задайте 'StartTime' пара "имя-значение".

Если 'TimeStep' календарное значение длительности, затем 'StartTime' должно быть значение datetime.

Типы данных: duration | calendarDuration

Время начала времен строки в виде разделенной запятой пары, состоящей из StartTime и скаляр datetime или скаляр длительности.

Чтобы задать временной вектор для расписания, используйте 'StartTime' с любым 'SampleRate' или 'TimeStep' аргументы в виде пар имя-значение.

Тип данных времени начала, диктует тип данных временного вектора строки.

  • Если время начала является значением datetime, то времена строки расписания являются значениями datetime.

  • Если время начала является значением длительности, то времена строки являются длительностью.

Типы данных: datetime | duration

Отметьте, чтобы сохранить имена переменных в виде любого "modify" или "preserve".

  • "modify" — Преобразуйте недопустимые имена переменных (как определено isvarname функция) к допустимым идентификаторам MATLAB.

  • "preserve" — Сохраните имена переменных, которые не являются допустимыми идентификаторами MATLAB, такими как имена переменных, которые включают символы non-ASCII и пробелы.

Начиная в R2019b, имена переменных и имена строки могут включать любые символы, включая символы non-ASCII и пробелы. Кроме того, они могут начать с любых символов, не только обозначает буквами. Переменная и имена строки не должны быть допустимыми идентификаторами MATLAB (как определено isvarname функция. Чтобы сохранить эти имена переменных и имена строки, установите значение VariableNamingRule к "preserve". Имена переменных не обновляются когда значение VariableNamingRule изменяется от "modify" к "preserve".

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

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

свернуть все

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

Пример: 'Delimiter','|'

Пример: 'Delimiter',{';','*'}

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

Символы, чтобы обработать как пробел в виде вектора символов или строкового скаляра, содержащего один или несколько символов.

Пример: 'Whitespace',' _'

Пример: 'Whitespace','?!.,'

Символы конца линии в виде вектора символов, строкового скаляра, массива ячеек из символьных векторов или массива строк.

Пример: 'LineEnding','\n'

Пример: 'LineEnding','\r\n'

Пример: 'LineEnding',{'\b',':'}

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

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

Например, чтобы проигнорировать текст после знака процента на той же линии, задайте CommentStyle как '%'.

Пример: 'CommentStyle',{'/*'}

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

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

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

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

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

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

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

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

MATLAB duration тип данных

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

'text'

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

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

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

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

Локаль для чтения дат в виде разделенной запятой пары, состоящей из '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',',', затем функция импорта импортирует текст "3,14159" как номер 3.14159.

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

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

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

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

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

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

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

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

ConsecutiveDelimitersRule Поведение
'split'Разделите последовательные разделители в несколько полей.
'join'Соедините разделители в один разделитель.
'error'Возвратите ошибку и прервите операцию импорта.

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

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

LeadingDelimitersRule Поведение
'keep'Сохраните разделитель.
'ignore'Проигнорируйте разделитель.
'error'Возвратите ошибку и прервите операцию импорта.

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

LeadingDelimitersRule Поведение
'keep'Сохраните разделитель.
'ignore'Проигнорируйте разделитель.
'error'Возвратите ошибку и прервите операцию импорта.
Файлы электронной таблицы только

свернуть все

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

СпецификацияПоведение
'' (значение по умолчанию)Импортируйте данные от первого листа.
ИмяИмпортируйте данные с соответствующего имени листа, независимо от порядка листов в файле электронной таблицы.
Целое числоИмпортируйте данные от листа в положении, обозначенном целым числом, независимо от имен листа в файле электронной таблицы.

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

Отметьте, чтобы запустить экземпляр 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.

XML-файлы только

свернуть все

Суффикс атрибута в виде разделенной запятой пары, состоящей из 'AttributeSuffix' и или вектор символов или строковый скаляр. Этот аргумент задает суффикс, который функция чтения добавляет ко всем табличным переменным, которые соответствуют атрибутам во входном XML-файле. Если вы не задаете 'AttributeSuffix', затем значения по умолчанию функции чтения к добавлению суффиксного 'Attribute' ко всем именам переменных, соответствующим атрибутам во входном XML-файле.

Пример: 'AttributeSuffix','_att'

Импортируйте атрибуты в виде разделенной запятой пары, состоящей из 'ImportAttributes' и любой 1 TRUE) или 0 ложь). Если вы задаете false, затем функция чтения не импортирует атрибуты XML во входном файле как переменные в выходной таблице.

Пример: 'ImportAttributes',false

Строка таблицы имя узла XML в виде разделенной запятой пары, состоящей из 'RowNodeName' и или вектор символов или строковый скаляр. Этот аргумент задает имя узла XML, которое формирует рисунок строк выходной таблицы.

Пример: 'RowNodeName','XMLNodeName'

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

Пример: 'RowSelector','/RootNode/ChildNode'

Табличная переменная имена узла XML в виде разделенной запятой пары, состоящей из 'VariableNodeNames' и или массив ячеек из символьных векторов или массив строк. Этот аргумент задает имя узла XML, которое чтение функционирует использование, чтобы идентифицировать узлы XML, чтобы считать как переменные в выходной таблице.

Пример: 'VariableNodeNames',{'XMLNodeName1','XMLNodeName2'}

Пример: 'VariableNodeNames',"XMLNodeName"

Пример: 'VariableNodeNames',["XMLNodeName1","XMLNodeName2"]

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

Пример: 'VariableSelectors',{'/RootNode/ChildNode'}

Пример: 'VariableSelectors',"/RootNode/ChildNode"

Пример: 'VariableSelectors',["/RootNode/ChildNode1","/RootNode/ChildNode2"]

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

Пример: 'TableNodeName','NodeName'

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

Пример: 'TableSelector','/RootNode/ChildNode'

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

Пример: 'VariableUnitsSelector','/RootNode/ChildNode'

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

Пример: 'VariableDescriptionsSelector','/RootNode/ChildNode'

Процедура, чтобы обработать повторенные узлы XML в данной строке таблицы в виде 'addcol', 'ignore', или 'error'.

Повторное правило узла

Поведение

'addcol'

Добавьте столбцы для повторных узлов под переменным заголовком в таблице. Определение значения 'RepeatedNodeRule' как 'addcol' не создает отдельную переменную в таблице для повторного узла.

'ignore'

Пропуск, импортирующий повторные узлы.

'error'Отобразите сообщение об ошибке и прервите операцию импорта.

Пример: 'RepeatedNodeRule','ignore'

Набор зарегистрированных префиксов пространства имен XML в виде разделенной запятой пары, состоящей из RegisteredNamespaces и массив префиксов. Функция чтения использует эти префиксы при оценке выражений XPath на XML-файле. Задайте префиксы пространства имен и их связанные URL как массив строк Nx2. RegisteredNamespaces может использоваться, когда вы также оцениваете выражение XPath, заданное селекторным аргументом значения имени, таким как StructSelector для readstruct, или VariableSelectors для readtable и readtimetable.

По умолчанию функция чтения автоматически обнаруживает префиксы пространства имен, чтобы указать для использования в оценке XPath, но можно также указать новые префиксы пространства имен с помощью RegisteredNamespaces аргумент значения имени. Вы можете указать новый префикс пространства имен, когда узел XML имеет пространство имен URL, но никакой заявленный префикс пространства имен в XML-файле.

Например, оцените выражение XPath на XML-файле под названием example.xml это не содержит префикс пространства имен. Задайте 'RegisteredNamespaces' как ["myprefix", "https://www.mathworks.com"] присваивать префиксный myprefix к URL https://www.mathworks.com.

T = readtable("example.xml", "VariableSelector", "/myprefix:Data",...
 "RegisteredNamespaces", ["myprefix", "https://www.mathworks.com"])

Пример: 'RegisteredNamespaces',["myprefix", "https://www.mathworks.com"]

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

свернуть все

Выведите расписание. Расписание может сохранить метаданные, такие как описания, переменные модули, имена переменных, и времена строки. Для получения дополнительной информации смотрите разделы Свойств timetable.

Советы

  • Используйте селекторы XPath, чтобы задать который элементы документа входа XML импорту. Например, предположите, что вы хотите импортировать XML-файл myFile.xml, который имеет следующую структуру:

    <data>
        <table category="ones">
            <var>1</var>
            <var>2</var>
        </table>
        <table category="tens">
            <var>10</var>
            <var>20</var>
        </table>
    </data>
    
    Эта таблица обеспечивает синтаксисы XPath, которые поддерживаются для аргументов name-value селектора XPath, таких как VariableSelectors или TableSelector.

    Операция выбораСинтаксисПримерРезультат
    Выберите каждый узел, имя которого совпадает с узлом, который вы хотите выбрать, независимо от его местоположения в документе.Снабдите префиксом имя две наклонных черты вправо (//).
    data = readtable('myFile.xml', 'VariableSelectors', '//var')
    data =
    
      4×1 table
    
        var
        ___
    
         1 
         2 
        10 
        20 
    Считайте значение атрибута, принадлежащего узлу элемента.Снабдите префиксом атрибут знак at sign (@).
    data = readtable('myFile.xml', 'VariableSelectors', '//table/@category')
    data =
    
      2×1 table
    
        categoryAttribute
        _________________
    
             "ones"      
             "tens"   
    Выберите определенный узел в наборе узлов.Обеспечьте индекс узла, который вы хотите выбрать в квадратных скобках ([]).
    data = readtable('myFile.xml', 'TableSelector', '//table[1]')
    data =
    
      2×1 table
    
        var
        ___
    
         1 
         2 
    
    Задайте приоритет операций.Добавьте круглые скобки вокруг выражения, которое вы хотите выполнить сначала.
    data = readtable('myFile.xml', 'VariableSelectors', '//table/var[1]')
    data =
    
      2×1 table
    
        var
        ___
    
         1 
        10 
    data = readtable('myFile.xml', 'VariableSelectors', '(//table/var)[1]')
    data =
    
      table
    
        var
        ___
    
         1 

Введенный в R2019a