Struct StatBinHex 

pub struct StatBinHex {
    pub bins_x: usize,
    pub bins_y: usize,
    pub binwidth: Option<(f64, f64)>,
    pub origin: Option<(f64, f64)>,
}

Hexagonal binning on a fixed hex lattice (data units), unlike the floor-binned staggered rectangles this replaces (see the 0.20.0 CHANGELOG). Output: x, y (hex centres), count, density, ncount, ndensity, width, height, fill (= count, back-compat), n (unweighted point count), q, r.

Fields

bins_x: usize

bins_y: usize

binwidth: Option<(f64, f64)>

origin: Option<(f64, f64)>

Implementations

impl StatBinHex

pub fn new() -> Self

pub fn bins(self, n: usize) -> Self

Same bin count on both axes.

pub fn bins_xy(self, x: usize, y: usize) -> Self

pub fn binwidth(self, w: f64, h: f64) -> Self

Fix the bin width/height in data units (overrides bins).

pub fn origin(self, x: f64, y: f64) -> Self

Fix the lattice origin in data units.

pub fn lattice(&self, xs: &[f64], ys: &[f64]) -> HexLattice

Build the HexLattice this stat would use for (xs, ys), following the origin rules:

• binwidth and origin both given: the lattice is fixed exactly.
• binwidth only: anchored at (0, 0).
• neither: w, h from the range and bin counts, anchored at the data minimum (ggplot2) — or at origin, if given without binwidth.

pub fn locate(x: f64, y: f64, lattice: &HexLattice) -> (i64, i64)

The cell (q, r) nearest (x, y) on lattice.

Trait Implementations

impl Default for StatBinHex

fn default() -> Self

Returns the “default value” for a type.

impl Stat for StatBinHex

fn compute_group(&self, data: &DataFrame, _scales: &ScaleSet) -> DataFrame

Transform data for a single group.

fn required_aes(&self) -> Vec<Aesthetic>

Required aesthetics this stat needs.

fn name(&self) -> &str

Name for debug/display.

fn validate(&self, warnings: &mut Vec<String>)

Validate the stat’s own fixed configuration (not the data) and push a human-readable warning for each problem found — e.g. StatBinHex::binwidth being NaN, zero or negative. Called once per layer, before compute_group runs (which has no warnings channel of its own: the per-group call only sees &DataFrame and &ScaleSet, not the plot’s warnings sink). Default: no-op.

fn default_aes(&self) -> Aes

Default aesthetic mappings this stat produces.

fn panelwise(&self) -> bool

If true, the stat receives every row of a panel at once (grouped only by facet variables) instead of once per aesthetic group. Needed for cross-group comparisons such as stat_compare_means, which must see all groups together. Defaults to per-group behaviour.