ggjitter {ggplot} | R Documentation

## Grob function: jittered points

### Description

Add jittered points to a plot

### Usage

    ggjitter(plot = .PLOT, aesthetics=list(), ..., data=plot$data)

### Arguments

`plot` | the plot object to modify
`aesthetics` | named list of aesthetic mappings, see details for more information
`...` | other options, see details for more information
`data` | data source, if not specified the plot default will be used

### Details

This is useful when plotting points with a categorical axis so to avoid overplotting.

Aesthetic mappings that this grob function understands:

- x: x position (required)
- y: y position (required)
- size: size of the point, in mm (see `scsize)`
- shape: shape of the glyph used to draw the point (see `scshape)`
- colour: point colour (see `sccolour)`

These can be specified in the plot defaults (see `ggplot`) or in the `aesthetics` argument. If you want to modify the position of the points or any axis options, you will need to add a position scale to the plot. These functions start with `ps`, eg. `pscontinuous` or `pscategorical`

Other options:

- xjitter: degree of jitter in x direction, see `jitter for details, defaults to 1`
- yjitter: degree of jitter in y direction, see `jitter for details, defaults to 0`

### Author(s)

Hadley Wickham <h.wickham@gmail.com>

### Examples

    p <- ggplot(movies, aes=list(x=mpaa, y=rating))
    ggjitter(p)
    ggboxplot(ggjitter(p))
    ggboxplot(ggjitter(p), xjitter=2)
    ggboxplot(ggjitter(p), yjitter=1)

[Package ggplot version 0.2.2 Index]