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

Вход1

Создание входного порта для подсистемы или внешнего ввода.

Тип: Inport

inport1

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

/Basic/Ports & Subsystems/In1

Описание

Блок Inport связывает сигналы вне системы с системой.

Программное обеспечение присваивает номера портов блока Inport в соответствии с этими правилами:

  • Блоки Inport в системе или подсистеме верхнего уровня нумеруются последовательно, начиная с 1.

  • Если вы добавляете блок Inport, он добавляется со следующим доступным номером.

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

Блоки Inport в подсистемах

Блоки Inport в подсистеме представляют собой входы в подсистему. Сигнал, поступающий на входной порт в блоке Подсистема, выходит из связанного блока Inport в этой подсистеме.

Создание повторяющихся блоков Inport

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

Чтобы создать дубликат блока Inport:

  1. На блок-схеме выберите несвязанный блок ввода-вывода, который вы хотите дублировать.

  2. Нажмите и удерживайте клавишу Ctrl и перетащите блок.

  3. Отпустите указатель, а затем выберите пункт Duplicate в контекстном меню.

Вы можете выбрать блок Inport, который имеет дубликаты, чтобы выделить повторяющиеся блоки. Чтобы отобразить связанный блок на открытой диаграмме или новой вкладке, наведите курсор на многоточие, которое появляется после выделения. Затем выберите Related Blocks в меню действий. Когда выбранному блоку соответствует несколько блоков, открывается список связанных блоков. Вы можете отфильтровать список связанных блоков, введя поисковый запрос в текстовое поле. После выбора связанного блока из списка фокус окна переходит на открытую диаграмму или новую вкладку, на которой показан связанный блок.

Порты

Выход

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

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

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

Типы данных: Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128, Bool, Fixed, bus

Параметры

Main

Interpolate — возможность линейной интерполяции выходных данных
выключено (по умолчанию) | включено

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

Чтобы загрузить отдельные данные из рабочей области, в диалоговом окне блока Inport:

  1. Снимите флажок с параметра Interpolate, если он активен.

  2. Установите для параметра Sample time дискретное значение, например 2.

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

Отключение интерполяции позволяет избежать неожиданных значений данных в другие моменты времени моделирования в результате арифметической обработки двойной точности.

Программное обеспечение использует следующие методы интерполяции и экстраполяции:

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

  • Для временных шагов до первой указанной точки данных и после последней указанной точки данных — основное значение.

  • Для сигналов переменного размера для временных шагов до первой указанной точки данных — значение NaN регистрируется для одинарных или двойных типов данных и заземляется для других типов данных. Для временных шагов после последней указанной точки данных программное обеспечение использует базовые значения.

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

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

Interpolate

Значения

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

По умолчанию

выключено
Sample time — интервал между шагами расчета
-1 (по умолчанию) | скаляр

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

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

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

SampleTime

Значения

скаляр

По умолчанию

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

Установите этот флажок, если нужно разделять сигнал (только для подсистем Повторение для каждого). Установка флажка добавляет параметры из раздела Подсистема For Each в меню настроек блока Inport.

Если флажок установлен:

  • Выберите сигналы входных портов, подключенных к блоку For Each Subsystem, для разделения на подмассивы или элементы.

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

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

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

InputPartition

Значения

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

По умолчанию

выключено

Подсистема For Each

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

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

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

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

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

Зависимости

Чтобы использовать этот параметр, установите флажок 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

Signal attributes

Output fixed-point type — выходной тип чисел с фиксированной точкой
Fixed{Int16, 0} (по умолчанию) | валидное описание типа с фиксированной точкой

Укажите выходной тип чисел с фиксированной точкой.

Зависимости

Чтобы появилось данное поле, установите параметру Output data type значение Fixed point.

Output data type — тип выходных данных
Inherit: auto (по умолчанию) | Float16 | Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | Int128 | UInt8 | UInt16 | UInt32 | UInt64 | UInt128 | Inherit: auto | Fixed point

Укажите тип выходных данных.

Тип может быть унаследован, указан напрямую или выражен как объект типа данных.

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

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

OutDataTypeStr

Значение

Float16 | Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | Int128 | UInt8 | UInt16 | UInt32 | UInt64 | UInt128 | Fixed

По умолчанию

Inherit: auto
Signal type — тип выходного сигнала
auto (по умолчанию) | real | complex

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

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

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

SignalType

Значения

auto | real | complex

По умолчанию

auto
Port dimensions (−1 for inherited) — размерность порта
−1 | ()| (a,) | (a, b, …​, z)

Укажите размерность выходного сигнала:

  • −1 — порт может загружать данные для сигнала любых размерностей. Порт наследует размерность от подключенного сигнала.

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

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

  • (R, C) — порт может загружать данные для матричного сигнала, имеющего R строк и C столбцов.

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

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

PortDimensions

Значения

−1 | () | (a,) | (a, b, …​, z)

По умолчанию

−1

Дополнительные возможности

Генерация Си кода: Да

Примеры