ggribbon {ggplot} | R Documentation

## Grob function: ribbon

### Description

Add a ribbon to the plot

### Usage

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

Aesthetic mappings that this grob function understands:

- `x`:x position (required)
- `upper`: position of upper edge of ribbon (required)
- `lower`: position of lower edge of ribbon (required)
- `id`:identifier variable used to break up into multiple paths
- `colour`:line 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:

- none

### Author(s)

Hadley Wickham <h.wickham@gmail.com>

### Examples

    mry <- do.call(rbind, by(movies, round(movies$rating), function(df) {
    nums <- tapply(df$length, df$year, length)
    data.frame(rating=round(df$rating[1]), year = as.numeric(names(nums)), number=as.vector(nums))
    }))
    p <- ggplot(mry, aesthetics = list(x=year, y=number, id=rating))
    ggribbon(p, aes=list(upper=number+5, lower=number-5), fill="white", colour=NA)
    ggribbon(p, aes=list(y=number, plus=5, minus=-5), fill="white", colour=NA)
    ggribbon(p, aes=list(upper=number*1.1, lower=number*0.9), fill="white", colour=NA)
    ggribbon(p, aes=list(upper=number+5, lower=number-5), fill="pink")
    ggribbon(p, aes=list(upper=number+5, lower=number-5, fill=rating), colour=NA)
    scfillgradient(ggribbon(p, aes=list(upper=number+5, lower=number-5, fill=rating), colour=NA), midpoint=5, low="red", high="darkgreen")

[Package ggplot version 0.4.2 Index]