Создать расписание из файла
создает расписание, считывая из файла данные, ориентированные на столбцы.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(___,Name,Value)
Чтобы задать определенные параметры импорта для данных, можно либо использовать opts или можно указать пары имя-значение. При указании пар имя-значение в дополнение к opts, то readtimetable поддерживает только следующие пары имя-значение:
Параметры текста и электронной таблицы - ReadVariableNames, RowTimes, SampleRate, TimeStep, StartTime
Параметры только текста - DateLocale, Encoding
Параметры только электронной таблицы - Sheet, UseExcel
Создайте таблицу из текстового файла, разделенного запятыми.
TT = readtimetable('outages.csv');Отображение сводки таблицы. При создании расписания, если вы не указываете параметры для времени строки, то readtimetable функция обнаруживает и обозначает первую переменную datetime или duration в данных, 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.VariableOptionsans =
1x6 heterogeneous VariableImportOptions (TextVariableImportOptions, DatetimeVariableImportOptions, NumericVariableImportOptions) array with properties:
Name
Type
FillValue
TreatAsMissing
QuoteRule
Prefixes
Suffixes
EmptyFieldRule
Измените объект options, чтобы указать нужные типы данных для переменных в данных. Изменение типов данных для переменных Region и Cause к категорической.
opts = setvartype(opts,{'Region','Cause'},{'categorical','categorical'});Использовать readtimetable вместе с объектом options для импорта расписания. Затем отобразите сводку расписания.
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 года. Набор 'PreserveVariableNames' кому true для сохранения пробела в именах переменных и 'TrimNonNumeric' кому true для удаления символа «$» перед числовыми значениями в данных.
TT = readtimetable("quarterlyFinances1999To2019.csv","TimeStep", calquarters(1),"StartTime", datetime(1999, 1, 1),... "PreserveVariableNames", true, "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 - Имя файла для чтенияИмя считываемого файла, указанное как символьный вектор или строковый скаляр.
В зависимости от расположения файла, filename может принять одну из этих форм.
Местоположение | Форма | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Текущая папка или папка на пути MATLAB ® | Укажите имя файла в Пример:
| ||||||||
Файл в папке | Если файл находится не в текущей папке или в папке по пути MATLAB, укажите полный или относительный путь в Пример:
Пример:
| ||||||||
| URL-адрес в Интернете | Если файл указан как URL-адрес унифицированного ресурса Интернета, то Пример:
| ||||||||
Удаленное расположение | Если файл хранится в удаленном местоположении, то
На основе удаленного местоположения,
Дополнительные сведения см. в разделе Работа с удаленными данными. Пример:
|
Если 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Параметры импорта файлов, указанные как SpreadsheetImportOptions, DelimitedTextImportOptions, FixedWidthImportOptions, или XMLImportOptions объект, созданный detectImportOptions функция. opts содержит свойства, управляющие процессом импорта данных. Дополнительные сведения о свойствах каждого объекта см. на соответствующей странице объекта.
| Тип файлов | Продукция |
|---|---|
| Файлы электронных таблиц | SpreadsheetImportOptions объект (доступен только для Sheet, DataRange, и VariableNames свойства) |
| Текстовые файлы | DelimitedTextImportOptions объект |
| Текстовые файлы фиксированной ширины | FixedWidthImportOptions объект |
| XML-файлы | XMLImportOptions объект |
Укажите дополнительные пары, разделенные запятыми 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 | Описание |
|---|---|
Начальная ячейка
| Укажите начальную ячейку для данных в виде символьного или строкового скалярного или двухэлементного числового вектора.
С помощью начальной ячейки функция импорта автоматически определяет объем данных, начиная импорт в начальной ячейке и заканчивая последней пустой строкой или нижним колонтитулом. Пример:
|
Прямоугольный диапазон
| Укажите точный диапазон для чтения с использованием прямоугольного диапазона в одной из этих форм.
Функция импорта считывает только данные, содержащиеся в указанном диапазоне. Все пустые поля в указанном диапазоне импортируются как отсутствующие ячейки. |
Диапазон строк или диапазон столбцов
| Укажите диапазон, определив начальную и конечную строки с помощью номеров строк Excel. Используя указанный диапазон строк, функция импорта автоматически обнаруживает экстент столбца, считывая от первого непустого столбца до конца данных, и создает одну переменную на столбец. Пример:
Можно также указать диапазон, определив начальный и конечный столбцы с помощью букв или цифр столбцов Excel. Используя указанный диапазон столбцов, функция импорта автоматически обнаруживает экстент строки, считывая от первой непустой строки до конца диапазона данных или нижнего колонтитула. Число столбцов в указанном диапазоне должно соответствовать числу, указанному в Пример:
|
Начальный номер строки
| Укажите первую строку, содержащую данные, используя положительный скалярный индекс строки. Используя указанный индекс строки, функция импорта автоматически определяет объем данных, считывая от указанной первой строки до конца диапазона данных или нижнего колонтитула. Пример: |
Именованный диапазон Excel
| В Excel можно создавать имена для идентификации диапазонов в электронной таблице. Например, можно выбрать прямоугольную часть электронной таблицы и вызвать ее Пример:
|
Не указан или пуст
| Если значение не указано, функция импорта автоматически обнаруживает используемый диапазон. Пример:
Примечание.Используемый диапазон относится к прямоугольной части электронной таблицы, которая фактически содержит данные. Функция импорта автоматически обнаруживает используемый диапазон путем обрезки всех начальных и конечных строк и столбцов, не содержащих данных. Текст, который является только пробелом, считается данными и фиксируется в пределах используемого диапазона. |
Типы данных: char | string | double
'TextType' - Тип для импортированных текстовых данных 'char' (по умолчанию) | 'string'Тип для импортированных текстовых данных, указанный как разделенная запятыми пара, состоящая из 'TextType' и либо 'char' или 'string'.
'char' - Импорт текстовых данных в MATLAB в виде векторов символов.
'string' - Импорт текстовых данных в MATLAB в виде массивов строк.
Пример: 'TextType','char'
'DatetimeType' - Тип импортированных данных даты и времени'datetime' (по умолчанию) | 'text' | 'exceldatenum'(только файлы электронных таблиц)Тип импортированных данных даты и времени, указанный как разделенная запятыми пара, состоящая из 'DatetimeType' и одно из этих значений: 'datetime', 'text', или 'exceldatenum'. Стоимость 'exceldatenum' применима только для файлов электронных таблиц и недопустима для текстовых файлов.
| Стоимость | Тип импортированных данных даты и времени |
|---|---|
'datetime' | MATLAB Дополнительные сведения см. в разделе |
'text' | Если
|
'exceldatenum' | Серийные номера Excel Порядковый номер даты - это одно число, равное количеству дней от заданной ссылочной даты. Серийные номера Excel используют другую ссылочную дату, чем серийные номера MATLAB. Дополнительные сведения о датах Excel см. в разделе |
Типы данных: char | string
'TreatAsMissing' - Текст для интерпретации как отсутствующие данныеТекст для интерпретации как отсутствующие данные, заданный как символьный вектор, строковый скаляр, массив ячеек символьных векторов или строковый массив.
Пример: 'TreatAsMissing',{'NA','TBD'} предписывает функции импорта обрабатывать любое возникновение NA или TBD как отсутствующие поля.
Типы данных: char | string | cell
'ReadVariableNames' - Считать первую строку как имена переменныхtrue | falseСчитывайте первую строку как имена переменных, указанные как пара, разделенная запятыми, состоящая из 'ReadVariableNames' и либо true или false. Если не указано, функция импорта автоматически обнаруживает наличие имен переменных.
Индикатор | Описание |
|---|---|
| Используется, когда первая строка области для чтения содержит имена переменных для таблицы. Функция импорта создает переменную с обнаруженным именем переменной для каждого столбца в |
| Используется, когда первая строка считываемой области содержит данные в таблице. Функция импорта создает имена переменных по умолчанию для формы |
| Неуказанный | Если не указано, функция импорта автоматически обнаруживает true или false и принимает соответствующие меры. |
При указании ReadVariableNames пара имя-значение в дополнение к opts, затем функция импорта выполняется следующим образом.
Если ReadVariableNames имеет значение true, то функция импорта считывает имена переменных из указанного файла с помощью VariableNamesRange или VariableNamesLine свойства объекта параметров импорта.
Если ReadVariableNames имеет значение false, то функция импорта считывает имена переменных из VariableNames свойства объекта параметров импорта.
Типы данных: logical
'RowTimes' - Переменная времени строкиПеременная времени строки, заданная как разделенная запятыми пара, состоящая из 'RowTimes' и имя переменной или вектор времени.
Имя переменной должно быть символьным вектором или строковым скаляром, содержащим имя любой переменной во входной таблице, содержащей datetime или duration значения. Переменная, указанная именем переменной, предоставляет метки времени строки для строк. Остальные переменные входной таблицы становятся переменными расписания.
Вектор времени должен быть datetime вектор или duration вектор. Число элементов вектора времени должно равняться числу строк входной таблицы. Значения времени в векторе времени не обязательно должны быть уникальными, отсортированными или регулярными. Все переменные входной таблицы становятся переменными расписания.
Типы данных: char | string | datetime | duration
'SampleRate' - Частота выборки для времени строкиЧастота выборки для времени строки, указанная как пара, разделенная запятыми, состоящая из 'SampleRate' и положительный числовой скаляр. Частота дискретизации - это число выборок в секунду (Гц) вектора времени выходного расписания.
При использовании 'SampleRate' для указания вектора времени строки расписания по умолчанию время первой строки (время начала) равно нулю секунды. Чтобы задать время начала, отличное от нуля, укажите'StartTime' пара имя-значение.
Типы данных: double
'TimeStep' - Шаг времени между временами строкВременной шаг между временами строк, указанный как пара, разделенная запятыми, состоящая из 'TimeStep' и скаляр длительности или скаляр calendarDuration. Значение 'TimeStep' параметр определяет промежуток времени между последовательными временами строк. Функция импорта использует значение шага времени для вычисления времени строки с регулярным интервалом.
При использовании 'TimeStep' для указания вектора времени строки расписания по умолчанию время первой строки (время начала) равно нулю секунды. Чтобы задать время начала, отличное от нуля, укажите 'StartTime' пара имя-значение.
Если 'TimeStep' является значением длительности календаря, то 'StartTime' должно быть значением datetime.
Типы данных: duration | calendarDuration
'StartTime' - Время начала времени строкиВремя начала времени строки, указанное как разделенная запятыми пара, состоящая из StartTime и скаляр datetime или скаляр длительности.
Чтобы определить вектор времени для расписания, используйте 'StartTime' с помощью 'SampleRate' или 'TimeStep' аргументы пары имя-значение.
Тип данных начального времени определяет тип данных вектора времени строки.
Если время начала является значением datetime, то время строки расписания является значением datetime.
Если время начала является значением длительности, то время строки является длительностью.
Типы данных: datetime | duration
'VariableNamingRule' - Флаг для сохранения имен переменных'modify' (по умолчанию) | 'preserve'Флаг для сохранения имен переменных, указанный как разделенная запятыми пара, состоящая из VariableNamingRule и либо 'modify' или 'preserve'.
'modify' - Преобразовать недопустимые имена переменных (согласно определению isvarname к допустимым идентификаторам MATLAB.
'preserve' - Сохранение имен переменных, которые не являются допустимыми идентификаторами MATLAB, например имен переменных, содержащих пробелы и символы, не относящиеся к ASCII.
Начиная с R2019b имена переменных и строк могут содержать любые символы, включая пробелы и символы, не относящиеся к ASCII. Кроме того, они могут начинаться с любых символов, а не только букв. Имена переменных и строк не должны быть допустимыми идентификаторами MATLAB (согласно определению isvarname функция). Чтобы сохранить эти имена переменных и строк, задайте значение VariableNamingRule кому 'preserve'.
Типы данных: 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' или имя стандартной схемы кодирования символов. Если кодировка не указана, readtimetable функция использует автоматическое обнаружение набора символов для определения кодировки при чтении файла.
При указании 'Encoding' в дополнение к параметрам импорта, затем readtimetable функция использует указанное значение для 'Encoding'переопределение кодировки, определенной в параметрах импорта.
Пример: 'Encoding','UTF-8' использует UTF-8 в качестве кодировки.
Пример: 'Encoding','system' использует системную кодировку по умолчанию.
Типы данных: char | string
'DurationType' - Тип выходных данных данных длительности'duration' (по умолчанию) | 'text'Тип выходных данных длительности из текстовых файлов, указанный как разделенная запятыми пара, состоящая из 'DurationType' и либо 'duration' или 'text'.
| Стоимость | Тип для импортированных данных длительности |
|---|---|
'duration' | MATLAB Дополнительные сведения см. в разделе |
'text' | Если
|
Типы данных: char | string
'DateLocale' - Языковой стандарт для чтения датЯзыковой стандарт для чтения дат, указанный как пара, разделенная запятыми, состоящая из 'DateLocale' и вектор символов или строковый скаляр формы , где:xx_YY
YY является верхним кодом ISO 3166-1 альфа-2, указывающим страну.
xx - строчный двухбуквенный код ISO 639-1, указывающий язык.
Список общих значений для языкового стандарта см. в разделе Locale аргумент пары имя-значение для datetime функция.
При использовании %D спецификатор формата для чтения текста как datetime значения, использование DateLocale для указания языкового стандарта, в котором функция импорта должна интерпретировать имена и сокращения месяца и дня недели.
При указании DateLocale аргумент в дополнение к opts параметры импорта, затем функция импорта использует указанное значение для DateLocale , переопределяя языковой стандарт, определенный в параметрах импорта.
Пример: 'DateLocale','ja_JP'
'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.
Типы данных: logical
'ConsecutiveDelimitersRule' - Процедура обработки последовательных разделителей'split' | 'join' | 'error'Процедура обработки последовательных разделителей в текстовом файле с разделителями, указанном как одно из значений в этой таблице.
| Правило последовательных разделителей | Поведение |
|---|---|
'split' | Разделите последовательные разделители на несколько полей. |
'join' | Соедините разделители в один. |
'error' | Возвращает ошибку и прерывает операцию импорта. |
Типы данных: char | string
'LeadingDelimitersRule' - Процедура управления ведущими разделителями'keep' | 'ignore' | 'error'Процедура управления ведущими разделителями в текстовом файле с разделителями, указанном как одно из значений в этой таблице.
| Правило ведущих разделителей | Поведение |
|---|---|
'keep' | Сохранить разделитель. |
'ignore' | Игнорировать разделитель. |
'error' | Возвращает ошибку и прерывает операцию импорта. |
'TrailingDelimitersRule' - Процедура управления задними разделителями'keep' | 'ignore' | 'error'Процедура управления конечными разделителями в текстовом файле с разделителями, указанном как одно из значений в этой таблице.
| Правило ведущих разделителей | Поведение |
|---|---|
'keep' | Сохранить разделитель. |
'ignore' | Игнорировать разделитель. |
'error' | Возвращает ошибку и прерывает операцию импорта. |
'Sheet' - Лист для чтения из'' пустой символьный массив (по умолчанию) | символьный вектор | строковый скалярный | положительное скалярное целоеСчитываемый лист, указанный как пустой символьный массив, вектор символов или строковый скаляр, содержащий имя листа, или положительное скалярное целое число, обозначающее индекс листа. На основе значения, указанного для Sheet функция импорта ведет себя так, как описано в таблице.
| Спецификация | Поведение |
|---|---|
'' (по умолчанию) | Импорт данных с первого листа. |
| Имя | Импорт данных из соответствующего имени листа независимо от порядка листов в файле электронной таблицы. |
| Целое число | Импорт данных с листа в положение, обозначенное целым числом, независимо от имен листов в файле электронной таблицы. |
Типы данных: char | string | single | double
'UseExcel' - Флажок для запуска экземпляра Microsoft Excel для Windowsfalse (по умолчанию) | trueФлажок для запуска экземпляра Microsoft Excel для Windows при чтении данных электронной таблицы, указанного как пара, разделенная запятыми, состоящая из 'UseExcel' и либо true, или false.
Можно установить 'UseExcel' для одного из следующих значений:
true - Функция импорта запускает экземпляр Microsoft Excel при чтении файла.
false - Функция импорта не запускает экземпляр Microsoft Excel при чтении файла. При работе в этом режиме функциональность функции импорта отличается поддержкой форматов файлов и интерактивных функций, таких как формулы и макросы.
UseExcel |
|
|
|---|---|---|
| Поддерживаемые форматы файлов |
|
|
Поддержка интерактивных функций, таких как формулы и макросы | Да | Нет |
При чтении из файлов электронных таблиц на платформах Windows, если требуется запустить экземпляр Microsoft Excel, установите 'UseExcel' параметр для true.
'AttributeSuffix' - суффикс атрибута'Attribute' (по умолчанию) | символьный вектор | строковый скалярсуффикс атрибута, указанный как пара, разделенная запятыми, состоящая из 'AttributeSuffix' и либо вектор символов, либо строковый скаляр. Этот аргумент указывает суффикс, который функция чтения добавляет ко всем переменным таблицы, соответствующим атрибутам во входном XML-файле. Если не указать 'AttributeSuffix', то функция чтения по умолчанию добавляет суффикс 'Attribute' ко всем именам переменных, соответствующим атрибутам во входном XML-файле.
Пример: 'AttributeSuffix','_att'
'ImportAttributes' - Импорт атрибутов1 или true (по умолчанию) | логический 0 или falseИмпорт атрибутов, указанных как разделенная запятыми пара, состоящая из 'ImportAttributes' и либо 1 (true) или 0 (false). При указании false, то функция чтения не будет импортировать атрибуты XML во входной файл как переменные в выходной таблице.
Пример: 'ImportAttributes',false
'RowNodeName' - Имя узла XML строки таблицыИмя XML-узла строки таблицы, указанное как разделенная запятыми пара, состоящая из 'RowNodeName' и либо вектор символов, либо строковый скаляр. Этот аргумент указывает имя узла XML, которое определяет строки выходной таблицы.
Пример: 'RowNodeName','XMLNodeName'
'RowSelector' - Выражение XPath строки таблицыВыражение XPath строки таблицы, указанное как вектор символов или скаляр строки, используемый функцией чтения для выбора отдельных строк выходной таблицы. Необходимо указать RowSelector как допустимое выражение XPath версии 1.0.
Пример: 'RowSelector','/RootNode/ChildNode'
'VariableNodeNames' - Имена узлов XML переменной таблицыИмена XML-узлов переменной таблицы, указанные как разделенная запятыми пара, состоящая из 'VariableNodeNames' и либо массив ячеек из символьных векторов, либо строковый массив. Этот аргумент указывает имя узла XML, которое функция чтения использует для идентификации узлов XML, которые будут считываться как переменные в выходной таблице.
Пример: 'VariableNodeNames',{'XMLNodeName1','XMLNodeName2'}
Пример: 'VariableNodeNames',"XMLNodeName"
Пример: 'VariableNodeNames',["XMLNodeName1","XMLNodeName2"]
'VariableSelectors' - Табличная переменная XPath-выраженияВыражения XPath табличной переменной, указанные как массив ячеек символьных векторов или строковый массив, используемый функцией чтения для выбора табличных переменных. Необходимо указать VariableSelectors как допустимые выражения XPath версии 1.0.
Пример: 'VariableSelectors',{'/RootNode/ChildNode'}
Пример: 'VariableSelectors',"/RootNode/ChildNode"
Пример: 'VariableSelectors',["/RootNode/ChildNode1","/RootNode/ChildNode2"]
'TableNodeName' - Имя узла XML таблицыИмя узла XML таблицы, указанное как разделенная запятыми пара, состоящая из 'TableNodeName' и либо вектор символов, либо строковый скаляр. Этот аргумент указывает узел в структуре ввода, который функция чтения должна считывать в таблицу.
Пример: 'TableNodeName','NodeName'
'TableSelector' - Выражение XPath табличных данныхВыражение XPath табличных данных, указанное как вектор символов или скаляр строки, используемый функцией чтения для выбора данных выходной таблицы. Необходимо указать TableSelector как допустимое выражение XPath версии 1.0.
Пример: 'TableSelector','/RootNode/ChildNode'
'VariableUnitsSelector' - Выражение XPath переменных единицПеременные единицы XPath, заданные как вектор символов или скаляр строки, используемый функцией чтения для выбора табличных переменных единиц. Необходимо указать VariableUnitsSelector как допустимое выражение XPath версии 1.0.
Пример: 'VariableUnitsSelector','/RootNode/ChildNode'
'VariableDescriptionsSelector' - Описание переменной выражение XPathВыражение XPath описаний переменных, указанное как вектор символов или скаляр строки, используемый функцией чтения для выбора описаний переменных таблицы. Необходимо указать VariableDescriptionsSelector как допустимое выражение XPath версии 1.0.
Пример: 'VariableDescriptionsSelector','/RootNode/ChildNode'
'RepeatedNodeRule' - Процедура обработки повторяющихся узлов XML'addcol' (по умолчанию) | 'ignore' | 'error'Процедура обработки повторяющихся узлов XML в данной строке таблицы, указанная как 'addcol', 'ignore', или 'error'.
Правило повторяющегося узла | Поведение |
|---|---|
'addcol' | Добавление столбцов для повторяющихся узлов под заголовком переменной в таблице. Указание значения |
'ignore' | Пропустить импорт повторяющихся узлов. |
'error' | Вывод сообщения об ошибке и прекращение операции импорта. |
Пример: 'RepeatedNodeRule','ignore'
'RegisteredNamespaces' - Набор зарегистрированных префиксов пространства имен XMLНабор зарегистрированных префиксов пространства имен 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”]
TT - График выпускаГрафик выпуска. В расписании могут храниться такие метаданные, как описания, единицы измерения переменных, имена переменных и время строк. Дополнительные сведения см. в разделах «Свойства» timetable.
Следующие синтаксисы XPath поддерживаются для аргументов «имя-значение селектора XPath», таких как RowSelector или VariableSelector.
Чтобы выбрать каждый узел, имя которого соответствует выбранному узлу, независимо от его расположения в документе, используйте "//myNode" синтаксис. Вы можете использовать "//myNode" чтобы опустить выражение XPath, предшествующее узлу, который требуется выбрать.
Чтобы прочитать один из нескольких одноранговых узлов под одним родительским узлом в файле, можно указать ChildNode[, где n]n соответствует одноранговому узлу, который требуется проиндексировать. Например, путь "/RootNode/ChildNode[2]" выбирает второе ChildNode элемент, родительский элемент которого RootNode.
Чтобы считать значение атрибута, принадлежащего узлу элемента во входном XML-файле, укажите @ перед именем атрибута. Например, "/RootNode/ChildNode[2]/@AttributeName" выбирает атрибут AttributeName относится ко второму ChildNode элемент, родительский элемент которого RootNode.
readcell | readmatrix | readtable | readvars | timetable | timetable2table | writetimetable
Имеется измененная версия этого примера. Открыть этот пример с помощью изменений?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.