ggbar                 package:ggplot                 R Documentation

_G_r_o_b _f_u_n_c_t_i_o_n: _b_a_r_s

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

     Add bars to a plot

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

     ggbar(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:

     The bar grob produces bars from the y-position to the y=0.

     Aesthetic mappings that this grob function understands:

        *  'x':x position (required)

        *  'y':y position (required)

        *  'fill':fill 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:

        *  'avoid': how should overplotting be dealt with? "none"
           (default) = do nothing, "stack" = stack bars on top of one
           another, "dodge" = dodge bars from side to side

        *  'sort': Should the values of the bars be sorted

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

     Hadley Wickham <h.wickham@gmail.com>

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

     'ggrect'

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

     cyltab <- as.data.frame(table(cyl=mtcars$cyl))
     p <- ggplot(cyltab, aes=list(y=Freq, x=cyl))
     ggbar(p)
     ggbar(p, fill="white", colour="red")
     #Can also make a stacked bar chart
     p <- ggplot(mtcars, aes=list(y=1, x=factor(cyl)))
     ggbar(p, avoid="stack")
     ggbar(p, avoid="stack", colour="red") # Made up of multiple small bars
     p <- ggplot(mtcars, aes=list(y=mpg, x=factor(cyl)))
     ggbar(p, avoid="stack")
     ggbar(p, avoid="dodge", sort=TRUE)
     ggbar(p, aes=list(fill=mpg), avoid="dodge", sort=TRUE)
     ggbar(p, avoid="stack", sort=TRUE)

