ggarea {ggplot} | R Documentation

## Grob function: area

### Description

Add an filled area to a plot.

### Usage

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

### Arguments

`plot` | x positions
`aesthetics` | y positions
`...` | id variable used to separate observations into different areas
`data` | colour
`` | pattern
`` | ...

### Details

Aesthetic mappings that this grob function understands:

- `x`:x position (required)
- `y`:y position (required)
- `id`:identifier variable used to break up into multiple paths
- `colour`:line colour (see `sccolour`)
- `fill`:fill colour (see `sccolour`)
- `linetype`:line style/type (see `sclinetype`)

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:

- none

### Author(s)

Hadley Wickham <h.wickham@gmail.com>

### Examples

    huron <- data.frame(year = 1875:1972, level = as.vector(LakeHuron))
    p <- ggplot(huron, aes=list(y=level, x=year))
    ggarea(p)
    ggarea(p, colour="black")
    ggline(ggarea(p)) # better
    qplot(year, level, data=huron, type=c("area", "line"))
    ggarea(p, fill=alpha("grey80", 0.5))
    pscontinuous(ggarea(p), "y", range=c(0,NA))

[Package ggplot version 0.4.2 Index]