
Explore bias across facet pairs
Source:R/api-plotting-bias-collection.R
plot.mfrm_bias_collection.RdExplore bias across facet pairs
Arguments
- x
A result from
estimate_all_bias().- pair
An exact
Interactionlabel fromsummary(x)$overview, or its row number.NULL(default) shows all requested pairs.- type
"overview"shows signed cell estimates grouped by pair. Withpairsupplied, the default becomes"heatmap";"scatter","ranked","abs_t_hist"and"facet_profile"select the correspondingplot.mfrm_bias()view.- draw
Draw the figure.
FALSEreturns its data without opening a device.- preset
A package plot preset, for example
"standard"or"monochrome".- ...
With
pair, additional arguments toplot.mfrm_bias(), such astop_norsort_by. The overview rejects additional arguments.
Value
Invisibly, an mfrm_plot_data object. For the overview,
plot_data() provides table (all combined cells, including unavailable
rows), overview, errors, optimization_failures, fit_identity,
settings, axis labels and notes. as_ggplot() reproduces the overview.
A selected pair returns the ordinary bias plot with collection_pair
and fit_identity provenance added.
Details
The overview plots every finite retained bias estimate, without ranking or a significance cutoff. Positive shifts increase expected coded scores under the fitted model; score meaning depends on the rubric. Vertical spreading only separates cells visually and has no statistical meaning.
Filled circles have a usable conditional screening statistic; open circles
retain a point without one. These symbols indicate availability, not whether
a cell is flagged. Pair labels report usable statistics / retained cells and
the range of observed row counts per cell (n), not independent Person
counts. Pairs share observations. Empty, failed and unavailable pairs remain
labeled, without substituting a point at zero. The vertical zero line means
no conditional shift, not a threshold for practical importance.
No model or diagnostics are recalculated. The overview supplies no intervals, multiplicity correction or formal bias test. Review the individual cell counts, optimizer status and subject-matter explanations; selecting a pair after this overview does not make its subsequent analysis confirmatory. Titles and interpretation notes are returned outside the figure.
Session plot defaults
Set options(mfrmr.plot_preset = "publication") to choose a session default
for plotting functions that expose the common preset argument. The
supported values are "standard", "publication", "compact" and
"monochrome". Precedence is an explicit call argument, then the session
option, then "standard". For example, preset = "standard" overrides
a session set to "monochrome". Explicit preset = NULL retains the
earlier package-default behavior; it does not read the session option.
Invalid session values cause an error only when that option is needed.
The category-curve, data-quality, fit-review, connectivity and network
routes of plot() for report bundles use the same option through ....
Plots without a common preset argument, including extended-model plots
with their own palette controls, keep their own settings. This option
selects a preset, not a universal theme or a guarantee that all renderers
implement every appearance control identically.
New plot payloads retain the resolved preset for supported saved-data
rendering. Converting an existing payload with as_ggplot() uses its saved
appearance, even after the session option changes. A call that creates a
new plot from a fit or statistical result uses the current default.
For a reproducible script, supply preset explicitly or set the option in
that script. Saving only the fitted model does not save a session option.
No global ggplot theme is changed.
Restore previous settings with old <- options(mfrmr.plot_preset = "monochrome") followed by options(old). Use
options(mfrmr.plot_preset = NULL) to remove the option. The preset changes
appearance, not estimates, confidence levels or diagnostic thresholds.
Examples
# Long-running workflow; run explicitly when needed.
# example("plot.mfrm_bias_collection", run.dontrun = TRUE)
if (FALSE) { # \dontrun{
ratings <- load_mfrmr_data("example_bias")
fit <- fit_mfrm(ratings, "Person", c("Rater", "Criterion"), "Score",
method = "MML")
screens <- estimate_all_bias(fit)
p <- plot(screens)
plot_data(p, "overview")
plot(screens, pair = "Rater x Criterion", type = "ranked")
} # }