base (version 3.5.0)

tabulate: Tabulation for Vectors

Description

tabulate takes the integer-valued vector bin and counts the number of times each integer occurs in it.

Usage

tabulate(bin, nbins = max(1, bin, na.rm = TRUE))

Arguments

bin

a numeric vector (of positive integers), or a factor. Long vectors are supported.

nbins

the number of bins to be used.

Value

An integer valued integer or double vector (without names). There is a bin for each of the values 1, …, nbins; values outside that range and NAs are (silently) ignored.

On 64-bit platforms bin can have \(2^{31}\) or more elements (i.e., length(bin) > .Machine$integer.max), and hence a count could exceed the maximum integer. For this reason, the return value is of type double for such long bin vectors.

Details

tabulate is the workhorse for the table function.

If bin is a factor, its internal integer representation is tabulated.

If the elements of bin are numeric but not integers, they are truncated by as.integer.

See Also

table, factor.

Examples

# NOT RUN {
tabulate(c(2,3,5))
tabulate(c(2,3,3,5), nbins = 10)
tabulate(c(-2,0,2,3,3,5))  # -2 and 0 are ignored
tabulate(c(-2,0,2,3,3,5), nbins = 3)
tabulate(factor(letters[1:10]))
# }