configural (version 0.1.5)

fungible.lm: Locate extrema of fungible OLS regression weights

Description

Identify maximally similar or dissimilar sets of fungible standardized regression coefficients from an OLS regression model

Usage

# S3 method for lm
fungible(
  object,
  theta = 0.005,
  Nstarts = 1000,
  MaxMin = c("min", "max"),
  silent = FALSE,
  ...
)

Value

A list containing the alternative weights and other fungible weights estimation parameters

Arguments

object

A fitted model object of class "lm" or "summary.lm".

theta

A vector of values to decrement from R-squared to compute families of fungible coefficients.

Nstarts

Maximum number of (max) minimizations from random starting configurations.

MaxMin

Should the cosine between the observed and alternative weights be maximized ("max") to find the maximally similar coefficients or minimized ("min") to find the maximally dissimilar coefficients?

silent

Should current optimization values be printed to the console (FALSE) or suppressed (TRUE)?

...

Additional arguments

References

Waller, N. G., & Jones, J. A. (2009). Locating the extrema of fungible regression weights. Psychometrika, 74(4), 589–602. tools:::Rd_expr_doi("10.1007/s11336-008-9087-7")

Examples

lm_mtcars <- lm(mpg ~ cyl + disp + hp + drat + wt + qsec + vs + am + gear + carb,
                data = mtcars)
lm_mtcars_fung <- fungible(lm_mtcars, Nstarts = 100)