lets_plot.position_jitterdodge

lets_plot.position_jitterdodge(dodge_width=None, jitter_width=None, jitter_height=None)

This is primarily used for aligning points generated through geom_point() with dodged boxplots (e.g., a geom_boxplot() with a fill aesthetic supplied).

Parameters

dodge_widthfloat

Bin width. The value of dodge_width is relative and typically ranges between 0 and 1. Values that are greater than 1 lead to overlapping of the boxes.

jitter_widthfloat

Jittering width. The value of jitter_width is relative and typically ranges between 0 and 0.5. Values that are greater than 0.5 lead to overlapping of the points.

jitter_heightfloat

Jittering height. The value of jitter_height is relative and typically ranges between 0 and 0.5. Values that are greater than 0.5 lead to overlapping of the points.

Returns

FeatureSpec

Geom object position specification.

Notes

Adjust position by dodging overlaps to the side.

Examples

import numpy as np
from lets_plot import *
LetsPlot.setup_html()
n = 50
np.random.seed(42)
x = np.random.uniform(size=n)
c = np.random.choice(['a', 'b', 'c'], size=n)
ggplot({'x': x, 'c': c}) + \
    geom_crossbar(aes(x='c', y='x', color='c'), \
                  stat='boxplot') + \
    geom_point(aes(x='c', y='x', color='c'), \
               size=4, shape=21, fill='white',
               position=position_jitterdodge())