truehist {MASS}R Documentation

Plot a Histogram


Creates a histogram on the current graphics device.


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


data numeric vector of data for histogram. Missing values (NAs) 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.


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.

Side Effects

A histogram is plotted on the current device.


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

See Also


[Package MASS version 7.2-33 Index]