Package: semanticfa
Title: Semantic Factor Analysis of Language Model Embeddings
Version: 0.5.0
Authors@R: c(
    person("Devon", "Yanitski", , "dyanitsk@ualberta.ca", role = c("aut", "cre"),
           comment = c(ORCID = "0009-0006-1568-3387")),
    person("Chris", "Westbury", role = "aut")
    )
Description: Performs exploratory factor analysis on language model embeddings
    of psychological scale items. Embeds item text with sentence transformers
    or other language models, transforms the embeddings into item-by-item
    similarity matrices, and extracts latent factor structure via standard
    exploratory factor analysis, using several similarity transforms (atomic
    reversed, SQuID centering, mean-centered Pearson) and fit diagnostics
    tailored to embedding matrices (TEFI, RMSR, CAF, McDonald's omega).
    Factor retention spans embedding-adapted parallel analysis, the empirical
    Kaiser criterion, Velicer's minimum average partial, a comparison-data
    misfit profile, and a calibrated learned rule that reports conformal
    intervals. Further tools orient factor axes toward retrieved construct
    terms by lexical target rotation, and audit whether a scale's items cover
    their construct's semantic region without collecting responses. The
    underlying methods are documented with full citations in the
    corresponding function help pages. Returns objects compatible with
    'psych' and 'EFAtools' workflows.
License: GPL (>= 3)
URL: https://github.com/devon7y/semanticfa
BugReports: https://github.com/devon7y/semanticfa/issues
Depends: R (>= 4.1.0)
Imports: digest, GPArotation, grDevices, graphics, psych, reticulate
        (>= 1.41.0), Rtsne, stats, utils, uwot, withr
Suggests: EFAtools, jsonlite, EGAnet, httr2, knitr, rmarkdown, testthat
        (>= 3.0.0)
VignetteBuilder: knitr
Config/testthat/edition: 3
Encoding: UTF-8
LazyData: true
RoxygenNote: 7.3.2
NeedsCompilation: no
Packaged: 2026-09-01 19:44:08 UTC; devon7y
Author: Devon Yanitski [aut, cre] (ORCID:
    <https://orcid.org/0009-0006-1568-3387>),
  Chris Westbury [aut]
Maintainer: Devon Yanitski <dyanitsk@ualberta.ca>
Repository: CRAN
Date/Publication: 2026-09-01 21:00:02 UTC
