ggplot2 (version 2.1.0)

position_jitter: Jitter points to avoid overplotting.

Description

Jitter points to avoid overplotting.

Usage

position_jitter(width = NULL, height = NULL)

Arguments

width, height

Amount of vertical and horizontal jitter. The jitter is added in both positive and negative directions, so the total spread is twice the value specified here.

If omitted, defaults to 40% of the resolution of the data: this means the jitter values will occupy 80% of the implied bins. Categorical data is aligned on the integers, so a width or height of 0.5 will spread the data so it's not possible to see the distinction between the categories.

See Also

Other position adjustments: position_dodge, position_fill, position_identity, position_jitterdodge, position_nudge

Examples

ggplot(mtcars, aes(am, vs)) + geom_point()

# Default amount of jittering will generally be too much for
# small datasets:
ggplot(mtcars, aes(am, vs)) + geom_jitter()

# Two ways to override
ggplot(mtcars, aes(am, vs)) +
  geom_jitter(width = 0.1, height = 0.1)
ggplot(mtcars, aes(am, vs)) +
  geom_jitter(position = position_jitter(width = 0.1, height = 0.1))

# The default works better for large datasets, where it will
# take up as much space as a boxplot or a bar
ggplot(mpg, aes(class, hwy)) +
  geom_jitter() +
  geom_boxplot()