BlockWerk Documentation
ENNLDEFRESZH
Launch App
📈

Scope

Sinks

Real-time signal plotting block with configurable update frequency and rendering modes. Displays signals directly in the block diagram for interactive visualization.

Simulate in BlockWerk

Interactive sandbox directly in your browser — zero installation, WASM-powered.

Simulate in BlockWerk →

Mathematical Model

N/A\text{N/A}

Inputs & Outputs

Direction ID Label Type Status
→ In signal Signal number Required

Parameters

Parameters Label Type Default Description
title Title text Signal Plot
viewportMode Time window select expanding
windowDuration Window duration (s) number 10
renderMode Update mode select timebased
updateFrequencyHz Refresh rate (Hz) number 10 How often the plot updates visually when in Time-based mode.
maxPoints Max display points number 500000 Limit the number of points drawn to prevent performance drops.
useAutoY Auto-scale Y-axis boolean true Automatically adjust the Y-axis to fit all visible data.
yMin Y-axis minimum number -1
yMax Y-axis maximum number 1
lineWidth Line width number 2.5
showGrid Show grid boolean true
showLegend Show legend boolean false
showPoints Show points boolean false
showStatistics Show statistics boolean false Display min, max, and mean values.
triggerEnabled Trigger boolean false Stabilise periodic waves by aligning the window to a level crossing (time-domain, rolling only).
triggerSource Trigger source (signal index) number 0 Which input signal triggers (0 = first).
triggerLevel Trigger level number 0 Amplitude threshold for the trigger crossing.
triggerEdge Trigger edge select rising Detect crossings on the rising or falling edge.
xyXChannel XY: X signal index number 0 In XY mode, which input signal is the X axis (0 = first).
xyYChannel XY: Y signal index number 1 In XY mode, which input signal is the Y axis.

Usage Examples

Basic Signal Visualization

Step Block → uPlot Display
(Shows step response in real-time)

Transfer Function Response

SignalGenerator → TransferFunction → uPlot Display
(Visualizes system response)

Multi-Signal Comparison

Constant₁ ─┐
           ├→ Sum → uPlot Display
Constant₂ ─┘
(Multiple inputs accumulated in buffer)

Remarks & Best Practices

  • Live mode: Best for short simulations; use Time-based (5–10 Hz) for longer runs to maintain UI responsiveness
  • XY mode: First connected signal becomes X-axis; subsequent signals are Y-axis traces
  • Max display points: Prevents memory issues — when the buffer exceeds this, older points are downsampled
  • Trigger: Stabilises rolling waveforms by aligning the window to a level crossing (rising or falling edge)
  • After simulation only: Zero rendering overhead during simulation; data is fully available once the run completes

Related Components