Visualization

Display Block

Multi-purpose numeric display with history and statistics

# Display Block

Description

The Display block shows the current numeric value of a connected signal in a compact, monospace readout. It supports decimal, scientific, and engineering notation with configurable precision, optional unit labels, and value-based colour coding (green for positive, red for negative, configurable ranges).

During simulation the block records a rolling history of samples. After the run completes, clicking the block opens a detailed viewer modal with a full data table, statistics, and a miniature bar chart of recent values — making it useful for quick post-run inspection without adding a dedicated scope.

Parameters

precision

Number of digits shown after the decimal point (or significant figures in scientific/engineering mode). Default: 2.

format

Number notation used for formatting. Accepted values: "decimal", "scientific", "engineering". Default: "decimal".

showMinMax

When true, displays minimum, maximum, and average of all recorded values beneath the main readout. Default: false.

showHistory

When true, renders a miniature bar chart of the most recent samples inside the block. Default: true.

historyLength

Maximum number of past samples shown in the history bar chart and retained for statistics. Default: 10.

unit

Optional unit string appended to the formatted value (e.g. "m/s", "°C"). Default: "" (no unit).

Examples

Monitor a PID controller output

PIDController → Display

Set format to "decimal", precision to 3, and unit to "%" to track a normalised actuator demand in real time.

Inspect a step-response settling value

TransferFunction → Display

Enable showMinMax and set historyLength to 50 to capture the peak overshoot and final settled value in a single run.

Remarks

Sink with passthrough: The Display block has one output port (out) that passes the input signal through unchanged, allowing it to be chained mid-signal without breaking a connection.
Viewer modal: Clicking the block after simulation opens a full data table and statistics panel for deeper inspection.
Live mode: During an active simulation run the main value reads --- and the status indicator pulses; values are recorded internally and rendered once the run stops.
Colour coding: Value colour follows configurable range rules when colorMode is "range"; otherwise positive values are green, negative red, and zero grey.