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

Присваивание

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

assignment

Описание

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

В зависимости от значения, которое вы вводите для параметра Количество размерностей выходного сигнала отображаются настройки для первого и/или второго индекса. Для каждого измерения можно определить элементы сигнала, с которыми нужно работать. Укажите векторный сигнал как одномерный, а матричный – как двумерный. Чтобы включить внешний индексный порт, для соответствующего индекса установите для параметра Метод индексации в значение Вектор индексов (порт) или Начальный индекс (порт).

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

  • для первого индекса: Метод индексации значение Присвоить все;

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

    • Метод индексации значение Вектор индексов (поле ввода);

    • Индекс значение [1 3 5].

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

При использовании блока Присваивание в обычном режиме 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

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

Зависимости

Чтобы использовать этот порт, установите для параметра Метод индексации значение Вектор индексов (порт) или Начальный индекс (порт).

Типы данных

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

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

Да

Параметры

Основные

# Количество размерностей выходного сигнала — количество обрабатываемых размерностей
Целое число

Details

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

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

1

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

NumberOfDimensions

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

Нет

Вычисляемый

Да

# Режим индексации — укажите начальный номер индексации
Нумерация с единицы | Нумерация с нуля

Details

Укажите режим индексации как Нумерация с нуля или Нумерация с единицы.

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

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

Значения

One-based | Zero-based

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

One-based

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

IndexMode

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

Нет

Вычисляемый

Нет

# Инициализация выхода (Y) — метод получения входного сигнала
Инициализировать, используя входной порт <Y0> | Указать размер для каждого измерения в таблице

Details

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

Инициализировать, используя входной порт <Y0> — сигнал на входном порту Y0 инициализирует выходной сигнал.

Указать размер для каждого измерения в таблице — требуется указать ширину выходного сигнала блока в параметре Размер выходного сигнала. Если выход имеет не назначенные элементы, значение этих элементов не определено.

Зависимости

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

Значения

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

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

Initialize using input port <Y0>

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

OutputInitialize

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

Нет

Вычисляемый

Нет

# Действие, если какой-либо выходной элемент не назначен — действие, если не назначены все выходные элементы
Ошибка | Нет

Details

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

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

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

Зависимости

Чтобы использовать этот параметр, установите для параметра Метод индексации значение Вектор индексов (порт) или Начальный индекс (порт) для одного или нескольких измерений, затем установите для параметра Инициализация выхода (Y) значение Указать размер для каждого измерения в таблице.

Значения

Error | None

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

None

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

DiagnosticForDimensions

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

Нет

Вычисляемый

Нет

Index 1

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

Details

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

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

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

  • Вектор индексов (порт) — дальнейшая настройка не требуется.

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

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

При выборе опций Вектор индексов (порт) или Начальный индекс (порт) у блока появляется соответствующий порт и для параметра Инициализация выхода (Y) можно указать одно из этих значений:

  • Инициализировать, используя входной порт <Y0>

  • Указать размер для каждого измерения в таблице

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

Параметры Индекс и Размер выходного сигнала, если они не используются для выбранного режима Метод индексации, просто игнорируются.

Значения

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

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

Index vector (dialog)

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

IndexOptionArray1

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

Нет

Вычисляемый

Нет

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

Details

Если параметр Метод индексации равен Вектор индексов (поле ввода), введите индекс каждого интересующего вас элемента.

Если параметр Метод индексации равен Начальный индекс (поле ввода), введите начальный индекс диапазона элементов, которые необходимо выбрать. Количество элементов от начальной точки определяется размером этого измерения в U.

Зависимости

Чтобы использовать этот параметр, установите для параметра Метод индексации значение Вектор индексов (поле ввода) или Начальный индекс (поле ввода).

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

1

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

IndexParamArray1

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

Нет

Вычисляемый

Да

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

Details

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

Зависимости

Чтобы использовать этот параметр, установите для параметра Инициализация выхода (Y) значение Указать размер для каждого измерения в таблице.

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

1

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

OutputSizeArray1

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

Нет

Вычисляемый

Да

Index 2

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

Details

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

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

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

  • Вектор индексов (порт) — дальнейшая настройка не требуется.

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

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

При выборе опций Вектор индексов (порт) или Начальный индекс (порт) у блока появляется соответствующий порт и для параметра Инициализация выхода (Y) можно указать одно из этих значений:

  • Инициализировать, используя входной порт <Y0>

  • Указать размер для каждого измерения в таблице

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

Параметры Индекс и Размер выходного сигнала, если они не используются для выбранного режима Метод индексации, просто игнорируются.

Зависимости

Чтобы использовать этот параметр, установите для параметра Количество размерностей выходного сигнала значение больше 1.

Значения

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

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

Index vector (dialog)

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

IndexOptionArray2

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

Нет

Вычисляемый

Нет

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

Details

Если параметр Метод индексации равен Вектор индексов (поле ввода), введите индекс каждого интересующего вас элемента.

Если параметр Метод индексации равен Начальный индекс (поле ввода), введите начальный индекс диапазона элементов, которые необходимо выбрать. Количество элементов от начальной точки определяется размером этого измерения в U.

Зависимости

Чтобы использовать этот параметр, установите для параметра Количество размерностей выходного сигнала значение больше 1, а для параметра Метод индексации значение Вектор индексов (поле ввода) или Начальный индекс (поле ввода).

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

1

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

IndexParamArray2

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

Нет

Вычисляемый

Да

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

Details

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

Зависимости

Чтобы использовать этот параметр, установите для параметра Количество размерностей выходного сигнала значение больше 1, а для параметра Инициализация выхода (Y) значение Указать размер для каждого измерения в таблице.

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

1

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

OutputSizeArray2

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

Нет

Вычисляемый

Да