Sinks

NumericDisplay Block

Advanced numeric display with formatting

# Numeric Display Block

Description

The NumericDisplay block provides a digital LCD-style readout for displaying numeric values from your simulation in real-time. It reads the input value and displays it with configurable decimal precision and optional min/max tracking.

This is a "sink" block, meaning it receives data but does not pass it on. Large numbers (>= 1e6) and small numbers (< 0.001) are automatically displayed in scientific notation. The text automatically scales to fit the block dimensions.

Mathematical Model

The block implements a simple identity mapping for display purposes:

displayed_value = input(t)

Where:

displayed_value is the number shown on the block
input(t) is the numerical value at the input port

Parameters

precision

The number of decimal places to show for the main value. For example, a precision of 3 shows values like 42.543.

showMinMax

Enable minimum and maximum value tracking. When enabled, the smallest and largest values seen since the start of the simulation are displayed in small text below the main value.

Examples

Precision Tuning

Show a constant PI value with 3 decimals:

Constant (value: 3.14159) → NumericDisplay (precision: 3)

Signal Monitoring

Track the range of a sensor signal:

Sensor → NumericDisplay (showMinMax: true)

Remarks

LCD Look: Classic green-on-black digital instrument appearance.
Auto-Formatting: Automatically switches to scientific notation for extreme values.
Min/Max Reset: Min/Max values are reset when the simulation is stopped and restarted.
Zero Input: Shows "0.00" (depending on precision) when no connection is present.
Deterministic Input: The block reads from the in port specifically. Other ports are ignored. The precision and showMinMax parameters affect display formatting only, not the underlying value passed through.