Формат импорта и экспорта Microsoft Excel

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

Совет

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

Основной формат файла

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

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

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

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

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

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

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

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

Свойство сигнала	Метка	Значения	Инспектор данных моделирования импорт	Инспектор данных моделирования экспорт	Импорт и экспорт 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.	Не поддерживаемый Метаданные, не включенные в экспортируемый файл.	Поддерживаемый
Блок Path	`BlockPath:`	Путь к блоку, который сгенерировал сигнал.	Поддерживаемый	Поддерживаемый	Поддерживаемый
Индекс порта	`PortIndex:`	Целое число.	Поддерживаемый	Поддерживаемый	Поддерживаемый

Когда импортированный файл не задает метаданные сигнала, double тип данных, linear интерполяция и union синхронизация используется.

Пользовательские типы данных

В дополнение к встроенным типам данных можно использовать другие метки вместо DataType: пометьте, чтобы задать фиксированную точку, перечисленную, псевдоним и типы данных шины.

Тип данных	Метка	Значения	Инспектор данных моделирования импорт	Инспектор данных моделирования экспорт	Импорт и экспорт 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 объект.

Комплексный, многомерный, и сигналы шины

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

Многомерные имена сигнала включают информацию об индексе в круглые скобки. Например, именем сигнала для столбца может быть signal1(2,3). Когда вы импортируете данные из файла, который включает многомерные данные сигнала, элементы в данных, не включенных в файл, принимают нулевые демонстрационные значения с совпадающим типом данных и сложностью как другие элементы.

Комплексные данные сигнала всегда находятся в действительно-мнимом формате. Имена сигнала для столбцов, содержащих комплексные данные сигнала, включают (real) и (imag) указать, который содержат данные каждый столбец. Когда вы импортируете данные из файла, который включает мнимые данные сигнала, не задавая значения для действительного компонента того сигнала, значений сигналов для действительного значения по умолчанию компонента, чтобы обнулить.

Многомерные сигналы могут содержать комплексные данные. Имя сигнала включает индикацию для индекса в многомерном сигнале и действительном или мнимом теге. Например, signal1(1,3)(real).

Точки на имена сигнала задают иерархию для сигналов шины. Например:

bus.y.a
bus.y.b
bus.x

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

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

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

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

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

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

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

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

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

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

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

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