Simulink.Signal

Задайте атрибуты сигнала

Описание

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

Можно использовать объект сигнала для:

  • Присвойте значения атрибутам сигнала, которые не назначены (имеют значение -1 или auto) источником сигнала.

  • Проверьте атрибуты сигнала, значения которых явно назначены источником сигнала. Такие атрибуты имеют значения, отличные от -1 или auto. Успешная валидация гарантирует, что сигнал имеет атрибуты, которые вы намеревались иметь.

Можно создать Simulink.Signal объект в MATLAB® рабочая область или в рабочем пространстве модели.

Используйте объекты сигнала для назначения или подтверждения атрибутов сигнала или дискретного состояния путем присвоения сигналу или дискретному состоянию того же имени, что и переменной рабочей области, которая ссылается на Simulink.Signal объект.

Для получения дополнительной информации об использовании объектов сигнала смотрите Использование объектов Simulink .Signal для определения и управления атрибутами сигнала и объектами данных.

Создание

Создайте Simulink.Signal объект:

Синтаксис

Описание

signalObj = Simulink.Signal возвращает Simulink.Signal объект со значениями свойств по умолчанию.

Свойства

расширить все

Для получения информации о свойствах в диалоговом окне свойств Simulink.Signal объект, см. Диалоговое окно свойств.

Информация, используемая Simulink® Coder™ для генерации кода для этого сигнала. Значение этого свойства является объектом Simulink.CoderInfo класс.

Для получения дополнительной информации смотрите Строение Генерации кода C для Элементов интерфейса модели (Simulink Coder) и Выберите класс памяти для управления представлением данных в Сгенерированном коде (Embedded Coder).

Вектор символов, задающий числовой тип этого сигнала. Допустимые значения 'auto' (определяется Simulink), 'real', или 'complex'.

Типы данных: char

Вектор символов, задающий тип данных этого сигнала.

Значение по умолчанию, 'auto', указывает, что Simulink должен определять тип данных. Можно задать встроенный тип данных (для примера, 'uint8' или 'single'), тип данных, такой как 'half'или пользовательского типа данных. Чтобы задать пользовательский тип данных, используйте выражение MATLAB, которое задает тип (для примера имя Simulink.NumericType объект, который вы создаете в базовом рабочем пространстве).

Чтобы задать объект шины в качестве типа данных для объекта сигнала, используйте 'Bus: <object_name>' синтаксис. Для получения дополнительной информации о том, что необходимо делать при указании объекта шины в качестве типа данных, см. раздел Поддержка шины.

Пример: 'auto'

Пример: 'int8'

Пример: 'fixdt(1,16,5)'

Пример: 'myAliasTypeObject'

Пример: 'Enum: myEnumType'

Пример: 'Bus: myBusObject'

Типы данных: char

Описание этого сигнала. Это поле предназначено для использования при документировании этого сигнала.

Это свойство используется Simulink Report Generator и для генерации кода.

Если у вас есть Embedded Coder® лицензия, вы можете добавить описание сигнала в качестве комментария для объявления переменной в сгенерированном коде:

  • Задайте класс памяти для объекта сигнала кроме Auto.

  • На панели Code Generation > Comments диалогового окна Параметры конфигурации модели выберите Simulink data object descriptions параметра конфигурации модели. Для получения дополнительной информации см. Описание объекта данных Simulink (Embedded Coder).

Пример: 'This signal represents the rotation speed of the engine.'

Типы данных: char

Скаляр или вектор, определяющий размерности этого сигнала.

Допустимые значения -1 (по умолчанию) с указанием любых размерностей, N определение векторного сигнала размера N, или [M N] установка MxN матричный сигнал.

Чтобы использовать символические размерности, задайте вектор символов.

Пример: [1 3]

Пример: '[1 myDimParam]'

Типы данных: double | char

Размерный режим сигнала. Допустимые значения:

  • 'auto'- Разрешает сигналы переменного и фиксированного размеров.

  • 'Fixed'- Разрешает только сигналы фиксированного размера. Не разрешает использование сигналов переменного размера.

  • 'Variable'- Разрешает только сигналы переменного размера.

Для получения информации о сигналах переменного размера см. «Основы сигнала переменного размера».

Максимальное значение, которое может иметь этот сигнал.

Значение по умолчанию [] (не определено). Задайте конечное, вещественное, двойное, скалярное значение.

Примечание

Если вы задаете объект шины в качестве типа данных для сигнала, не устанавливайте максимальное значение для данных шины в диалоговом окне свойства сигнала. Simulink игнорирует эту настройку. Вместо этого установите максимальные значения для элементов шины объекта шины, заданные как тип данных. Для получения информации о свойстве Maximum элемента шины смотрите Simulink.BusElement.

Simulink использует это значение следующими способами:

  • При обновлении схемы или запуске симуляции Simulink генерирует ошибку, если начальное значение сигнала больше максимального значения или если максимальное значение находится вне области значений типа данных сигнала.

  • Когда вы включаете диагностику Simulation range checking, Simulink предупреждает вас во время симуляции, если значение сигналов больше максимального значения (см. «Проверка диапазона симуляции»).

Пример: 5.32

Типы данных: double

Минимальное значение, которое может иметь этот сигнал.

Значение по умолчанию [] (не определено). Задайте конечное, вещественное, двойное, скалярное значение.

Примечание

Если вы задаете объект шины в качестве типа данных для сигнала, не устанавливайте минимальное значение для данных шины в диалоговом окне свойства сигнала. Simulink игнорирует эту настройку. Вместо этого установите минимальные значения для элементов шины объекта шины, заданные как тип данных. Для получения информации о свойстве Minimum элемента шины смотрите Simulink.BusElement.

Simulink использует это значение следующими способами:

  • При обновлении схемы или запуске симуляции Simulink генерирует ошибку, если начальное значение сигнала меньше минимального значения или если минимальное значение находится вне области значений для типа данных сигнала.

  • Когда вы включаете диагностику Simulation range checking, Simulink предупреждает вас во время симуляции, если значение сигналов меньше минимального значения (см. «Проверка диапазона симуляции»).

Пример: -0.92

Типы данных: double

Сигнал или значение состояния перед тем, как симуляция сделает свой первый временной шаг.

Можно задать любое выражение MATLAB, включая имя переменной рабочей области, которое вычисляет числовой скаляр значение или массив.

В командной строке или в скрипте, даже если вы используете число, задайте начальное значение как вектор символов.

mySigObject.InitialValue='5.3';
mySigObject.InitialValue = 'myNumericVariable';

Чтобы задать начальное значение для сигнала, который использует тип числовых данных, отличный от double, приведите начальное значение к типу данных сигнала. Для примера можно задать 'single(73.3)' использовать 73.3 как начальное значение для сигнала типа данных single.

Если вы используете объект шины в качестве типа данных для объекта сигнала, установите InitialValue в вектор символов, содержащий любой из 0 или структуру MATLAB, которая соответствует объекту шины. Для получения дополнительной информации см. поддержку шины».

Если начальное значение вычисляется в структуре MATLAB, то в диалоговом окне Configuration Parameters установите значение Underspectified initialization detection Simplified.

При необходимости Simulink преобразует начальное значение, чтобы гарантировать соответствие типа, сложности и размерности соответствующим параметрам блоков значению. Если вы задаете недопустимое значение или выражение, при обновлении модели появляется сообщение об ошибке. Кроме того, Simulink выполняет проверку области значений начального значения. Программа предупреждает вас, когда начальное значение сигнала находится вне области значений, которая соответствует его заданным минимальным и максимальным значениям и типу данных.

Классический режим инициализации: В этом режиме начальные настройки для объектов сигнала, которые представляют следующие сигналы и состояния, переопределяют соответствующие начальные значения параметров блоков, если они не определены (заданы как []):

  • Выходные сигналы условно выполненных подсистем и блоков Merge

  • Состояния блока

Упрощенный режим инициализации: В этом режиме, если объект сигнала присоединен к сигнальной линии, соединенной с блоком Outport условно выполненной подсистемы, Simulink использует InitialValue от объекта Simulink.signal.

Пример: '15.23'

Пример: 'myInitParam'

Типы данных: char

Скорость, с которой этот сигнал должен быть обновлен.

Для получения дополнительной информации см. раздел «Задание шага расчета».

Пример: 0.001

Пример: 2

Типы данных: double

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

Для получения дополнительной информации смотрите Спецификацию единиц измерения в Моделях Simulink.

Пример: 'degC'

Типы данных: char

Примеры

Simulink.Signal Примеры

Для примеров, которые показывают, как использовать Simulink.Signal объекты, см. Использование объектов Simulink .Signal для определения и управления атрибутами сигнала и объектами данных.

Расширенные возможности

.

Преобразование с фиксированной точкой
Разрабатывайте и моделируйте системы с фиксированной точкой с помощью Fixed-Point Designer™.

Представлено до R2006a