efa_solution: Estimate an exploratory factor solution

In surveyframe: Survey Instrument Workflows

Estimate an exploratory factor solution

Description

Runs psych::fa() on selected item columns and returns loadings, communalities, uniqueness, variance summaries, and simple item retention flags. The psych package is optional and is only required when this function is called.

Usage

efa_solution(
  data,
  instrument,
  items = NULL,
  scales = NULL,
  nfactors = 1L,
  extraction = c("minres", "pa", "ml"),
  rotation = c("oblimin", "promax", "varimax"),
  min_loading = 0.3,
  cross_loading = 0.3
)

Arguments

data	A data.frame of responses.
instrument	An sframe object.
items	Character vector of item IDs. When NULL, scale items are used.
scales	Optional scale IDs used to select item columns.
nfactors	Number of factors.
extraction	Extraction method passed to psych::fa().
rotation	Rotation method passed to psych::fa().
min_loading	Minimum salient loading.
cross_loading	Maximum secondary loading before a warning is raised.

Value

An object of class sframe_efa_solution. Alongside the psych objects it carries three tidy data frames ready for plotting and reporting: loadings_long (item_id, factor, loading), communalities_table (item_id, communality, uniqueness), and variance_table (factor, ss_loadings, proportion_var, cumulative_var).

surveyframe documentation built on July 25, 2026, 1:07 a.m.