Struct PositionDodge 

pub struct PositionDodge {
    pub width: Option<f64>,
    pub reverse: bool,
}

Place groups side-by-side (ggplot2’s position_dodge(width)).

Within each x position the groups present there (group / fill / colour level, in first-appearance order — the legend order — or reversed with with_reverse) share width (in x units; one category on a discrete axis) and are centred on x: offset = (k − (n − 1)/2) · width / n for the k-th of n groups. On a continuous axis x itself moves; on a discrete axis the offset is stored in the .x_dodge_offset column and applied by the geoms that support it (point, pointrange, errorbar, linerange, ribbon, censor marks), so several models’ intervals per term sit side by side — also under coord_flip.

PositionDodge is also usable as a value (the default, width from the layer, 0.9), as before 0.17.

Fields

width: Option<f64>

Total dodge width; None = the layer default (0.9).

reverse: bool

Reverse the group order (ggplot2 ≥ 3.5 reverse = TRUE).

Implementations

impl PositionDodge

pub fn new(width: f64) -> Self

Dodge with an explicit total width (ggplot2’s position_dodge(width)).

pub fn with_reverse(self, reverse: bool) -> Self

Reverse the order of the dodged groups.

Trait Implementations

impl Clone for PositionDodge

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PositionDodge

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

Formats the value using the given formatter.

impl Default for PositionDodge

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for PositionDodge

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Position for PositionDodge

fn per_panel(&self) -> bool

ggplot2 computes position_dodge’s group count/offset per facet panel (compute_panel), not pooled across panels (#153) — verified against ggplot2 4.0.3: a group missing from one panel’s x level doesn’t shift the groups that panel does have.

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

Review #167 finding 2: the group rank still comes from the whole layer (first-appearance order across every panel), even though the per-x group count stays per-panel. Without this, a panel whose rows happen to list groups in a different order than another panel drew that group on the opposite side — a regression vs 0.22.2 and ggplot2 4.0.3, which both rank by the global group id.

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

Adjust positions for data.

fn name(&self) -> &str

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.

impl StructuralPartialEq for PositionDodge