gghexagon               package:ggplot               R Documentation

_G_r_o_b _f_u_n_c_t_i_o_n: _h_e_x_a_g_o_n_s

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

     Create hexagon binning of data points as created by Dan Carr.

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

     gghexagon(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 is useful for scatterplots with a lot of overplotting. 
     It bins the region into hexagons, counts the number of points in
     each hexagonal bin and then plots them.

     Aesthetic mappings that this grob function understands:

        *  x: x position (required)

        *  y: y position (required)

     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:

        *  xbins: number of bins to use

        *  ...: other arguments passed to 'grid.hexagons'

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

     Hadley Wickham <h.wickham@gmail.com>

_S_e_e _A_l_s_o:

     'grid.hexagon', 'grob_2density' for another way of dealing with
     overplotting

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

     m <- ggplot(movies, aesthetics=list(y=length, x=rating))
     gghexagon(m)
     gghexagon(m, xbins=50)
     gghexagon(m, style="lattice")

