Создайте timetable из файла
создает расписание путем чтения ориентированных на столбцы данных из файла.TT
= readtimetable(filename
)
readtimetable
определяет формат файла из расширения файла:
.txt
, .dat
, или .csv
для текстовых файлов с разделителями
.xls
, .xlsb
, .xlsm
, .xlsx
, .xltm
, .xltx
, или .ods
для файлов электронной таблицы
.xml
для файлов расширяемого языка разметки (XML).
Для текста и файлов электронной таблицы, readtimetable
создает одну переменную в TT
для каждого столбца в файле и считывает имена переменных из первой строки файла. Для XML- файлов, readtimetable
создает одну переменную в T
для каждого элемента или узла атрибута, обнаруженного как переменная timetable. Имена переменных соответствуют именам элементов и атрибутов.
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.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 года. Задайте '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® путь | Укажите имя файла в Пример:
'myFile.txt' | ||||||||
Файл в папке | Если файл находится не в текущей папке или в папке на пути MATLAB, задайте полное или относительное имя пути в Пример:
Пример:
| ||||||||
URL-адрес Интернета | Если файл задан как однородный интернет-локатор ресурсов (URL), то Пример:
| ||||||||
Удаленное местоположение | Если файл хранится в удаленном местоположении, то
Исходя из удаленного местоположения,
Для получения дополнительной информации см. раздел Работа с удаленными данными. Пример:
|
Если filename
включает расширение файла, затем функция импорта определяет формат файла из расширения. В противном случае необходимо задать 'FileType'
аргументы пары "имя-значение" для указания типа файла.
В Windows® систем с Microsoft® Excel® ПО, функция импорта считывает любой формат файла электронной таблицы Excel, распознанный вашей версией Excel.
Если в вашей системе нет Excel для Windows или если вы используете Online™ MATLAB, функция импорта работает с UseExcel
значение свойства установлено в false
, и читается только .xls, .xlsx, .xlsm, .xltx, and .xltm
файлы.
Для текстовых файлов с разделителями функция импорта преобразует пустые поля в файле в NaN
(для числовой переменной) или пустой символьный вектор (для текстовой переменной). Все линии в текстовом файле должны иметь одинаковое количество разделителей. Функция импорта игнорирует незначительное пустое пространство в файле.
Типы данных: char
| string
opts
- настройки импорта файловSpreadsheetImportOptions
| DelimitedtextImportOptions
| FixedWidthImportOptions
| XMLImportOptions
Настройки импорта файлов, заданные как SpreadsheetImportOptions
, DelimitedTextImportOptions
, FixedWidthImportOptions
, или XMLImportOptions
объект, созданный detectImportOptions
функция. The 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 | Описание |
---|---|
Стартовая камера
| Задайте стартовую камеру для данных в виде вектора символов или строкового скаляра или двухчислового элемента.
Используя стартовую камеру, функция импорта автоматически обнаруживает степень данных, начав импорт в стартовой камере и закончив в последней пустой области значений строки или нижнего колонтитула. Пример:
'A5' |
Прямоугольная область значений
| Укажите точную область значений для чтения с помощью прямоугольной области значений в одной из этих форм.
Функция импорта считывает только данные, содержащиеся в заданной области. Все пустые поля в заданной области импортируются как отсутствующие камеры. |
Область значений строк или область значений столбцов
| Задайте область значений путем идентификации начальной и конечной строк с помощью номеров строк Excel. Используя указанную область значений строк, функция импорта автоматически обнаруживает экстент столбца, считывая из первого непустого столбца в конец данных, и создает по одной переменной на столбец. Пример:
'5:500' Кроме того, укажите область значений путем идентификации начального и конечного столбцов с помощью букв или цифр столбца Excel. Используя заданную область значений столбцов, функция импорта автоматически обнаруживает объем строки, считывая из первой непустой строки в конец данных или нижнего колонтитула. Количество столбцов в заданной области должно совпадать с количеством, заданным в Пример:
'A:K' |
Начальный номер строки
| Укажите первую строку, содержащую данные, используя положительный скалярный индекс строки. Используя указанный индекс строки, функция импорта автоматически обнаруживает степень данных, считывая из указанной первой строки в конец данных или нижнего колонтитула. Пример: |
Именованные Области значений Excel
| В Excel можно создать имена для идентификации областей значений в электронной таблице. Например, можно выбрать прямоугольный фрагмент электронной таблицы и вызвать ее Пример:
'Range','myTable' |
Не заданные или пустые
| Если не задано, функция импорта автоматически обнаруживает используемую область значений. Пример:
'Range','' Примечание: Used Range относится к прямоугольному фрагменту электронной таблицы, которая на самом деле содержит данные. Функция импорта автоматически обнаруживает используемую область значений, обрезая все начальные и конечные строки и столбцы, которые не содержат данных. Текст, который является только белым пространством, рассматривается как данные и захватывается в пределах используемой области значений. |
Типы данных: 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'
и скаляр длительности или скаляр календарной длительности. Значение '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
function) для действительных идентификаторов 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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.