Scatter Plot Widget

The Scatter Plot Widget allows you to visualise the relationship between two data fields by plotting one field on the X-axis and another on the Y-axis. This is useful for identifying correlations, trends, and patterns between measurements over time.

Configuration

Basics

Title: Assign a custom title to the widget.

Data

X-Axis Device and Field

Select the device and field that will be plotted on the X-axis.

Y-Axis Device and Field

Select the device and field that will be plotted on the Y-axis.

Example: Plot room temperature on the X-axis and room humidity on the Y-axis to visualize how both values relate to each other.

Timeframe

Choose the period of historical data to display in the scatter plot (default to the last hour, the last day, week, 2 weeks, last month or personalise your timeframe).

Appearance

Show Trail Line: Connects consecutive data points with a line, making it easier to visualise the progression of values over time.

Trail Width: Adjust the thickness of the trail line.

Point Size: Define the size of the plotted data points.

Color Mode: Choose how points are colored:

• Single Color – All points use the same color.

• Color by Y-Value (Gradient) – Points are coloured based on their Y value using a color gradient.

When Color by Y-Value (Gradient) is enabled, the following options become available:

• Gradient Start – Color used for the first value.

• Gradient End – Color used for the last value.

• Min (Optional) – Define the lower bound of the gradient scale.

• Max (Optional) – Define the upper bound of the gradient scale.

Both minimum and maximum values must be numerical.

Tint Color: Customize the widget's primary accent color.

Highlight Color: Customize the color used for highlighted elements.

Hide Background: Removes the widget background for a cleaner appearance.

Hide Last Update: Hides the timestamp showing when the widget was last updated.

References

Reference lines can be added to help identify thresholds or target values.

X-Axis Reference Value

Add a numerical reference value on the X-axis.

• Creates a vertical line at the specified value.

• Useful for marking limits, thresholds, or target values.

• A custom color can be assigned to the reference line.

Y-Axis Reference Value

Add a numerical reference value on the Y-axis.

• Creates a horizontal line at the specified value.

• Useful for highlighting limits, thresholds, or target values.

• A custom color can be assigned to the reference line.

Saving Changes

After configuring the widget, click Save Changes to apply the settings and display the scatter plot on your dashboard.