lets_plot.position_jitterdodge

lets_plot.position_jitterdodge(dodge_width=None, jitter_width=None, jitter_height=None, seed=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.

seedint

A random seed to make the jitter reproducible. If None (the default value), the seed is initialised with a random value.

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(seed=42))