GLDEX: histsu – R documentation

Pricing

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

Get Started for Free

Documentation

GLDEX

histsu

Histogram with exact number of bins specified by the user

Description

The generic function histsu computes a histogram of the given data values.

Usage

histsu(x, breaks = "Sturges", freq = NULL, probability = !freq, 
include.lowest = TRUE, right = TRUE, density = NULL, angle = 45, col = NULL, 
border = NULL, main = paste("Histogram of", xname), xlim = range(breaks), 
ylim = NULL, xlab = xname, ylab, axes = TRUE, plot = TRUE, labels = FALSE, 
nclass = NULL, ...)

Arguments

`x`	A vector of values for which the histogram is desired.
`breaks`	Either: 1) A vector giving the breakpoints between histogram cells, OR 2) A single number giving the number of cells for the histogram, OR 3) A character string naming an algorithm to compute the number of cells (see Details), OR 4) A function to compute the number of cells.
`freq`	logical; if `TRUE`, the histogram graphic is a representation of frequencies, the `counts` component of the result; if `FALSE`, probability densities, component 'density', are plotted (so that the histogram has a total area of one). Defaults to `TRUE` iff 'breaks' are equidistant (and 'probability' is not specified).
`probability`	A logical value, `TRUE` means it is not a frequency graph.
`include.lowest`	If `TRUE`, an `x[i]` equal to the 'breaks' value will be included in the first (or last, for `right=FALSE`) bar. This will be ignored (with a warning) unless 'breaks' is a vector.
`right`	If `TRUE`, the histograms cells are right-closed (left open) intervals.
`density`	The density of shading lines, in lines per inch. The default value of `NULL` means that no shading lines are drawn. Non-positive values of 'density' also inhibit the drawing of shading lines.
`angle`	The slope of shading lines, given as an angle in degrees (counter-clockwise).
`col`	A colour to be used to fill the bars. The default of `NULL` yields unfilled bars.
`border`	The color of the border around the bars. The default is to use the standard foreground color.
`main`	Title of the graph.
`xlim`	A two valued vector specifying the lower and upper limits of the x axis.
`ylim`	A two valued vector specifying the lower and upper limits of the y axis.
`xlab`	X axis labels.
`ylab`	Y axis labels.
`axes`	Logical value, if `TRUE`, axis will be drawn.
`plot`	Logical value, if `TRUE`, plot will be drawn.
`labels`	Logical or character. Additionally draw labels on top of bars, if not `FALSE`; see `plot.histogram`.
`nclass`	Number of bins of the histogram.
`...`	Other graphical parameters, see par for details.

Details

See hist help file. This function forces the number of class of histogram to that as specified by the user.

Value

An object of class "histogram" which is a list with components:

`breaks`	The n+1 cell boundaries (=`breaks` if that was a vector).
`counts`	N integers; for each cell, the number of `x[]` inside.
`density`	Values as estimated density values. If `all(diff(breaks) == 1)`, they are the relative frequencies counts/n.
`intensities`	Same as density, deprecated.
`mids`	The n cell midpoints.
`xname`	A character string with the actual `x` argument name.
`equidist`	Logical, indicating if the distances between `breaks` are all the same.

Note

Please see hist help file.

Author(s)

R development team with modifications by Steve Su

References

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

Examples

# See hist for extended example:
junk<-rgamma(1000,5)
# Forcing the number of bins to be 10:
histsu(junk,nclass=10)

GLDEX

Fitting Single and Mixture of Generalised Lambda Distributions (RS and FMKL) using Various Methods

v2.0.0.7

GPL (>= 3)

Authors

Steve Su, with contributions from: Diethelm Wuertz, Martin Maechler and Rmetrics core team members for low discrepancy algorithm, Juha Karvanen for L moments codes, Robert King for gld C codes and starship codes, Benjamin Dean for corrections and input in ks.gof code and R core team for histsu function.

Initial release

2020-02-04

histsu

Description

Usage

Arguments

Details

Value

Note

Author(s)

References

See Also

Examples

GLDEX

We don't support your browser anymore