Struct PositionJitterDodge 

pub struct PositionJitterDodge {
    pub jitter_width: f64,
    pub jitter_height: f64,
    pub dodge_width: f64,
    /* private fields */
}

Combined jitter and dodge position adjustment. Useful for showing individual points within dodged groups (e.g., over boxplots).

Fields

jitter_width: f64

jitter_height: f64

dodge_width: f64

Implementations

impl PositionJitterDodge

pub fn new(jitter_width: f64, jitter_height: f64) -> Self

pub fn with_dodge_width(self, width: f64) -> Self

pub fn with_seed(self, seed: u64) -> Self

Trait Implementations

impl Default for PositionJitterDodge

fn default() -> Self

Returns the “default value” for a type.

impl Position for PositionJitterDodge

fn compute(&self, data: &mut DataFrame, _params: &PositionParams)

Adjust positions for data.

fn name(&self) -> &str

fn per_panel(&self) -> bool

Whether this position must run separately per facet panel rather than once on the pooled rows before facets are split (B3-3, D8). Default false. PositionStack/PositionFill override this to true — a shared x category’s stack height must not mix rows from different panels. PositionDodge/PositionDodge2/PositionJitter also override this to true (sipemu/ggplot-rs#153): ggplot2 computes a dodge’s group count/offset via compute_panel (per panel), and position_jitter’s default width/height — 40% of resolution() — is likewise measured from each panel’s own x/y, not the rows pooled across panels (verified against ggplot2 4.0.3 with layer_data() on faceted plots; see tests/position_panels_r.rs).

fn group_order(&self, _data: &DataFrame) -> Option<Vec<String>>

The whole layer’s group rank order (first-appearance, pre-panel- split), for a per_panel position whose group ranking must come from the whole layer even though its per-x counting stays per-panel (review #167 finding 2; sipemu/ggplot-rs#153). build::compute_position_per_panel calls this on the pooled data before splitting and threads the result through PositionParams::group_order to every panel’s compute call. Default None — positions that don’t need this (stack/fill/ jitter) are unaffected.

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

Validate this position’s own parameters once per layer (D2); default no-op. Implementations push a warning and fall back to a sane default rather than panicking or silently miscomputing.