Engee documentation

Display

The unit is not recommended for use.

Show the input value.

display

Description

The Display block displays the value of the input data. You can specify the display frequency. For numeric input data, you can also specify the display format.

If the block input is an array, you can resize the block vertically or horizontally to display more than just the first element. If the block input is a vector, the block sequentially adds display fields from left to right and top to bottom. The block displays as many values as possible. A black triangle indicates that the block does not display all elements of the input array.

The Display block displays the first 200 elements of the vector signal and the first 20 rows and 10 columns of the matrix signal.

If you specify a numeric display format that is not large enough to display all digits of a value, the displayed values may lose accuracy. The result depends on your computer hardware and operating system.

Abbreviations

The following abbreviations appear in the Display block to help you define the format of the value.

Abbreviation The value that appears is…​

(SI)

A stored integer value. The (SI) value does not appear when the signal has an integer data type.

hex

In hexadecimal format

bin

In binary format

oct

In octal format

String display

When working with strings, the Display block displays:

  • Strings with double quotes.

  • Special characters such as newline are displayed as escaped sequences, e.g. '\n'.

  • Non-displayable characters as an escaped octal number, such as '\201'.

If the incoming signal is of string type, selecting Numeric display format does not affect the string display.

Ports

Input

Port_1 - input signal
scalar | vector

Enter the data to be displayed.

Data types: Float64.

Parameters

Numeric display format - format for displaying numeric input data
short (By default) | long | short_e | long_e | bank | hex (Stored Integer) | binary (Stored Integer) | decimal (Stored Integer) | octal (Stored Integer)

Specify the format of the numeric data to be displayed.

If you select…​ The block shows…​

short

5-digit scaled value with fixed decimal point.

long

15-digit scaled value with fixed decimal point.

short_e

5-digit floating point value

long_e

16-digit floating point value

bank

Value in fixed dollar and cents format (but without $ or commas).

hex (Stored Integer)

Stored fixed-point integer input value in hexadecimal format.

binary (Stored Integer)

Stored fixed-point integer input value in binary format.

decimal (Stored Integer)

Stored fixed-point integer input value in decimal format.

octal (Stored Integer)

Stored fixed-point integer input value in octal format

If the numeric input to the Display block has an enumerated data type:

  • The block displays enumerated values, not base integer values.

  • Setting Numeric display format for any of the Stored Integer parameters causes an error.

If the incoming signal is of type string, selecting the Numeric display format parameter does not affect the display of the string.

Usage in program code

Block parameter

Format

Value

short | long | short_e | long_e | bank | hex (Stored Integer) | binary (Stored Integer) | decimal (Stored Integer) | octal (Stored Integer)

By default

short

Decimation - display speed
1 (by default) | Integer

Specify how often to display data.

The amount of data displayed and the time intervals at which the data appears depend on the Decimation block parameter and the SampleTime property.

  • The Decimation parameter allows data to be displayed for each n sample th, where n is the thinning factor. The by default decimation (1) displays data at each time step.

    The Display block updates its display at the initial time step, even when the Decimation value is greater than one.

  • The SampleTime property, which can be set with set_param, allows you to specify the interval between calculation steps for displaying points. This property is useful when you are using a variable step solver where the interval between time steps is not the same. The calculation step by default, (-1) causes the block to ignore the interval between calculation steps when determining points to display.

    If the block inherits the Inf calculation step, the Decimation parameter is ignored.

Usage in program code

Block parameter

Decimation

Value

1 | integer

By default

1

Floating display - floating display
off (by default) | on

To use the block as a floating display, select the Floating display checkbox. The block’s input port disappears and the block displays the signal value on the selected line.

If you select Floating display:

  • Disable signal storage reuse for your model.

  • Do not connect a multi-dimensional signal to a floating display.

Usage in program code

Block parameter

Floating

Value

on | off

By default

off