summ                 package:epicalc                 R Documentation

_S_u_m_m_a_r_y _w_i_t_h _g_r_a_p_h

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

     Summary of data frame in a convenient table. Summary of a variable
     with statistics and graph

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

     summ(x = .data, by = NULL, graph = TRUE, box = FALSE, pch = 18, 
         ylab = "auto", main = "auto", cex.X.axis = 1, cex.Y.axis = 1, 
         dot.col = "auto", ...) 

_A_r_g_u_m_e_n_t_s:

       x: 'x' can be a data frame or a vector. 'summ()' is the same as
          'summ(.data)'

      by: a stratification variable, valid only when x is a vector

   graph: automatic plot (sorted dot chart) if 'x' is a vector

     box: add a boxplot to the graph (by=NULL)

     pch: plot characters

    ylab: annotation on Y axis

    main: main title of the graph

cex.X.axis: character extension scale of X axis

cex.Y.axis: character extension scale of Y axis

 dot.col: colour(s) of plot character(s)

     ...: additional graph parameters

_D_e_t_a_i_l_s:

     For data frames, 'summ' gives basic statistics of each variable in
     the data frame. The other arguments are ignored.

     For single vectors, a sorted dot chart is also provided, if
     graph=TRUE (default).

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

     Virasakdi Chongsuvivatwong <cvirasak@medicine.psu.ac.th>

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

     'summary', 'use', 'des'

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

     data(BP)
     use(BP)
     summ()
     summ(sex)
     summ(sbp, box=TRUE)
     summ(sbp, dot.col="brown")
     summ(sbp, by=sex)
     # Changing dot colours
     summ(sbp, by=sex, dot.col = c("blue","orange"))
     # Enlarging main title and other elements
     summ(sbp, by=sex, cex.main=1.5, cex.X.axis=1.5, cex.Y.axis=1.7)

     # Free vector
     summ(rnorm(1000))
     summ((1:100)^2, by=rep(1:2, 50))
     summ((1:100)^2, by=rep(c("Odd","Even"), 50), main="Quadratic distribution by odd and even numbers")

