santoku (version 0.10.0)

chop_quantiles: 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, ...)

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().

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().

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)