🔢

NumericDisplay

Sinks

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:

\text{displayed} = u(t)

Where:

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

Inputs & Outputs

Direction	ID	Label	Type	Status
→ In	`in`	Input	number	Required

Parameters

Parameters	Label	Type	Default	Description
`precision`	Precision	number	`2`
`showMinMax`	Show Min/Max	boolean	`false`

Usage 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 & Best Practices

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.

Related Components

Constant: Provide fixed values for testing displays
SignalGenerator: View live signal waveforms
uPlotDisplay: Plot signals over time (graphical display)