truehist                package:MASS                R Documentation

_P_l_o_t _a _H_i_s_t_o_g_r_a_m

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

     Creates a histogram on the current graphics device.

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

     truehist(data, nbins = "Scott", h, x0 = -h/1000,
              breaks, prob = TRUE, xlim = range(breaks),
              ymax = max(est), col,
              xlab = deparse(substitute(data)), bty = "n", ...)

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

    data: numeric vector of data for histogram.  Missing values ('NA's)
          are allowed and omitted. 

   nbins: The suggested number of bins.  Either a positive integer, or
          a character string naming a rule: '"Scott"' or
          '"Freedman-Diaconis"' or '"FD"'.  (Case is ignored.) 

       h: The bin width, a strictly positive number (takes precedence
          over 'nbins'). 

      x0: Shift for the bins - the breaks are at 'x0 + h * (..., -1, 0,
          1, ...)' 

  breaks: The set of breakpoints to be used. (Usually omitted, takes
          precedence over 'h' and 'nbins'). 

    prob: If true (the default) plot a true histogram. The vertical
          axis has a _relative frequency density_ scale, so the product
          of the dimensions of any panel gives the relative frequency. 
          Hence the total area under the histogram is 1 and it is
          directly comparable with most other estimates of the
          probability density function. If false plot the counts in the
          bins. 

    xlim: The limits for the x-axis. 

    ymax: The upper limit for the y-axis. 

     col: The colour number for the bar fill. 

    xlab: label for the plot x-axis. By default, this will be the name
          of 'data'. 

     bty: The box type for the plot - defaults to none. 

     ...: additional arguments to 'rect' or 'plot'. 

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

     This plots a true histogram, a density estimate of total area 1. 
     If 'breaks' is specified, those breakpoints are used. Otherwise if
     'h' is specified, a regular grid of bins is used with width 'h'. 
     If neither 'breaks' nor 'h' is specified, 'nbins' is used to
     select a suitable 'h'.

_S_i_d_e _E_f_f_e_c_t_s:

     A histogram is plotted on the current device.

_R_e_f_e_r_e_n_c_e_s:

     Venables, W. N. and Ripley, B. D. (2002) _Modern Applied
     Statistics with S._ Fourth edition.  Springer.

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

     'hist'

