gghistogram {ggplot} | R Documentation

## Grob function: histogram

### Description

Draw a histogram

### Usage

    gghistogram(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

Aesthetic mappings that this grob function understands:

Conceptually, the histogram is one of the most complicated of the grob functions, becuase it takes a 1D data set and makes it two dimensional. This necessitates an extra step, the `pre_histogram` function which bins the data and returns the bins with their counts. This data is then used my `grob_histogram` to plot the points.

- x: x 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:

- breaks: breaks argument passed to `hist`
- scale: scale argument passed to `hist`

### Author(s)

Hadley Wickham <h.wickham@gmail.com>

### Examples

    m <- ggplot(movies, aesthetics=list(x=rating))
    gghistogram(m)

[Package ggplot version 0.2.2 Index]