ggribbon               package:ggplot               R Documentation

_G_r_o_b _f_u_n_c_t_i_o_n: _r_i_b_b_o_n

_D_e_s_c_r_i_p_t_i_o_n:

     Add a ribbon to the plot

_U_s_a_g_e:

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

_A_r_g_u_m_e_n_t_s:

    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

_D_e_t_a_i_l_s:

     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

_A_u_t_h_o_r(_s):

     Hadley Wickham <h.wickham@gmail.com>

_E_x_a_m_p_l_e_s:

     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")

