gggroup                package:ggplot                R Documentation

_G_r_o_b _f_u_n_c_t_i_o_n: _g_r_o_u_p_s

_D_e_s_c_r_i_p_t_i_o_n:

     Create multiple of grobs based on id aesthetic.

_U_s_a_g_e:

     gggroup(plot = .PLOT, aesthetics=list(), ..., data=plot$data)

_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:

     This grob function provides a general means of creating multiple
     grobs based on groups in the data.  This is useful if you want to
     fit a separate smoother for each group in the data.

     You will need an id variable in your aesthetics list with
     determines how the data is broken down.

     Aesthetic mappings that this grob function understands:

        *  x: x position (required)

        *  y: y position (required)

        *  id:

        *  any other grobs used by the grob function you choose

     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:

        *  grob: grob function to use for subgroups

        *  anything else used by the grob function you choose

_A_u_t_h_o_r(_s):

     Hadley Wickham <h.wickham@gmail.com>

_E_x_a_m_p_l_e_s:

     p <- ggplot(mtcars, aesthetics=list(y=wt, x=qsec, id=cyl, colour=cyl))
     gggroup(p)
     gggroup(ggpoint(p), grob=grob_smooth, se=FALSE, span=1)
     gggroup(ggpoint(p), aes=list(id=cyl, size=cyl), grob=grob_smooth, span=1)

