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

Multiport Selector

Распределитель произвольных подмножеств входных строк или столбцов по нескольким выходным портам.

Тип: Multiport Selector

multiport selector

Путь в библиотеке:

/Signal Operations/Signal Management/Indexing/Multiport Selector

Описание

Блок Multiport Selector извлекает несколько подмножеств строк или столбцов из входной матрицы размера на и распространяет каждую новую подматрицу на отдельный выходной порт. Более подробно см. описание параметров Select и Indices to output.

Порты

Вход

# IN_1 — входной сигнал
скаляр | вектор | матрица

Details

Входной сигнал , заданный как скаляр, вектор длины или матрица размером на .

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128, Boolean, Fixed
Поддержка комплексных чисел

Да

Выход

# OUT_N — подмножества строк или столбцов входных данных
скаляр | вектор | матрица

Details

Подмножества строк или столбцов входного сигнала, передаваемые в каждый выходной порт. Каждая ячейка в массиве Indices to output определяет подмножество строк или столбцов входного сигнала, которое будет передано в соответствующий выходной порт.

Общее количество ячеек в массиве Indices to output определяет количество выходных портов в блоке.

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128, Boolean, Fixed
Поддержка комплексных чисел

Да

Параметры

Основные

# Select — размерность входа
Rows | Columns

Details

Выберите размерность входа:

  • Rows — блок использует указанные индексы для выбора строк матрицы, и все элементы в выбранных строках включаются.

  • Columns — блок использует указанные индексы для выбора столбцов матрицы, и все элементы в выбранных столбцах включаются.

Выбранная входная строка или столбец может появляться любое количество раз в любом из выходов или не появляться вообще.

Если индекс ссылается на несуществующую строку или столбец входа, блок реагирует действием, которое указано в параметре Invalid index.

Значения

Rows | Columns
Значение по умолчанию

Rows
Имя для программного использования

rowsOrCols
Настраиваемый

Нет
Вычисляемый

Нет

# Indices to output — индексы для вывода

Details

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

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

Пример: (4, [1:2; 5], [7; 8], 10:-1:6)

Это массив из четырех ячеек, который требует, чтобы блок генерировал четыре независимых выхода (каждый на отдельный порт). В таблице показаны размерности этих выходов, когда для параметра Select выбрано значение Rows, а размерность входа на .

Ячейка Выражение Описание Размерность выходного сигнала

1

4

Строка 4 входных данных

на

2

[1:2; 5]

Строки 1, 2 и 5 входных данных

на

3

[7;8]

Строки 7 и 8 входных данных

на

4

10:-1:6

Строки 10, 9, 8, 7 и 6 входных данных

на

Значение по умолчанию

(4, [1:2; 5], [7; 8], 10:-1:6)
Имя для программного использования

idxCellArray
Настраиваемый

Нет
Вычисляемый

Да

# Invalid index — действие в случае неверного индекса
Clip index | Generate error

Details

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

  • Clip index — блок сокращает индекс до ближайшего допустимого значения и не выдает предупреждения.

    Например, если блок получает на вход матрицу 64 на 4 и для параметра Select указано значение Rows, то блок обрезает индекс от 72 до 64. Для того же входа, если для параметра Select указано значение Columns, блок обрезает индекс от 72 до 4. В обоих случаях блок вырезает индекс от -2 до 1.

  • Generate error — блок выводит диалоговое окно об ошибке и завершает симуляцию.

Значения

Clip index | Generate error
Значение по умолчанию

Clip index
Имя для программного использования

idxErrMode
Настраиваемый

Нет
Вычисляемый

Нет

Примеры