olsrr: ols_step_forward_aic – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

ols_step_forward_aic

Stepwise AIC forward regression

Description

Build regression model from a set of candidate predictor variables by entering predictors based on akaike information criterion, in a stepwise manner until there is no variable left to enter any more.

Usage

ols_step_forward_aic(model, ...)

## Default S3 method:
ols_step_forward_aic(model, progress = FALSE,
  details = FALSE, ...)

## S3 method for class 'ols_step_forward_aic'
plot(x, print_plot = TRUE, ...)

Arguments

`model`	An object of class `lm`.
`...`	Other arguments.
`progress`	Logical; if `TRUE`, will display variable selection progress.
`details`	Logical; if `TRUE`, will print the regression result at each step.
`x`	An object of class `ols_step_forward_aic`.
`print_plot`	logical; if `TRUE`, prints the plot else returns a plot object.

Value

ols_step_forward_aic returns an object of class "ols_step_forward_aic". An object of class "ols_step_forward_aic" is a list containing the following components:

`model`	model with the least AIC; an object of class `lm`
`steps`	total number of steps
`predictors`	variables added to the model
`aics`	akaike information criteria
`ess`	error sum of squares
`rss`	regression sum of squares
`rsq`	rsquare
`arsq`	adjusted rsquare

Deprecated Function

ols_stepaic_forward() has been deprecated. Instead use ols_step_forward_aic().

References

Venables, W. N. and Ripley, B. D. (2002) Modern Applied Statistics with S. Fourth edition. Springer.

Examples

# stepwise forward regression
model <- lm(y ~ ., data = surgical)
ols_step_forward_aic(model)

# stepwise forward regression plot
model <- lm(y ~ ., data = surgical)
k <- ols_step_forward_aic(model)
plot(k)

# final model
k$model

olsrr

Tools for Building OLS Regression Models

v0.5.3

MIT + file LICENSE

Authors

Aravind Hebbali [aut, cre]

Initial release