Переменный выбор

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

variable selector

Описание

Блок Переменный выбор извлекает подмножество строк или столбцов из входной матрицы u размером M на N на каждом входном порту. Количество входных и выходных портов задается в параметре Number of input signals.

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

Если элементы вектора индексации имеют тип данных Bool, блок выполняет логическое индексирование. Установите флажок параметра Fill empty spaces in outputs (for logical indexing), чтобы использовать параметр Fill values. Эти значения добавляются к выходному сигналу, чтобы сделать его длину равной длине входных элементов.

Порты

Вход

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

Details

N-й входной сигнал, где N – количество входов, указанное в параметре Number of input signals.

Типы данных	`Float16` \| `Float32` \| `Float64` \| `Int8` \| `Int16` \| `Int32` \| `Int64` \|`Int128` \| `Uint8` \| `Uint16` \| `Uint32` \| `Uint64` \| `Uint128` \| `Bool` \| `Fixed-point`
Поддержка комплексных чисел	Да

# Idx — вектор индексов
скаляр | вектор

Details

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

Типы данных	`Float16` \| `Float32` \| `Float64` \| `Int8` \| `Int16` \| `Int32` \| `Int64` \|`Int128` \| `Uint8` \| `Uint16` \| `Uint32` \| `Uint64` \| `Uint128` \| `Bool`
Поддержка комплексных чисел	Нет

Выход

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

Details

N-й выходной сигнал, соответствующий N-му входному сигналу, где N – количество входов, заданное в параметре Number of input signals. Выходной сигнал возвращается в виде скаляра, вектора или матрицы того же типа, размера и комплексности, что и соответствующий входной сигнал.

Типы данных	`Float16` \| `Float32` \| `Float64` \| `Int8` \| `Int16` \| `Int32` \| `Int64` \|`Int128` \| `Uint8` \| `Uint16` \| `Uint32` \| `Uint64` \| `Uint128` \| `Bool` \| `Fixed-point`
Поддержка комплексных чисел	Да

Параметры

# Количество входных сигналов — количество входных портов
Вещественное число

Details

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

Значения	`Real number`
Значение по умолчанию	`1`
Имя для программного использования	`NumInputs`
Настраиваемый	Нет

# Выбирать — размерность входа
Строки | Столбцы

Details

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

Rows – блок извлекает строки из каждой входной матрицы;
Columns – блок извлекает столбцы из каждой входной матрицы.

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

Значения	`Rows` \| `Columns`
Значение по умолчанию	`Rows`
Имя для программного использования	`rowsOrCols`
Настраиваемый	Нет

# Режим выбора — режим индексирования
Фиксированный | Переменный

Details

Тип выполняемой операции индексирования. Задается как:

Variable – вектор длиной , подаваемый на вход порта Idx, выбирает строк или столбцов каждого входа для передачи на выход. Вы можете обновлять элементы вектора индексации в каждый период дискретизации, но длина вектора должна оставаться неизменной в течение всего периода симуляции.
Fixed – порт Idx отключен. Вектор длиной , который вы указали в параметре Elements, выбирает строк или столбцов каждого входа для передачи на выход. Параметр Elements является настраиваемым, поэтому вы можете изменять значения элементов вектора индексации в любое время во время симуляции, но длина вектора должна оставаться неизменной.

Значения	`Fixed` \| `Variable`
Значение по умолчанию	`Variable`
Имя для программного использования	`IdxMode`
Настраиваемый	Нет

# Элементы — индексы элементов выходной матрицы
Скаляр / массив вещественных чисел

Details

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

Зависимости

Чтобы использовать этот параметр, установите для параметра Selector mode значение Fixed.

Значения	`Scalar / array of real numbers`
Значение по умолчанию	`[1 3]`
Имя для программного использования	`Elements`
Настраиваемый	Да

# Режим индексации — режим индексирования
Индексация с нуля | Индексация с единицы

Details

Режим индексирования. Задается как:

One-based – значение индекса 1 относится к первой строке или первому столбцу входа.
Zero-based – значение индекса 0 относится к первой строке или первому столбцу входа.

Значения	`Zero-based` \| `One-based`
Значение по умолчанию	`One-based`
Имя для программного использования	`ZerOneIdxMode`
Настраиваемый	Нет

# Неверный индекс — обработка ошибок
Обрезать индекс до ближайшего допустимого значения | Отобразить сообщение об ошибке

Details

Укажите, как блок обрабатывает недопустимое значение индекса. Задается как:

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

Например, если на вход блока подается сигнал `[64, 4] и для параметра Select установлено значение:
- Rows – блок обрезает индекс от 72 до 64.
- Columns – блок обрезает индекс от 72 до 4.
  
  В обоих случаях блок обрезает индекс от -2 до 1.
Generate error – вывод диалогового окна об ошибке и завершение симуляции.

Значения	`Clip Index` \| `Generate Error`
Значение по умолчанию	`Clip index`
Имя для программного использования	`errmode`
Настраиваемый	Нет

# Заполнить пустые места в выходных данных (для логической индексации) — опция заполнения пустых мест в выходных данных
Логический тип

Details

Когда элементы вектора индексации имеют тип данных Bool, блок выполняет логическое индексирование. Логическое индексирование может привести к появлению пустых мест в выходных данных.

Установите этот флажок, чтобы указать значения, которые будут добавлены к выходным данным в параметре Fill values.

Значения	`Logical`
Значение по умолчанию	`true (включено)`
Имя для программного использования	`FillMode`
Настраиваемый	Нет

# Заполнить значения — значения заполнения

Details

Значения заполнения, когда блок выполняет логическое индексирование.

Зависимости

Чтобы использовать этот параметр, установите флажок параметра Fill empty spaces in outputs (for logical indexing).

Значение по умолчанию	`0`
Имя для программного использования	`FillValues`
Настраиваемый	Нет

Литература

Multiport Selector