tabyl is a data.frame containing counts of a variable or co-occurrences of two variables (a.k.a., a contingency table or crosstab). This specialized kind of data.frame has attributes that enable
adorn_ functions to be called for precise formatting and presentation of results. E.g., display results as a mix of percentages, Ns, add totals rows or columns, rounding options, in the style of Microsoft Excel PivotTable.
tabyl can be the result of a call to
janitor::tabyl(), in which case these attributes are added automatically. This function adds
tabyl class attributes to a data.frame that isn't the result of a call to
tabyl but meets the requirements of a two-way tabyl:
1) First column contains values of variable 1
2) Column names 2:n are the values of variable 2
3) Numeric values in columns 2:n are counts of the co-occurrences of the two variables.*
* = this is the ideal form of a tabyl, but janitor's
adorn_ functions tolerate and ignore non-numeric columns in positions 2:n.
For instance, the result of
dplyr::count() followed by
tidyr::spread() can be treated as a
The result of calling
tabyl() on a single variable is a special class of one-way tabyl; this function only pertains to the two-way tabyl.
a data.frame with variable values in the first column and numeric values in all other columns.
is this a two_way tabyl or a one_way tabyl? If this function is being called by a user, this should probably be "2". One-way tabyls are created by
(optional) the name of the variable in the row dimension; used by
(optional) the name of the variable in the column dimension; used by
Returns the same data.frame, but with the additional class of "tabyl" and the attribute "core".
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.