boxCoxVariable: Constructed Variable for Box-Cox Transformation

View source: R/boxCoxVariable.R

boxCoxVariableR Documentation

Constructed Variable for Box-Cox Transformation


Computes a constructed variable for the Box-Cox transformation of the response variable in a linear model.





response variable.


The constructed variable is defined as y[log(y/y') -1], where y' is the geometric mean of y.

The constructed variable is meant to be added to the right-hand-side of the linear model. The t-test for the coefficient of the constructed variable is an approximate score test for whether a transformation is required.

If b is the coefficient of the constructed variable, then an estimate of the normalizing power transformation based on the score statistic is 1 - b. An added-variable plot for the constructed variable shows leverage and influence on the decision to transform y.


a numeric vector of the same length as y.


John Fox


Atkinson, A. C. (1985) Plots, Transformations, and Regression. Oxford.

Box, G. E. P. and Cox, D. R. (1964) An analysis of transformations. JRSS B 26 211–246.

Fox, J. (2016) Applied Regression Analysis and Generalized Linear Models, Third Edition. Sage.

Fox, J. and Weisberg, S. (2019) An R Companion to Applied Regression, Third Edition, Sage.

See Also

boxcox, powerTransform, bcPower


mod <- lm(interlocks + 1 ~ assets, data=Ornstein)
mod.aux <- update(mod, . ~ . + boxCoxVariable(interlocks + 1))
# avPlots(mod.aux, "boxCoxVariable(interlocks + 1)")

car documentation built on Oct. 20, 2022, 1:05 a.m.