Skip to content

Box-Cox & modulus transformations

Source: R/transform-numeric.R
transform_boxcox.Rd

The Box-Cox transformation is a flexible transformation, often used to transform data towards normality. The modulus transformation generalises Box-Cox to also work with negative values.

Usage

transform_boxcox(p, offset = 0)

boxcox_trans(p, offset = 0)

transform_modulus(p, offset = 1)

modulus_trans(p, offset = 1)

Arguments

p

Transformation exponent, \(\lambda\).

offset

Constant offset. 0 for Box-Cox type 1, otherwise any non-negative constant (Box-Cox type 2). transform_modulus() sets the default to 1.

Details

The Box-Cox power transformation (type 1) requires strictly positive values and takes the following form for \(\lambda > 0\): $$y^{(\lambda)} = \frac{y^\lambda - 1}{\lambda}$$ When \(\lambda = 0\), the natural log transform is used.

The modulus transformation implements a generalisation of the Box-Cox transformation that works for data with both positive and negative values. The equation takes the following forms, when \(\lambda \neq 0\) : $$y^{(\lambda)} = sign(y) * \frac{(|y| + 1)^\lambda - 1}{\lambda}$$ and when \(\lambda = 0\): $$y^{(\lambda)} = sign(y) * \ln(|y| + 1)$$

References

Box, G. E., & Cox, D. R. (1964). An analysis of transformations. Journal of the Royal Statistical Society. Series B (Methodological), 211-252. https://www.jstor.org/stable/2984418

John, J. A., & Draper, N. R. (1980). An alternative family of transformations. Applied Statistics, 190-197. https://www.jstor.org/stable/2986305

See also

transform_yj()

Examples

plot(transform_boxcox(-1), xlim = c(0, 10))

plot(transform_boxcox(0), xlim = c(0, 10))

plot(transform_boxcox(1), xlim = c(0, 10))

plot(transform_boxcox(2), xlim = c(0, 10))


plot(transform_modulus(-1), xlim = c(-10, 10))

plot(transform_modulus(0), xlim = c(-10, 10))

plot(transform_modulus(1), xlim = c(-10, 10))

plot(transform_modulus(2), xlim = c(-10, 10))