Learn R Programming

base (version 3.3)

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 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}2^31 or more elements and hence a count could exceed the maximum integer: this is currently an error.

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

Run this code
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]))

Run the code above in your browser using DataLab