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

For Each

Блок управления для подсистем типа For-each.

for each

Описание

Блок For Each — управляющий блок для For Each Subsystem. В частности, блок For Each позволяет блокам внутри For Each Subsystem обрабатывать части входных сигналов. Каждый блок внутри этой подсистемы поддерживает отдельный набор состояний для каждого элемента или подмассива, который он обрабатывает. По мере того как набор блоков подсистемы обрабатывает элементы или подмассивы, подсистема объединяет результаты для формирования выходных сигналов.

Порты

Выход

Partition index — индекс текущего элемента
скаляр

Индекс текущего элемента (начиная с нуля); скаляр.

Типы данных: Int32, Float64

Параметры

Вкладка "Входной раздел"

Port — список входных портов
no default (по умолчанию) | input port name

Этот параметр доступен только для чтения.

Список входных портов, подключенных к блоку For Each Subsystem.

Partition — выбор сигналов входного порта для разделения
выключено (по умолчанию) | включено

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

Программное использование

Параметр блока

InputPartition

Значения

выключено | включено

По умолчанию

выключено

Partition Dimension — укажите измерение нарезки массива входных сигналов
1 (по умолчанию) | 2 | целое положительное число

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

  • Ситуация 1 — нарезка входного массива по столбцам.

  • Ситуация 2 — нарезка входного массива по строкам.

  • Ситуация 3 — нарезка входного массива по размеру n.

Зависимости

Чтобы использовать этот параметр, установите флажок Partition для соответствующего входного порта.

Программное использование

Параметр блока

InputPartitionDimension

Значения

1 | 2 | целое положительное число

По умолчанию

1

Partition Width — укажите ширину сигнала
1 (по умолчанию) | целое положительное число

Укажите ширину каждого фрагмента раздела выбранного входного сигнала.

Зависимости

Чтобы использовать этот параметр, установите флажок Partition для соответствующего входного порта.

Программное использование

Параметр блока

InputPartitionWidth

Значения

1 | целое положительное число

По умолчанию

1

Partition Offset — укажите смещение разделов
0 (по умолчанию) | целое число

Задайте смещение для каждого фрагмента раздела выбранного входного сигнала:

  • 0 — нет смещения между фрагментами раздела, то есть фрагменты раздела не имеют промежутков между собой и не перекрываются.

  • целое число — укажите смещение раздела, используя целое положительное число для указания зазора между фрагментами или целое отрицательное число для указания перекрытия. Сумма значений параметров Partition Offset и Partition Width должна быть положительным целым числом.

Например, Partition Width от 3 и Partition Offset от −2 означает, что каждый трехэлементный фрагмент перекрывает соседние фрагменты на два элемента; в то время как Partition Width от 2 и Partition Offset от 1 означает, что между каждой парой соседних фрагментов шириной два элемента имеется зазор шириной в один элемент.

Зависимости

Чтобы использовать этот параметр, установите флажок Partition для соответствующего входного порта.

Программное использование

Параметр блока

InputPartitionOffset

Значения

0 | целое число

По умолчанию

0

Вкладка "Конкатенация вывода"

Port — список выходных портов
none (по умолчанию) | output port name

Этот параметр доступен только для чтения.

Список выходных портов, подключенных к блоку For Each Subsystem.

Concatenation Dimension — укажите измерение
1 (по умолчанию) | 2 | целое положительное число

Для каждого выходного порта укажите размер, по которому будут складываться результаты блока For Each Subsystem.

  • 1 — сложите результаты в направлении d1, то есть вертикально. Если блок генерирует векторы столбцов, то в результате конкатенации получается один вектор столбцов. Если блок генерирует векторы строк, то в результате конкатенации получается матрица.

  • 2 — сложите результаты в стопку в направлении d2, то есть горизонтально. Если блок генерирует векторы строк, то в результате конкатенации получается один вектор строки. Если блок генерирует векторы строк, то в результате конкатенации получается матрица.

  • n — складывание результатов в стопку в направлении dn.

Программное использование

Параметр блока

OutputConcatenationDimension

Значения

1 | целое число

По умолчанию

1

Другие параметры

Show partition index output port (zero-based indexing) — управление отображением выходного порта
выключено (по умолчанию) | включено

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

  • выключено — скрыть порт вывода.

  • включено — отображать порт вывода на блоке.

Программное использование

Параметр блока

ShowIterationIndex

Значения

выключено | включено

По умолчанию

выключено

Partition index output data type — укажите тип данных индекса раздела
Int32 (по умолчанию) | Float64

Укажите тип данных индекса раздела для выходного порта.

  • Int32 — выберите 32-разрядное целое число со знаком.

  • Float64 — выберите 64-разрядное вещественное число.

Зависимости

Чтобы использовать этот параметр, установите флажок Show partition index output port.

Программное использование

Параметр блока

IterationIndexDataType

Значения

int32 | Float64

По умолчанию

int32

Number of iterations — укажите количество обрабатываемых разделов
−1 (по умолчанию) | целое число

Чтобы обработать подмножество данных, укажите количество фрагментов входного сигнала или массива параметров маски, которые необходимо обработать, иначе укажите −1, чтобы обработать все фрагменты. Число не должно быть больше общего количества доступных срезов.

  • −1 — обработайте все фрагменты.

  • целое число — количество обрабатываемых фрагментов. Например, Number of iterations 3 означает, что обрабатываются только первые 3 среза.

Программное использование

Параметр блока

SpecifiedNumIters

Значения

−1 | целое число

По умолчанию

−1