tabulate {base} R Documentation

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

### 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

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]))


[Package base version 4.3.0 Index]