Engee documentation

In1

Create an input port for a subsystem or external input.

inport1

Description

The Inport block links signals outside the system to the system.

The software assigns port numbers to the Inport block according to these rules:

  • Inport blocks in a higher-level system or subsystem are numbered sequentially starting with 1.

  • If you add an Inport block, it is added with the next available number.

  • If you copy an Inport block to the system, its port number is not renumbered unless its current number conflicts with an input port already existing in the system.

Inport blocks in subsystems

The Inport blocks in a subsystem represent inputs to the subsystem. A signal arriving at an input port in a block Subsystem, exits the associated Inport block in that subsystem.

Creating recurring Inport blocks

You can create any number of duplicate Inport blocks. Duplicates are graphical representations of the original, designed to simplify block diagrams by eliminating unnecessary lines. A duplicate has the same port number, properties, and output data as the original.

To create a duplicate of a block Inport:

  1. From the block diagram, select the unrelated I/O block you want to duplicate.

  2. Press and hold the Ctrl key and drag the block.

  3. Release the pointer, and then select Duplicate from the context menu.

You can select an Inport block that has duplicates to highlight repeated blocks. To display the linked block in an open diagram or a new tab, hover over the multi-dot that appears after selection. Then select Related Blocks from the Actions menu. When more than one block corresponds to the selected block, a list of linked blocks opens. You can filter the list of related blocks by entering a search term in the text box. After selecting a linked block from the list, the window focus moves to the opened diagram or a new tab where the linked block is shown.

Ports

Output

Port_1 - output signal
scalar | vector | matrix | bus

A signal that enters the system through the input port.

You can use the Inport block in the subsystem to provide fixed-point data in the structure or in any other format.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, Int128, UInt8, UInt16, UInt32, UInt64, UInt128, Bool, Fixed, bus

Parameters

Main

Interpolate - possibility of linear interpolation of output data
off (by default) | on

When loading data from the workspace to the root level input block, specify whether the block performs linear interpolation and extrapolation of output data at time steps for which no corresponding data exists.

To load individual data from the workspace, in the Inport block dialogue box:

  1. Uncheck the Interpolate parameters if active.

  2. Set the Sample time parameters to a discrete value, e.g. 2.

Specifying a discrete sample time causes the simulation to have a hit time exactly when the data is sampled. You specify data values, not time values.

Disabling interpolation avoids unexpected data values at other times in the simulation as a result of double precision arithmetic.

The software uses the following interpolation and extrapolation methods:

  • For time steps between the first specified data point and the last specified data point, zero-order retention.

  • For time steps before the first specified data point and after the last specified data point, prime.

  • For variable size signals for time steps up to the first specified data point - `NaN' value is registered for single or double data types and grounded for other data types. For time steps after the last specified data point, the software uses the basic values.

Usage in program code

Block parameter

Interpolate

Values

off | on

By default

off

Sample time - interval between calculation steps
-1 (by default) | scalar

Specify the interval between calculation steps as a non-negative number. To inherit the calculation step, set this parameters to -1.

Usage in program code

Block parameter

SampleTime

Values

scalar

By default

−1

Partition - selection of input port signal for partitioning
disabled (by default) | enabled

Select this checkbox if you want to split the signal (only for subsystems For Each). Checking this box adds parameters from Subsystem For Each to the Inport block settings menu.

When the checkbox is selected:

  • Select the signals of input ports connected to the For Each Subsystem block to be split into subarrays or elements.

  • For each port listed in the Port column, select the appropriate check box to split that signal.

Usage in program code

Block parameter

InputPartition

Values

off | on

By default

off

Subsystem For Each

Partition Dimension - measurement of the input signal array slicing
1 (by default) | 2 | positive integer

Specify the dimension along which the selected input signal array will be sliced. The resulting slices are perpendicular to the specified dimension. The slices divide the array into subarrays or elements as appropriate:

  • Situation 1 - slicing the input array by columns.

  • Situation 2 - slicing the input array by rows.

  • Situation 3 - input array slicing by dimension 3.

Dependencies

To use this parameters, select the Partition checkbox.

Usage in program code

Block parameter

InputPartitionDimension

Values

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

By default

1

Partition Width - width of the signal
1 (by default) | positive integer

Specify the width of each partition slice of the selected input signal.

Dependencies

To use this parameter, select the Partition check box.

Usage in program code

Block parameter

InputPartitionWidth

Values

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

By default

1

Partition Offset - partition offset
0 (by default) | `an integer `

Set the offset for each partition slice of the selected input signal:

  • 0 - no offset between partitions, i.e. the partitions have no gaps between them and do not overlap.

  • ` integer` - specify the partition offset, using a positive integer to specify the gap between the fragments or a negative integer to specify the overlap. The sum of the Partition Offset and Partition Width parameters must be a positive integer.

For example, Partition Width of 3 and Partition Offset of 2 means that each three-element fragment overlaps neighbouring fragments by two elements; whereas Partition Width of 2 and Partition Offset of 1 means that there is a one-element gap between each pair of neighbouring two-element wide fragments.

Dependencies

To use this parameter, select the Partition check box.

Usage in program code

Block parameter

InputPartitionOffset

Values

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

By default

0

Signal attributes

Output fixed-point type - output type of fixed-point numbers
Fixed{Int16, 0} (By default) | valid description of fixed-point type

Specify the output type of fixed-point numbers.

Dependencies

To display this field, set the Output data type parameters to Fixed point.

Output data type - output data type
Inherit: auto (by default) | Float16 | Float32 | Float64 | Int8 | Int16 | Int32 | Int64 | Int128 | UInt8 | UInt16 | UInt32 | UInt64 | UInt128 | Inherit: auto | Fixed point

Specify the type of output data.

The type can be inherited, specified directly, or expressed as a datatype object.

Usage in program code

Block parameter

OutDataTypeStr

Value

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

By default

Inherit: auto

Signal type - output signal type
auto (by default) | real | complex

Specify the output signal type. To inherit the type of signal connected to its input, select auto. Otherwise, select real or complex signal type.

Usage in program code

Block parameter

SignalType

Values

auto | real | complex

By default

auto

Port dimensions (-1 for inherited) - port dimensions
-1 | ()| (a,) | (a, b, …​, z)

Specify the dimensionality of the output signal:

  • -1 - The port can load data for a signal of any dimensionality. The port inherits the dimension from the connected signal.

  • () - the port can load data for a scalar signal, i.e. a signal representing a single value (number).

  • (N,) - the port can load data for a signal representing a vector of dimension N.

  • (R, C) - the port can load data for a matrix signal having `R rows and `C columns.

Usage in program code

Block parameter

PortDimensions

Values

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

By default

−1

Additional options

C code generation: Yes