Multiport Switch
Выбирает выходной сигнал на основе управляющего сигнала.
Тип: MultiPortSwitch
Multiport Switch Путь в библиотеке:
|
|
Index Vector Путь в библиотеке:
|
Описание
Блок Multiport Switch определяет, какой из нескольких входов в блок проходит на выход, в зависимости от значения сигнала на первом входе. Первый вход называется входом управления, а остальные — входами данных. Значение управляющего входа определяет, какие входные данные передаются на выход.
В таблице ниже указано, как блок интерпретирует управляющий сигнал и определяет, какой именно входной сигнал будет передан на выход.
Вход управления |
Округление |
Настройка нумерации портов данных |
Поведение блока во время моделирования |
|
---|---|---|---|---|
Индексирование для выбора ввода данных |
Условие выхода за диапазон |
|||
Целое значение |
Нет |
|
Нумерация с нуля |
Сигнал на входе управления меньше |
|
Нумерация с единицы |
Сигнал на входе управления меньше |
||
|
Пользовательская нумерация |
Сигнал на входе управления не соответствует ни одному номеру входа данных. |
||
Нецелое значение |
Блок усекает значение до целого числа путем округления в сторону нуля. |
|
Нумерация с нуля |
Округленное значение входного сигнала меньше |
|
Нумерация с единицы |
Округленное значение входного сигнала меньше |
||
|
Пользовательская нумерация |
Округленное значение входного сигнала не соответствует ни одному номеру входа данных. |
Multiport Switch, сконфигурированный как блок Index Vector
Index Vector является специальной конфигурацией блока Multiport Switch, в которой задается только один вход данных, а управляющий вход отсчитывается с нуля. Выход блока — это элемент входного вектора, индекс которого соответствует управляющему входу. Например, если входной вектор равен [18 15 17 10]
, и управляющий вход равен 3
, то элемент вектора с номером 3
(начиная с нуля), равный 10
, становится значением выходного сигнала.
Чтобы использовать блок Index Vector, установите для параметра Number of data ports значение 1
, а для параметра Data port order значение Zero-based contiguous
.
Как блок обрабатывает ввод управления вне диапазона
Если управляющий сигнал целочисленный и его значение меньше чем typemax(Int)
, то оно принимается вышедшим за пределы допустимого диапазона, если оно не соответствует ни одному номеру входа данных. Если управляющий сигнал не является целочисленным, то его значение принимается вышедшим за пределы допустимого диапазона, если округленное значение не соответствует ни одному индексу порта данных. В обоих случаях поведение блока зависит от настроек Data port for default case и Diagnostic for default case.
Если значение управляющего сигнала больше, чем typemax(Int) , блок преобразует входное значение в целое число.
|
Поведение при моделировании
Следующее поведение применяется только к симуляции модели.
Data port for default case |
Diagnostic for default case |
|
---|---|---|
Нет |
Ошибка |
|
|
Используется последний вход данных и не появляется предупреждений или ошибок. |
Появляется сообщение об ошибке, и моделирование останавливается. |
|
Используется дополнительный вход данных с меткой |
Появляется сообщение об ошибке, и моделирование останавливается. |
Поведение при генерации кода
Следующее поведение относится к генерации кода из модели.
Data port for default case |
Diagnostic for default case |
|
---|---|---|
Нет |
Ошибка |
|
|
Используется последний вход данных. |
Используется последний вход данных. |
|
Используется дополнительный вход данных с меткой |
Используется дополнительный вход данных с меткой |
Правила, определяющие поведение блока
Количество входов данных задается параметром Number of data ports.
-
Если задать Number of data ports равным
1
, то блок ведет себя как блок Selector, а не как Multiport Switch. -
Если задать Number of data ports больше
1
, то блок ведет себя как Multiport Switch. Выход блока представляет входной сигнал, номер которого соответствует значению управляющего входа. Если хотя бы один из входных сигналов является вектором, выход блока является вектором. В этом случае блок расширяет любые скалярные входные параметры до векторов. -
Если все входные сигналы являются скалярными, выходной сигнал также скалярный.
Допущения и ограничения
-
Если входные сигналы блока являются шинами, то их структура на различных портах (имена, типы и размерности) должна полностью совпадать. Чтобы выходная шина имела одну и ту же структуру независимо от того, какую входную шину выбирает блок, запрещается смешивать шины с обычными сигналами.
-
Для работы с шинами значение параметра Number of data ports должно быть не меньше
2
. -
Для шин управляющий сигнал должен быть скаляром.
Подробнее о типах шин читайте Пользовательские типы шин. |
Порты
Вход
#
IN_1 —
управляющий сигнал
скаляр
| вектор
| матрица
Details
Управляющий сигнал, определяющий, какой из входных сигналов проходит на выход.
Типы данных |
|
Поддержка комплексных чисел |
Да |
#
1 —
первый входной сигнал
скаляр
| вектор
| матрица
| шина
Details
Первый вход данных в виде скаляра, вектора, матрицы, массива или шины.
-
Если все входные сигналы — скаляры, то выходной сигнал также является скаляром.
-
Если хотя бы один из входных сигналов является вектором, выход блока является вектором. В этом случае блок расширяет любые скалярные входные сигналы до векторов.
Зависимости
Для работы с шинами значение параметра Number of data ports должно быть ≥ 2.
Типы данных |
|
Поддержка комплексных чисел |
Да |
#
2 —
второй входной сигнал
скаляр
| вектор
| матрица
| шина
Details
Второй вход данных в виде скаляра, вектора, матрицы, массива или шины.
-
Если все входные сигналы — скаляры, то выходной сигнал также является скаляром.
-
Если хотя бы один из входных сигналов является вектором, выход блока является вектором. В этом случае блок расширяет любые скалярные входные сигналы до векторов.
Зависимости
Для работы с шинами значение параметра Number of data ports должно быть ≥ 2.
Типы данных |
|
Поддержка комплексных чисел |
Да |
#
* —
вход данных для значения управляющего сигнала вне диапазона
скаляр
| вектор
| матрица
| шина
Details
Порт входных данных для значения управляющего сигнала вне диапазона в виде скаляра, вектора, матрицы, массива или шины.
Все сигналы на входах данных могут иметь любой тип данных, который поддерживает Engee.
Зависимости
Чтобы создать дополнительный порт входных данных для значения управляющего сигнала вне диапазона, установите для параметра Data port for default case значение Additional data port
. Когда вы устанавливаете для параметра Data port for default case значение Last data port
, блок использует последний порт данных для вывода, когда значение управляющего сигнала не соответствует каким-либо индексам порта данных.
Для работы с шинами значение параметра Number of data ports должно быть ≥ 2.
Типы данных |
|
Поддержка комплексных чисел |
Да |
Параметры
Базовые настройки
#
Data port order —
тип нумерации портов данных
Zero-based contiguous
| One-based contiguous
| Specify indices
Details
Задает тип нумерации портов данных.
-
Zero-based contiguous
— блок начинает отсчет входных портов с нуля. Это значение по умолчанию для блока Index Vector. -
One-based contiguous
— блок начинает отсчет входных портов с единицы. Это значение по умолчанию для блока Multiport Switch. -
Specify indices
— блок использует произвольную нумерацию портов данных.
Зависимости
-
Выбор
Zero-based contiguous
илиOne-based contiguous
включает параметр Number of data ports. -
Выбор
Specify indices
включает параметр Data port indices (e.g. [1,[2,3]]).
Значения |
|
Значение по умолчанию |
|
Имя для программного использования |
|
Настраиваемый |
Нет |
Вычисляемый |
Нет |
#
Number of data ports —
количество портов ввода данных
Int64 integer
Details
Задает количество портов данных. Общее количество входных портов — это число, которое вы задаете, плюс один для входного порта управляющего сигнала и плюс еще один, если вы устанавливаете для Data port for default case значение Additional data port
.
Зависимости
Чтобы использовать этот параметр, установите для параметра Data port order значение Zero-based contiguous
или One-based contiguous
.
Значение по умолчанию |
|
Имя для программного использования |
|
Настраиваемый |
Нет |
Вычисляемый |
Да |
# Data port indices (e.g. [1,[2,3]]) — массив индексов для портов данных
Details
Задает массив индексов входов данных. Значок блока изменится, чтобы соответствовать указанным вами индексам порта данных.
Зависимости
Чтобы использовать этот параметр, установите для параметра Data port order значение Specify indices
.
Значение по умолчанию |
|
Имя для программного использования |
|
Настраиваемый |
Да |
Вычисляемый |
Да |
#
Data port for default case —
входной порт в случае значения управляющего сигнала вне диапазона
Last data port
| Additional data port
Details
Определяет, использовать ли последний порт данных в случае значения управляющего сигнала вне диапазона или использовать дополнительный порт. Звездочка (*) рядом с именем порта указывает порт, который использует блок, когда значение управляющего входа не соответствует ни одному индексу порта данных.
-
Last data port
— блок использует последний порт данных для вывода, когда значение управляющего сигнала не совпадает ни с одним индексом порта данных. -
Additional data port
— блок использует дополнительный порт данных для вывода, когда значение управляющего сигнала не соответствует ни одному индексу порта данных.
Если вы установите для этого параметра значение Additional data port и Number of data ports равно 3, то количество входных портов в блоке будет равно 5. Первый вход — это порт управления, следующие три входа — это порты данных, а пятый вход — это порт по умолчанию в случае значения управляющего сигнала вне диапазона.
|
Значения |
|
Значение по умолчанию |
|
Имя для программного использования |
|
Настраиваемый |
Нет |
Вычисляемый |
Нет |
#
Diagnostic for default case —
диагностическое действие
None
| Error
Details
Определяет диагностическое действие, которое следует предпринять, если значение порта управления не соответствует ни одному из индексов порта данных. Варианты включают:
-
None
— система не предпринимает никаких действий. -
Error
— симуляция останавливается и выводится ошибка. В этом случае Data port for default case используется только для генерации кода, а не моделирования.
Значения |
|
Значение по умолчанию |
|
Имя для программного использования |
|
Настраиваемый |
Нет |
Вычисляемый |
Нет |
Настройки выходного сигнала
#
Output data type —
тип выходных данных
Inherit: auto
| Same as first data input
| Float64
| Float32
| Float16
| Int8
| UInt8
| Int16
| UInt16
| Int32
| UInt32
| Int64
| UInt64
| Int128
| UInt128
| Fixed-point
Details
Укажите тип выходных данных. Можно задать:
-
Наследование типа данных
Inherit: auto
. -
Встроенный тип данных, например,
Float32
. -
Тип данных с фикисрованной точкой
Fixed-point
.
Значения |
|
Значение по умолчанию |
|
Имя для программного использования |
|
Настраиваемый |
Нет |
Вычисляемый |
Нет |
#
Output fixed-point type —
тип выходных данных с фиксированной точкой
Data type
Details
Укажите тип выходных данных с фиксированной точкой.
Зависимости
Чтобы использовать этот параметр, установите для параметра Output data type значение Fixed-point
.
Значение по умолчанию |
|
Имя для программного использования |
|
Настраиваемый |
Нет |
Вычисляемый |
Да |
Основные
#
Integer rounding mode —
режим округления для операций с фиксированной точкой
Ceiling
| Convergent
| Floor
| Nearest
| Round
| Zero
Details
Выберите режим округления для операций с фиксированной точкой. Вы можете выбрать:
-
Floor
— округляет как положительные, так и отрицательные числа в меньшую сторону (в сторону отрицательной бесконечности). -
Ceiling
— округляет как положительные, так и отрицательные числа в большую сторону (в сторону положительной бесконечности). -
Convergent
— округляет число до ближайшего представимого значения. В случае если дробная часть числа оканчивается на 5, число округляется до ближайшего четного целого числа. -
Nearest
— округляет число до ближайшего представимого значения. В случае если дробная часть числа оканчивается на 5, число округляется в большую сторону (в сторону положительной бесконечности). -
Round
— округляет число до ближайшего целого числа.
-
Zero
— округляет число в сторону нуля.
Параметры блока всегда округляют до ближайшего представимого значения.
Значения |
|
Значение по умолчанию |
|
Имя для программного использования |
|
Настраиваемый |
Нет |
Вычисляемый |
Нет |
#
Saturate on integer overflow —
метод действия при переполнении
Logical
Details
При установке этого флажка насыщение применяется ко всем внутренним операциям блока, а не только к выходу или результату.
Действие | Причины для принятия этого решения | Что происходит при переполнении | Пример |
---|---|---|---|
Установите этот флажок. |
В вашей модели возможно переполнение, и вам нужна явная защита от насыщения в генерируемом коде. |
Переполнения насыщаются до минимального или максимального значения, которое может представлять данный тип данных. |
Переполнение, связанное со знаковым 8-битным целым числом, может насытиться до |
Не устанавливайте этот флажок. |
Вы хотите оптимизировать эффективность генерируемого кода. |
Переполнения оборачиваются в соответствующее значение, которое может быть представлено типом данных. |
Число |
Значение по умолчанию |
|
Имя для программного использования |
|
Настраиваемый |
Нет |
Вычисляемый |
Нет |
#
Require all data port inputs to have the same data type —
все входные данные должны иметь одинаковый тип
Logical
Details
Установите этот флажок, чтобы все входные данные имели один и тот же тип данных.
Значение по умолчанию |
|
Имя для программного использования |
|
Настраиваемый |
Нет |
Вычисляемый |
Нет |