Skip to contents

GPCM Workflow Availability

Source: R/help_gpcm_scope.R
gpcm_capability_matrix.Rd

Check which bounded GPCM workflows can be used in mfrmr, the limits that apply to each workflow, and the recommended alternative when a route is not available.

The table is intended for route selection before or after fitting and is limited to workflow availability, interpretive constraints, and the route to use next.

Usage

gpcm_capability_matrix(
  status = c("all", "supported", "supported_with_caveat", "blocked", "deferred")
)

Arguments

status

Which rows to return: "all" (default), "supported", "supported_with_caveat", "blocked", or "deferred".

Value

A data.frame of class mfrmr_gpcm_capabilities with one row per workflow family and columns:

  • Area

  • Helpers

  • Status

  • Boundary

  • RecommendedRoute

Details

Status has the following user-facing meanings:

  • supported: the helper is available within the stated boundary;

  • supported_with_caveat: the helper runs, but its interpretation is restricted as described in Boundary;

  • blocked: the helper intentionally stops for a bounded GPCM fit;

  • deferred: no public mfrmr route is currently available.

Read Boundary before interpreting a caveated result. For a blocked or deferred row, use RecommendedRoute to choose a supported analysis or a Rasch-family alternative.

Typical workflow

  1. Call gpcm_capability_matrix() before using GPCM in a new workflow.

  2. For supported_with_caveat, read Boundary before interpreting output.

  3. For blocked or deferred, follow RecommendedRoute instead.

See also

fit_mfrm(), diagnose_mfrm(), compute_information(), predict_mfrm_units(), sample_mfrm_plausible_values(), reporting_checklist(), mfrmr_workflow_methods, mfrmr-package

Examples

gpcm_capability_matrix()
#> mfrmr bounded-GPCM workflow availability
#> 
#>                 Status Routes
#>              supported      3
#>  supported_with_caveat     14
#>                blocked      1
#>               deferred      1
#> 
#> Route preview
#>                                            Area                Status
#>                      Core fitting and summaries             supported
#>  Exploratory diagnostics and residual follow-up supported_with_caveat
#>       Fixed-calibration scoring and information             supported
#>                   Core curve and category views             supported
#>      Checklist and summary-table appendix route supported_with_caveat
#>                     Operational misfit casebook supported_with_caveat
#>        Weighting review and model-choice review supported_with_caveat
#>                   Operational linking synthesis supported_with_caveat
#> 
#> ... 11 more route(s).
#> 
#> Filter by status, for example gpcm_capability_matrix("supported_with_caveat").
#> Read Boundary and RecommendedRoute before interpreting a caveated or unavailable route.
gpcm_capability_matrix("supported")
#> mfrmr bounded-GPCM workflow availability
#> 
#>     Status Routes
#>  supported      3
#> 
#> Route preview
#>                                       Area    Status
#>                 Core fitting and summaries supported
#>  Fixed-calibration scoring and information supported
#>              Core curve and category views supported
#> 
#> Filter by status, for example gpcm_capability_matrix("supported_with_caveat").
#> Read Boundary and RecommendedRoute before interpreting a caveated or unavailable route.
gpcm_capability_matrix("blocked")
#> mfrmr bounded-GPCM workflow availability
#> 
#>   Status Routes
#>  blocked      1
#> 
#> Route preview
#>                                      Area  Status
#>  FACETS output-contract score-side review blocked
#> 
#> Filter by status, for example gpcm_capability_matrix("supported_with_caveat").
#> Read Boundary and RecommendedRoute before interpreting a caveated or unavailable route.