tab {tabulator}

Efficient tabulation

Description

Produces a tabulation: for each unique group from the variable(s), tab shows the number of observations with that value, proportion of observations with that value, and cumulative proportion, in descending order of frequency. Accepts data.table, tibble, or data.frame as input. Efficient with big data: if you give it a data.table, tab uses data.table syntax.

Usage

tab(df, ..., by, round)

Arguments

df

A data.table, tibble, or data.frame.

...

A column or set of columns (without quotation marks).

by

A variable by which you want to group observations before tabulating (without quotation marks).

round

An integer indicating the number of digits for proportion and cumulative proportion.

Value

Tabulation (frequencies, proportion, cumulative proportion) for each unique value of the variables given in ... from df.

Examples

# data.table
library(data.table)
library(magrittr)
a <- data.table(varname = sample.int(20, size = 1000000, replace = TRUE))
a %>% tab(varname)

# tibble
library(dplyr)
b <- tibble(varname = sample.int(20, size = 1000000, replace = TRUE))
b %>% tab(varname, round = 1)

# data.frame
c <- data.frame(varname = sample.int(20, size = 1000000, replace = TRUE))
c %>% tab(varname)