umx (version 1.4.0)

umx_cont_2_quantiles: umx_cont_2_quantiles

Description

Recode a continuous variable into n-quantiles (default = deciles (10 levels)). It returns an mxFactor, with the levels labeled with the max value in each quantile (i.e., open on the left-side).

Usage

umx_cont_2_quantiles(x, nlevels = NULL, type = c("mxFactor", "ordered", "unordered"), verbose = FALSE)

Arguments

x

a variable to recode as ordinal (email me if you'd like this upgraded to handle df input)

nlevels

How many bins or levels (at most) to use (i.e., 10 = deciles)

type

what to return (Default is "mxFactor") options include "ordered" and "unordered")

verbose

report the min, max, and decile cuts used (default = FALSE)

Value

- recoded variable as an mxFactor

Details

Note: Redundant bins are merged. i.e., if the same score identifies all deciles up to the fourth, then these will be merged into one level.

References

- https://github.com/tbates/umx, https://tbates.github.io

See Also

Other Data Functions: umxCovData, umxFactor, umxHetCor, umxPadAndPruneForDefVars, umx_as_numeric, umx_cov2raw, umx_lower2full, umx_make_MR_data, umx_make_bin_cont_pair_data, umx_make_fake_data, umx_merge_CIs, umx_read_lower, umx_reorder, umx_residualize, umx_round, umx_scale_wide_twin_data, umx_scale, umx_swap_a_block, umx

Examples

x = umx_cont_2_quantiles(rnorm(1000), nlevels = 10, verbose = TRUE)
levels(x)
x = umx_cont_2_quantiles(mtcars[,"mpg"], 5) # quintiles
x = umx_cont_2_quantiles(mtcars[,"cyl"], 10)
# x = umx_cont_2_quantiles(mtcars[,1:3])
x = umx_cont_2_quantiles(rep(0:10, 10), nlevels = 10)
x = umx_cont_2_quantiles(rbinom(10000, 1, .5), nlevels = 2)
str(umx_cont_2_quantiles(rnorm(10000), nlevels = 4, verbose = TRUE))