chop_quantiles: Chop by quantiles

In santoku: A Versatile Cutting Tool

Chop by quantiles

Description

chop_quantiles() chops data by quantiles. chop_deciles() is a convenience shortcut and chops into deciles.

Usage

chop_quantiles(x, probs, ..., left = is.numeric(x), raw = FALSE)

chop_deciles(x, ...)

brk_quantiles(probs, ...)

tab_quantiles(x, probs, ..., left = is.numeric(x), raw = FALSE)

tab_deciles(x, ...)

Arguments

x	A vector.
probs	A vector of probabilities for the quantiles. If probs has names, these will be used for labels.
...	Passed to chop(), or for brk_quantiles() to stats::quantile().
left	Logical. Left-closed or right-closed breaks?
raw	Logical. Use raw values in labels?

Details

For non-numeric x, left is set to FALSE by default. This works better for calculating "type 1" quantiles, since they round down. See stats::quantile().

Value

⁠chop_*⁠ functions return a factor of the same length as x.

⁠brk_*⁠ functions return a function to create breaks.

⁠tab_*⁠ functions return a contingency table().

See Also

Other chopping functions: chop_equally(), chop_evenly(), chop_fn(), chop_mean_sd(), chop_n(), chop_proportions(), chop_width(), chop(), fillet()

Examples

chop_quantiles(1:10, 1:3/4)

chop_quantiles(1:10, c(Q1 = 0, Q2 = 0.25, Q3 = 0.5, Q4 = 0.75))

chop(1:10, brk_quantiles(1:3/4))

chop_deciles(1:10)

# to label by the quantiles themselves:
chop_quantiles(1:10, 1:3/4, raw = TRUE)

set.seed(42)
tab_quantiles(rnorm(100), probs = 1:3/4, raw = TRUE)

santoku documentation built on Oct. 12, 2023, 5:13 p.m.