gghexagon {ggplot} | R Documentation

## Grob function: hexagons

### Description

Create hexagon binning of data points as created by Dan Carr.

### Usage

    gghexagon(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 grob is useful for scatterplots with a lot of overplotting. It bins the region into hexagons, counts the number of points in each hexagonal bin and then plots them.

Aesthetic mappings that this grob function understands:

- x: x position (required)
- y: y position (required)

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:

- xbins: number of bins to use
- ...: other arguments passed to `grid.hexagons`

### Author(s)

Hadley Wickham <h.wickham@gmail.com>

### See Also

`grid.hexagon`, `grob_2density` for another way of dealing with overplotting

### Examples

    m <- ggplot(movies, aesthetics=list(y=length, x=rating))
    gghexagon(m)
    gghexagon(m, xbins=50)
    gghexagon(m, style="lattice")

[Package ggplot version 0.2.2 Index]