Sinks

ScatterPlot Block

Visualizes relationship between two variables

# ScatterPlot Block

Description

The ScatterPlot block plots pairs of scalar values as individual points in a two-dimensional plane. At each simulation step, the current values of the X and Y inputs are recorded as a dot on the canvas, building up a point cloud over the course of the simulation run.

This block is particularly useful for revealing correlations between two signals, visualising Lissajous figures, or inspecting the joint distribution of noise on two channels.

Parameters

title

Label shown in the block header. Default: Scatter Plot.

pointSize

Diameter of each rendered point in pixels. Larger values make individual samples more visible at the cost of overplotting in dense regions. Default: 4.

color

CSS colour (hex or named) applied to all plotted points (e.g. #2563eb). Default: blue (#2563eb).

Advanced Options

Show Grid: Toggle grid lines on the plot. Default: true.

Examples

Lissajous figure

Sine(f=1) → ScatterPlot.X
Sine(f=3) → ScatterPlot.Y

Drive X with a 1 Hz sine and Y with a 3 Hz sine to generate a 1:3 Lissajous figure — a quick check on frequency ratios between two oscillators.

Correlation between two sensor channels

Sensor1 → ScatterPlot.X
Sensor2 → ScatterPlot.Y

Connect two physical sensor outputs to visualise their cross-correlation and identify linear or non-linear dependencies.

Remarks

Sink block: ScatterPlot has no output ports. It is a terminal display node and does not feed any downstream computation.
Two scalar inputs: The X and Y ports each accept a single scalar numeric signal. Array or vector signals are not supported on this block.
Accumulation: Points are added at every simulation step and are not cleared mid-run. For phase-plane trajectories this provides the full orbit history.
No time axis: Unlike a time-series scope, the horizontal axis is the X signal value, not simulation time.