С помощью инспектора данных моделирования или Simulink ® Test™ можно импортировать данные из файла Microsoft ® Excel ® или экспортировать данные в файл Microsoft Excel. Можно также записать данные в файл Excel с помощью блока «Запись». Инспектор данных моделирования, Simulink Test и блок «Запись» используют один и тот же формат файла, что позволяет использовать один и тот же файл Microsoft Excel с несколькими приложениями.
Совет
Если формат данных в файле Excel не соответствует спецификации в этом разделе, можно записать собственный модуль чтения файлов для импорта данных с помощью io.reader класс.
В простейшем формате первая строка в файле Excel является заголовком, в котором перечислены имена сигналов в файле. Первый столбец - время. Имя столбца времени должно быть timeи значения времени должны увеличиваться монотонно. В строках под названиями сигналов перечислены значения сигналов, соответствующие каждому временному шагу.
Операция импорта не поддерживает данные времени, которые включают Inf или NaN значения или данные сигнала, которые включают Inf значения. Пустое или NaN значения сигналов, импортированные из файла Excel, отображаются как отсутствующие данные в инспекторе данных моделирования. Поддерживаются все встроенные типы данных.
Если данные содержат сигналы с различными векторами времени, файл может содержать несколько векторов времени. Каждый столбец времени должен быть назван time. Столбцы времени определяют время выборки для сигналов справа, вплоть до следующего вектора времени. Например, первый столбец времени определяет время для signal1 и signal2и второй временной столбец определяет временные шаги для signal3.
Столбцы сигнала должны иметь то же количество точек данных, что и соответствующий вектор времени.
Файл может содержать метаданные для таких сигналов, как тип данных, единицы измерения и метод интерполяции. Метаданные для каждого сигнала перечислены в строках между названиями сигналов и данными сигнала. Для каждого сигнала можно указать любую комбинацию метаданных. Оставьте пустую ячейку для сигналов с менее заданными метаданными.
Маркировка каждого фрагмента метаданных в соответствии с этой таблицей. В таблице также указано, какие инструменты и операции поддерживают каждый фрагмент метаданных.
| Свойство сигнала | Этикетка | Ценности | Импорт инспектора расчетных данных | Экспорт инспектора данных регистрации и моделирования блоков записи | Импорт и экспорт теста Simulink |
|---|---|---|---|---|---|
| Тип данных | Type: | Встроенный тип данных. | Поддержанный | Поддержанный | Поддержанный |
| Единицы | Unit: | Поддерживаемый блок. Например, Для получения списка поддерживаемых единиц измерения введите | Поддержанный | Поддержанный | Поддержанный |
| Метод интерполяции | Interp: | linear, zoh для удержания нулевого заказа, или none. | Поддержанный | Поддержанный | Поддержанный |
| Метод синхронизации | Sync: | union или intersection. | Поддержанный | Не поддерживается Метаданные, не включенные в экспортированный файл. | Поддержанный |
| Относительный допуск | RelTol: | Процент, представленный в виде десятичного знака. Например, RelTol: 0.1 задает относительный допуск 10%. | Поддержанный | Не поддерживается Метаданные, не включенные в экспортированный файл. | Поддержанный |
| Абсолютный допуск | AbsTol: | Числовое значение. | Поддержанный | Не поддерживается Метаданные, не включенные в экспортированный файл. | Поддержанный |
| Допуск по времени | TimeTol: | Числовое значение, в секундах. | Поддержанный | Не поддерживается Метаданные, не включенные в экспортированный файл. | Поддержанный |
| Ведущий допуск | LeadingTol: | Числовое значение, в секундах. | Поддержанный Отображается только в Simulink Test. | Не поддерживается Метаданные, не включенные в экспортированный файл. | Поддержанный |
| Допуск отставания | LaggingTol: | Числовое значение, в секундах. | Поддержанный Отображается только в Simulink Test. | Не поддерживается Метаданные, не включенные в экспортированный файл. | Поддержанный |
| Путь к блоку | BlockPath: | Путь к блоку, генерировавшему сигнал. | Поддержанный | Поддержанный | Поддержанный |
| Индекс порта | PortIndex: | Целое число. | Поддержанный | Поддержанный | Поддержанный |
| Имя | Name: | Название сигнала | Поддержанный | Не поддерживается Метаданные, не включенные в экспортированный файл. | Поддержанный |
Если импортированный файл не указывает метаданные сигнала, double тип данных, linear интерполяцию и union используется синхронизация.
В дополнение к встроенным типам данных можно использовать другие метки вместо DataType: для указания типов данных с фиксированной точкой, перечислением, псевдонимом и шиной.
| Тип данных | Этикетка | Ценности | Импорт инспектора расчетных данных | Экспорт инспектора данных регистрации и моделирования блоков записи | Импорт и экспорт теста Simulink |
|---|---|---|---|---|---|
| Перечисление | Enum: | Имя класса перечисления. | Поддержанный Определение класса перечисления должно быть сохранено в пути MATLAB. | Поддержанный Определение класса перечисления должно быть сохранено в пути MATLAB. | Поддержанный Определение класса перечисления должно быть сохранено в пути MATLAB. |
| Псевдоним | Alias: | Имя | Поддержанный Для матричных и комплексных сигналов укажите тип данных псевдонима в первом канале. | Не поддерживается | Поддержанный Для матричных и комплексных сигналов укажите тип данных псевдонима в первом канале. |
| Фиксированная точка | Fixdt: |
| Поддержанный | Не поддерживается | Поддержанный |
| Автобус | Bus: | Имя | Поддержанный | Не поддерживается | Поддержанный |
При указании типа с использованием имени Simulink.Bus объект отсутствует в рабочей области MATLAB, данные по-прежнему импортируются из файла. Однако отдельные сигналы в шине используют типы данных, описанные в файле, а не типы данных, определенные в Simulink.Bus объект.
С помощью файла Excel можно импортировать и экспортировать сложные, многомерные и шинные сигналы. Имя сигнала для столбца данных указывает, являются ли эти данные частью комплексного, многомерного или шинного сигнала. Импорт и экспорт файлов Excel не поддерживают массив сигналов шины.
Имена многомерных сигналов содержат индексную информацию в скобках. Например, имя сигнала для столбца может быть signal1(2,3). При импорте данных из файла, содержащего данные многомерного сигнала, элементы данных, не включенные в файл, принимают нулевые значения выборки с тем же типом данных и сложностью, что и другие элементы.
Комплексные данные сигнала всегда находятся в реальном-мнимом формате. Имена сигналов для столбцов, содержащих сложные данные сигналов, включают (real) и (imag) для указания, какие данные содержатся в каждом столбце. При импорте данных из файла, содержащего данные мнимого сигнала, без указания значений для действительного компонента этого сигнала значения сигнала для действительного компонента по умолчанию равны нулю.
Многомерные сигналы могут содержать сложные данные. Имя сигнала включает в себя индикацию индекса в многомерном сигнале и вещественную или мнимую метку. Например, signal1(1,3)(real).
Точки в названиях сигналов определяют иерархию сигналов шины. Например:
bus.y.a
bus.y.b
bus.x
Совет
Когда имя вашего сигнала включает символы, которые могут сделать его отображаемым, как если бы он был частью матрицы, сложного сигнала или шины, используйте Name параметр метаданных для указания имени, которое будет использоваться импортированным сигналом в инспекторе данных моделирования и Simulink Test.
Данные сигнала, указанные в столбцах перед первым временным столбцом, импортируются как один или несколько сигналов вызова функции. Данные в столбце определяют время активизации сигнала вызова функции. Импортированные сигналы имеют значение 1 для времени, указанного в столбце. Значения времени для сигналов вызова функции должны быть двойными, скалярными и реальными и монотонно увеличиваться.
При экспорте данных из инспектора данных моделирования сигналы вызова функции форматируются так же, как и другие сигналы, со столбцом времени и столбцом для значений сигнала.
Можно импортировать данные для значений параметров, используемых в моделировании. В инспекторе данных моделирования значения параметров отображаются как сигналы. Simulink Test использует импортированные значения параметров для указания значений этих параметров в тестах, которые выполняются на основе импортированных данных.
Данные параметра задаются с помощью двух или трех столбцов. Первый столбец указывает имена параметров с ячейкой в строке заголовка для этого столбца с меткой Parameter:. Второй столбец указывает значение, используемое для каждого параметра, с ячейкой в строке заголовка с меткой Value:. Данные параметра могут также включать в себя третий столбец, который содержит путь блока, связанный с каждым параметром, с ячейкой в строке заголовка, помеченной BlockPath:. Укажите имена, значения и пути блоков для параметров, начиная с первой строки, содержащей данные сигнала, ниже строк, используемых для указания метаданных сигнала. Например, этот файл задает значения для двух параметров, X и Y.
Можно включить данные для нескольких прогонов в один файл. В пределах листа можно разделить данные на участки путем маркировки данных с использованием номера моделирования и типа источника, например: Input или Output. Укажите номер моделирования и тип источника в качестве дополнительных метаданных сигнала с помощью метки Simulation: для номера моделирования и метки Source: для типа источника. Инспектор данных моделирования использует номер моделирования и тип источника только для определения того, какие сигналы принадлежат в каждом прогоне. Simulink Test использует эту информацию для определения входных данных, параметров и критериев приемки для выполнения тестов на основе импортированных данных.
Для каждого сигнала не требуется указывать номер моделирования и тип вывода. Сигналы справа от сигнала с имитационным номером и источником используют один и тот же имитационный номер и источник до следующего сигнала с другим источником или имитационным номером. Например, этот файл определяет данные для двух моделирований и импортирует в четыре прогона в инспекторе данных моделирования:
Прогон 1 содержит signal1 и signal2.
Прогон 2 содержит signal3, X, и Y.
Прогон 3 содержит signal4.
Прогон 4 содержит signal5.
Можно также использовать листы в файле Microsoft Excel для разделения данных на прогоны и тесты. Если номер моделирования и информация об источнике не указаны, данные на каждом листе импортируются в отдельный прогон в Инспекторе данных моделирования. При экспорте нескольких участков из инспектора расчетных данных данные для каждого участка сохраняются на отдельном листе. При импорте файла Microsoft Excel, содержащего данные на нескольких листах, в Simulink Test выдается запрос на указание способа импорта данных.
Simulink.sdi.createRun | Simulink.sdi.exportRun