ggjitter {ggplot} | R Documentation

## Grob function: jittered points

### Description

Add jittered points to a plot

### Usage

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

### 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 if the x variable is a factor, 0 otherwise`
- `yjitter`:degree of jitter in y direction, see `jitter for details, defaults to 1 if the y variable is a factor, 0 otherwise`

### Author(s)

Hadley Wickham <h.wickham@gmail.com>

### Examples

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

[Package ggplot version 0.4.2 Index]