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

Assignment

Присваивает новые значения указанным элементам сигнала.

Тип: Assignment

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

/Basic/Math Operations/Assignment

Описание

Блок Assignment назначает значения входных сигналов выбранным элементам сигнала. Индексы элементов, которым будут присвоены значения, задаются либо путем ввода параметров индексов в окне параметров блока, либо путем подключения к блоку внешнего источника или источников индексов. Сигнал на порту блока U задает значения, которые должны быть присвоены Y. Блок заменяет указанные элементы Y0 элементами из сигнала данных.

В зависимости от значения, которое вы вводите для параметра Number of output dimensions отображаются настройки параметров для необходимого количества индексов. Для каждого измерения можно определить элементы сигнала, с которыми нужно работать. Укажите векторный сигнал как одномерный, а матричный – как двумерный. Чтобы включить внешний индексный порт, для соответствующего индекса установите для параметра Index option в значение Index vector (port) или Starting index (port).

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

  • для первого индекса: Index option значение Assign all;

  • для второго индекса:

    • Index option значение Index vector (dialog);

    • Index значение [1 3 5].

То присваиваемые значения имеют вид Y[1:end,[1 3 5]]=U.

При использовании блока Assignment в обычном режиме Engee инициализирует выходы блока нулем, даже если в модели они не инициализируются явным образом.

Блок можно использовать для присвоения значений векторным или матричным сигналам.

Порты

Выход

# Y — выходной сигнал с присвоенными значениями
вектор| матрица

Details

Выходной сигнал с присвоенными значениями для указанных элементов.

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

Поддержка комплексных чисел

Да

Вход

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

Details

Сигнал инициализации для выходного сигнала. Если элементу не присвоено другое значение, то значение выходного элемента совпадает со значением этого входного сигнала.

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

Поддержка комплексных чисел

Да

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

Details

Значение, присваиваемое выходному элементу, если оно указано.

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

Поддержка комплексных чисел

Да

# Idx1N — сигнал N-го индекса
скаляр | вектор

Details

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

Зависимости

Чтобы использовать этот порт, установите для параметра Index option значение Index vector (port) или Starting index (port).

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

Поддержка комплексных чисел

Да

Параметры

Основные

# Number of output dimensions — количество обрабатываемых размерностей
Integer

Details

Количество обрабатываемых размерностей ( ), указанное пользователем, должно совпадать с фактическим количеством размерностей входа.

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

1

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

NumberOfDimensions

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

Нет

Вычисляемый

Да

# Index mode — укажите начальный номер индексации
One-based | Zero-based

Details

Укажите режим индексации как Zero-based или One-based.

Для Zero-based индексации индекс 0 задает первый элемент входного вектора. Индекс 1 определяет второй элемент и так далее.

Для One-based индексации индекс 1 задает первый элемент входного вектора. Индекс 2, указывает второй элемент и так далее.

Значения

One-based | Zero-based

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

One-based

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

IndexMode

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

Нет

Вычисляемый

Нет

# Initialize output (Y) — метод получения входного сигнала
Initialize using input port <Y0> | Specify size for each dimension in table

Details

Укажите, как инициализировать выходной сигнал.

Initialize using input port <Y0> — сигнал на входном порту Y0 инициализирует выходной сигнал.

Specify size for each dimension in table — требуется указать ширину выходного сигнала блока в параметре Output size. Если выход имеет не назначенные элементы, значение этих элементов не определено.

Зависимости

Чтобы использовать этот параметр, установите для параметра Index option значение Index vector (port) или Starting index (port) для одного или нескольких измерений.

Значения

Initialize using input port <Y0> | Specify size for each dimension in table

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

Initialize using input port <Y0>

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

OutputInitialize

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

Нет

Вычисляемый

Нет

# Action if any output element is not assigned — действие, если не назначены все выходные элементы
Error | None

Details

Укажите, выдавать ли ошибку, если не назначены все выходные элементы. Варианты включают:

  • None — никаких действий.

  • ErrorEngee завершает симуляцию и отображает ошибку.

Зависимости

Чтобы использовать этот параметр, установите для параметра Index option значение Index vector (port) или Starting index (port) для одного или нескольких измерений, затем установите для параметра Initialize output (Y) значение Specify size for each dimension in table.

Значения

Error | None

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

None

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

DiagnosticForDimensions

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

Нет

Вычисляемый

Нет

Номер 1

# Index option — метод индексации элементов
Assign all | Index vector (dialog) | Index vector (port) | Starting index (dialog) | Starting index (port)

Details

Определяет по размерности входного сигнала, как элементы сигнала должны быть проиндексированы. Из списка выберите:

  • Assign all — дальнейшая настройка не требуется. Все элементы выбраны.

  • Index vector (dialog) — включает параметр Index. Введите вектор индексов элементов. Не выбирайте эту опцию, если входной сигнал переменного размера.

  • Index vector (port) — дальнейшая настройка не требуется.

  • Starting index (dialog) — включает параметры Index и Output size. Введите начальный индекс диапазона элементов для выбора в параметре Index и количество элементов для выбора в параметре Output size. Не выбирайте эту опцию, если входной сигнал переменного размера.

  • Starting index (port) — включает параметр Output size. Введите количество элементов, которые необходимо выбрать, в параметре Output size.

При выборе опций Index vector (port) или Starting index (port) у блока появляется соответствующий порт и для параметра Initialize output (Y) можно указать одно из этих значений:

  • Initialize using input port <Y0>

  • Specify size for each dimension in table

В ином случае Y0 всегда инициализирует выходной порт Y.

Параметры Index и Output size, если они не используются для выбранного режима Index option, просто игнорируются.

Значения

Assign all | Index vector (dialog) | Index vector (port) | Starting index (dialog) | Starting index (port)

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

Index vector (dialog)

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

IndexOptionArray1

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

Нет

Вычисляемый

Нет

# Index — индекс элемента
Scalar / array of integers

Details

Если параметр Index option равен Index vector (dialog), введите индекс каждого интересующего вас элемента.

Если параметр Index option равен Starting index (dialog), введите начальный индекс диапазона элементов, которые необходимо выбрать. Количество элементов от начальной точки определяется размером этого измерения в U.

Зависимости

Чтобы использовать этот параметр, установите для параметра Index option значение Index vector (dialog) или Starting index (dialog).

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

1

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

IndexParamArray1

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

Нет

Вычисляемый

Да

# Output size — ширина выходного сигнала блока
Integer

Details

Задает ширину выходного сигнала блока.

Зависимости

Чтобы использовать этот параметр, установите для параметра Initialize output (Y) значение Specify size for each dimension in table.

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

1

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

OutputSizeArray1

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

Нет

Вычисляемый

Да