Struct HexbinArtist 

pub struct HexbinArtist {
    pub x: Vec<f64>,
    pub y: Vec<f64>,
    pub gridsize: usize,
    pub cmap: Colormap,
    pub mincnt: usize,
    pub alpha: f64,
    pub color: Color,
    pub label: Option<String>,
    pub edgecolor: Option<Color>,
    pub show_colorbar: bool,
}

A hexagonal binning (hexbin) plot that visualises point density on a 2D plane using a grid of flat-top hexagons.

Each hexagon is coloured according to the number of data points that fall within its boundaries, mapped through the configured Colormap. This is especially useful for large datasets where individual scatter points would overlap heavily.

Fields

x: Vec<f64>

X-coordinates of the raw data points.

y: Vec<f64>

Y-coordinates of the raw data points.

gridsize: usize

Number of hexagons across the x-axis. Default 20.

cmap: Colormap

Colormap used to map bin counts to colors.

mincnt: usize

Minimum point count for a hex to be drawn. Default 1.

alpha: f64

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

color: Color

Primary color (used for legend swatch).

label: Option<String>

Optional legend label.

edgecolor: Option<Color>

Optional edge (stroke) color for hexagons.

show_colorbar: bool

Whether to auto-attach a colorbar when this hexbin is drawn.

Implementations

impl HexbinArtist

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

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

Returns the extent of the finite x and y values. Falls back to (0.0, 1.0, 0.0, 1.0) when data is empty or entirely non-finite.

impl HexbinArtist

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

Sets the number of hexagons across the x-axis.

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

Sets the colormap used to map bin counts to colors.

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

Sets the minimum count threshold; bins with fewer points are hidden.

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

Sets the opacity from 0.0 (fully transparent) to 1.0 (fully opaque).

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

Sets the legend label.

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

Sets the hex edge (stroke) color.

pub fn colorbar(&mut self, show: bool) -> &mut Self

Enables or disables auto-attaching a colorbar when this hexbin is drawn.

Trait Implementations

impl Clone for HexbinArtist

fn clone(&self) -> HexbinArtist

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HexbinArtist

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

Formats the value using the given formatter.