

truehist(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 = nclass.scott(data), 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.

       h: The bin width (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 omit-
          ted, 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 `polygon'.

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

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

_V_a_l_u_e_:

     None.

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

     A histogram is plotted on the current device.

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

     `hist'

