mfrm_results_interactive: Interactively choose data-frame columns before calling...

View source: R/api-results.R

mfrm_results_interactiveR Documentation

Interactively choose data-frame columns before calling mfrm_results()

Description

Interactively choose data-frame columns before calling mfrm_results()

Usage

mfrm_results_interactive(
  data,
  include = "standard",
  output = c("object", "summary", "tables", "html")
)

Arguments

data

A long-format data frame.

include

Passed to mfrm_results().

output

Passed to mfrm_results().

Details

This helper is deliberately opt-in and stops in non-interactive sessions. It asks the user to choose the person, score, optional weight, and facet columns, prints reproducible code for the selected roles, then fits the default legacy-compatible RSM/JML route before calling mfrm_results(). Use explicit fit_mfrm() calls in scripts, Quarto documents, tests, and reproducible analyses.

Value

The selected mfrm_results() output.

Why this helper is opt-in

Interactive prompts are useful at the console but are unsafe defaults for reproducible analysis, package checks, batch scripts, and manuscripts. The helper therefore prints replay code and leaves the scripted route explicit.

See Also

mfrm_results(), fit_mfrm(), run_mfrm_facets()

Examples

if (interactive()) {
  toy <- load_mfrmr_data("example_core")
  res <- mfrm_results_interactive(toy)
}

mfrmr documentation built on June 13, 2026, 1:07 a.m.