ggarea                package:ggplot                R Documentation

_G_r_o_b _f_u_n_c_t_i_o_n: _a_r_e_a

_D_e_s_c_r_i_p_t_i_o_n:

     Add an filled area to a plot.

_U_s_a_g_e:

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

_A_r_g_u_m_e_n_t_s:

    plot: x positions

aesthetics: y positions

     ...: id variable used to separate observations into different
          areas

    data: colour

        : pattern

        : ...

_D_e_t_a_i_l_s:

     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

_A_u_t_h_o_r(_s):

     Hadley Wickham <h.wickham@gmail.com>

_E_x_a_m_p_l_e_s:

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

