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 (ggplot2’s position_jitterdodge()): useful for showing individual points within dodged groups (e.g. over boxplots).

As in ggplot2, points are first dodged like PositionDodge (groups in legend order, counted per x slot), then jittered by jitter_width / (ndodge + 2) either side, where ndodge is the most groups any x slot holds, so each group’s points stay inside its own slot (#429). Default uses ggplot2’s jitter.width = NULL: 40 % of the x resolution (0.4 on a discrete axis).

Fields

jitter_width: f64

jitter_height: f64

dodge_width: f64

Implementations

impl PositionJitterDodge

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

Explicit jitter.width (x data units, before the ndodge + 2 division) and jitter.height (the y spread).

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 group_order(&self, data: &DataFrame) -> Option<Vec<String>>

Dodge groups ranked like PositionDodge (legend order, #428), so the points line up with dodged boxes / violins.

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 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.