Формат импорта, экспорта и ведения журнала Microsoft Excel

Использование Данных моделирования Inspector или Simulink^® Test™ можно импортировать данные из Microsoft^® Excel^® файл или экспорт данных в файл Microsoft Excel. Можно также записать данные в файл Excel с помощью блока Record. В Данных моделирования Inspector, Simulink Test и блоке Record используется одинаковый формат файла, поэтому можно использовать один и тот же файл Microsoft Excel с несколькими приложениями.

Совет

Когда формат данных в файле Excel не совпадает со спецификацией в этой теме, можно написать свою собственную программу чтения файлов, чтобы импортировать данные с помощью io.reader класс.

Базовый формат файла

В простейшем формате первая строка в файле Excel является заголовком, в котором перечисляются имена сигналов в файле. Первый столбец - это время. Имя столбца времени должно быть time, и значения времени должны увеличиться монотонно. Строки под именами сигналов перечисляют значения сигналов, которые соответствуют каждому временному шагу.

Операция импорта не поддерживает временные данные, которые включают Inf или NaN значения или данные о сигнале, которые включают Inf значения. Пустой или NaN значения сигналов, импортированные из файла Excel, отображаются как отсутствующие данные в Данные моделирования Inspector. Поддерживаются все встроенные типы данных.

Несколько временные векторы

Когда ваши данные включают сигналы с различными временными векторами, файл может включать более одного временные векторы. Каждый столбец времени должен быть назван time. Временные столбцы определяют шаги расчета для сигналов вправо, вплоть до следующего временного вектора. Для примера первый столбец времени определяет время для signal1 и signal2, и второй столбец времени определяет временные шаги для signal3.

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

Метаданные сигнала

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

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

Свойство сигнала	Метка	Значения	Данные моделирования импорта инспектора	Record Блока Logging и экспорт Данных моделирования Inspector	Импорт и экспорт Simulink Test
Тип данных	`Type:`	Встроенный тип данных.	Поддержанный	Поддержанный	Поддержанный
Модули	`Unit:`	Поддерживаемые модули. Для примера, `Unit: m/s` задает модули измерения в секунду. Для списка поддерживаемых модулей введите `showunitslist` в MATLAB^® Командное окно.	Поддержанный	Поддержанный	Поддержанный
Метод интерполяции	`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: метка для задания типов данных с фиксированной точкой, перечисленных, псевдонимов и шины.

Тип данных	Метка	Значения	Данные моделирования импорта инспектора	Record Блока Logging и экспорт Данных моделирования Inspector	Импорт и экспорт Simulink Test
Перечисление	`Enum:`	Имя класса перечисления.	Поддержанный Определение класса перечисления должно быть сохранено в пути MATLAB.	Поддержанный Определение класса перечисления должно быть сохранено в пути MATLAB.	Поддержанный Определение класса перечисления должно быть сохранено в пути MATLAB.
Псевдоним	`Alias:`	Имя `Simulink.AliasType` объект в рабочем пространстве MATLAB.	Поддержанный Для матричных и сложных сигналов задайте тип данных псевдонима на первом канале.	Не поддерживается	Поддержанный Для матричных и сложных сигналов задайте тип данных псевдонима на первом канале.
Фиксированная точка	`Fixdt:`	`fixdt` конструктор. Имя `Simulink.NumericType` объект в рабочем пространстве MATLAB. Имя типа данных с фиксированной точкой, как описано в разделе Номера с фиксированной точкой в Simulink (Fixed-Point Designer).	Поддержанный	Не поддерживается	Поддержанный
Автобус	`Bus:`	Имя `Simulink.Bus` объект в рабочем пространстве MATLAB.	Поддержанный	Не поддерживается	Поддержанный

Когда вы задаете тип, используя имя 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 Опция метаданных, чтобы указать имя, которое должен использовать импортированный сигнал в Данные моделирования Inspector и Simulink Test.

Сигналы вызова функции

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

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

Параметры симуляции

Можно импортировать данные для значений параметров, используемых в симуляции. В Данные моделирования Inspector значения параметров показаны как сигналы. Simulink Test использует импортированные значения параметров, чтобы задать значения для этих параметров в тестах, которые он запускает на основе импортированных данных.

Данные параметра задаются с помощью двух или трех столбцов. Первый столбец задает имена параметров с камерой в строке заголовка для этого маркированного столбца Parameter:. Второй столбец задает значение, используемое для каждого параметра, с меткой камеры в строке заголовка Value:. Данные параметра могут также включать в себя третий столбец, который содержит путь блока, сопоставленный с каждым параметром, с камерой в маркированной строке заголовка BlockPath:. Задайте имена, значения и блочные пути для параметров, начиная с первой строки, которая содержит сигнальные данные, ниже строк, используемых для задания сигнальных метаданных. Для примера этот файл задает значения для двух параметров, X и Y.

Несколько запуски

Можно включать данные для нескольких запусков в один файл. На листе можно разделить данные на запуски путем маркировки данных с номером симуляции и типом источника, таким как Input или Output. Укажите номер симуляции и тип источника в качестве дополнительных метаданных сигнала, используя метку Simulation: для номера симуляции и Source: меток для исходного типа. Данные моделирования Inspector используют номер симуляции и тип источника только, чтобы определить, какие сигналы относятся к каждому запуску. Simulink Test использует информацию, чтобы задать входы, параметры и критерии приемки для тестов, которые выполняются на основе импортированных данных.

Вам не нужно задавать номер симуляции и тип вывода для каждого сигнала. Сигналы справа от сигнала с номером симуляции и источником используют тот же номер симуляции и источник до следующего сигнала с другим номером источника или симуляции. Для примера этот файл определяет данные для двух симуляций и импортирует в четыре запусков в Данные моделирования Inspector:

Run 1 содержит signal1 и signal2.
Run 2 содержит signal3, X, и Y.
Run 3 содержит signal4.
Run 4 содержит signal5.

Можно также использовать листы в файле Microsoft Excel, чтобы разделить данные на запуски и тесты. Когда вы не задаете номер симуляции и исходную информацию, данные на каждом листе импортируются в отдельный запуск в Данные моделирования Inspector. При экспорте нескольких запусков из Данных моделирования Inspector данные для каждого запуска сохраняются на отдельном листе. Когда вы импортируете файл Microsoft Excel, содержащий данные на нескольких листах, в Simulink Test, вам предлагается указать, как импортировать данные.

См. также

Simulink.sdi.createRun | Simulink.sdi.exportRun

Документация