Struct ScatterArtist 

pub struct ScatterArtist {
    pub x: Series,
    pub y: Series,
    pub color: Color,
    pub marker: Marker,
    pub size: f64,
    pub label: Option<String>,
    pub alpha: f64,
    pub colors: Option<Vec<Color>>,
    pub c: Option<Vec<f64>>,
    pub cmap: Option<Colormap>,
    pub decimate: DecimateMode,
}

A scatter plot rendering individual markers at (x, y) positions.

Each data point is drawn as a marker whose shape, size, and color can be configured. An optional per-point colors vector overrides the uniform color field, enabling colormap-based visualizations.

Fields

x: Series

X-coordinates of the data points.

y: Series

Y-coordinates of the data points.

color: Color

Default marker color (used when colors is None).

marker: Marker

Marker shape.

size: f64

Marker diameter in pixels.

label: Option<String>

Optional legend label. When Some, the scatter appears in the legend.

alpha: f64

Opacity from 0.0 (fully transparent) to 1.0 (fully opaque).

colors: Option<Vec<Color>>

Optional per-point colors for colormap-driven scatter plots.

When set, colors.len() must equal x.len() (and y.len()). Each entry overrides color for the corresponding data point.

c: Option<Vec<f64>>

Optional per-point scalar values for colormap-driven coloring.

When set together with cmap, each value is mapped through the colormap to produce per-point colors. Takes precedence over colors.

cmap: Option<Colormap>

Optional colormap used to map c values to colors.

decimate: DecimateMode

Controls how the series is downsampled before drawing.

Defaults to DecimateMode::Auto, which downsamples series larger than DEFAULT_DECIMATE_THRESHOLD using LTTB. Use the builder methods (.decimate, .decimate_with, .no_decimate) to override.

Per-point styling (colors, c) is honored by re-indexing through the selected indices, so decimation never desynchronizes colors from points.

Implementations

impl ScatterArtist

pub fn data_bounds(&self) -> (f64, f64, f64, f64)

Computes the data-space bounding box (xmin, xmax, ymin, ymax).

Falls back to (0.0, 1.0) on each axis when the corresponding series contains no finite values.

impl ScatterArtist

pub fn color(&mut self, color: Color) -> &mut Self

Sets the marker color.

Applies the given Color to every marker rendered by this artist, unless per-point colors have been set via colors.

Arguments

• color - The Color to fill each marker with.

Examples

artist.color(Color::TAB_RED);

pub fn marker(&mut self, marker: Marker) -> &mut Self

Sets the marker shape.

The Marker enum defines the available shapes (circle, square, triangle, diamond, plus, cross, star, point). The default is Marker::Circle.

Arguments

• marker - The Marker variant to use for every data point.

Examples

artist.marker(Marker::Triangle);

pub fn size(&mut self, size: f64) -> &mut Self

Sets the marker size in pixels.

This controls the diameter of each marker glyph. Larger values produce more prominent data points; smaller values suit dense scatter plots.

Arguments

• size - The marker diameter in device-independent pixels.

Examples

artist.size(10.0);

pub fn label(&mut self, label: &str) -> &mut Self

Sets the legend label for this scatter series.

When a label is set, the scatter series will appear in the legend if one is displayed on the axes. Pass an empty string or omit this call to exclude the series from the legend.

Arguments

• label - A string slice that will be stored as the legend entry.

Examples

artist.label("Measurements");

pub fn alpha(&mut self, alpha: f64) -> &mut Self

Sets the opacity (0.0 = fully transparent, 1.0 = fully opaque).

The value is clamped to the [0.0, 1.0] range. The default opacity is determined by the active theme (typically 0.8).

Arguments

• alpha - The desired opacity level.

Examples

artist.alpha(0.5); // 50% transparent

pub fn colors(&mut self, colors: Vec<Color>) -> &mut Self

Sets per-point colors, overriding the single uniform color.

When set, each data point is rendered with its corresponding color from the vector. The length of colors must equal the number of data points (x.len() and y.len()). This is commonly used to map a third variable to a colormap.

Calling color after this method does not clear the per-point colors; the per-point colors take precedence during rendering.

Arguments

• colors - A vector of Color values, one per data point.

Examples

artist.colors(vec![Color::TAB_BLUE, Color::TAB_RED, Color::TAB_GREEN]);

pub fn c(&mut self, c: Vec<f64>) -> &mut Self

Sets per-point scalar values for colormap-driven coloring.

When combined with cmap, each scalar value is mapped through the colormap to produce a per-point color. The length of c must equal the number of data points. This takes precedence over both the uniform color and colors.

Arguments

• c - A vector of scalar values, one per data point.

Examples

artist.c(vec![0.0, 0.5, 1.0]).cmap(Colormap::Viridis);

pub fn cmap(&mut self, cmap: Colormap) -> &mut Self

Sets the colormap used to map c values to colors.

Must be used together with c to have any effect. When both are set, the scatter plot renders each point with a color determined by mapping its c value through the given colormap.

Arguments

• cmap - The Colormap variant to use.

Examples

artist.c(values).cmap(Colormap::Plasma);

pub fn decimate(&mut self, threshold: usize) -> &mut Self

Enables LTTB decimation with the given explicit point threshold.

When the data series length exceeds threshold, the rendering pipeline downsamples the points using the Largest Triangle Three Buckets algorithm before drawing. Per-point styling (colors, c) stays synchronized with the surviving points.

This overrides the default DecimateMode::Auto behavior with an explicit threshold. To disable decimation entirely, use no_decimate.

Examples

ax.scatter(&x, &y)?.decimate(2000);

pub fn decimate_with( &mut self, threshold: usize, method: DecimateMethod, ) -> &mut Self

Enables decimation with a specific method and explicit point threshold.

Available methods:

• DecimateMethod::Lttb — best visual fidelity (default)
• DecimateMethod::MinMax — fastest, preserves peaks/troughs

Examples

ax.scatter(&x, &y)?.decimate_with(2000, DecimateMethod::MinMax);

pub fn no_decimate(&mut self) -> &mut Self

Disables decimation entirely, drawing every point.

By default large series are auto-decimated via DecimateMode::Auto. Call this when every marker must be rendered regardless of series size.

Examples

ax.scatter(&x, &y)?.no_decimate();

Trait Implementations

impl Clone for ScatterArtist

fn clone(&self) -> ScatterArtist

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ScatterArtist

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.