tabulate: Tabulation for Vectors

Description Usage Arguments Details Value See Also Examples

Description

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

Usage

1
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.

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.

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.

See Also

table, factor.

Examples

1
2
3
4
5
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]))

Questions? Problems? Suggestions? or email at ian@mutexlabs.com.

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.