grade_model_evidence: Grade model evidence against an explicit validation contract

In eyeprocess: Harmonize Eye-Tracking, Pupillometry, Biometrics, and Psychometric Process Data

Grade model evidence against an explicit validation contract

Description

This is intentionally conservative: failure of any required criterion caps the evidence grade. It does not convert exploratory evidence into a claim of substantive validity.

Usage

grade_model_evidence(
  recovery,
  spec = irt_validation_spec("unspecified"),
  external_validation = NULL,
  sbc = NULL,
  ppc = NULL,
  semantic_roundtrip = NULL
)

Arguments

recovery	Value supplied to 'recovery'; see Details for its model-specific role.
spec	IRT model or validation specification.
external_validation	Value supplied to 'external_validation'; see Details for its model-specific role.
sbc	Value supplied to 'sbc'; see Details for its model-specific role.
ppc	Value supplied to 'ppc'; see Details for its model-specific role.
semantic_roundtrip	Value supplied to 'semantic_roundtrip'; see Details for its model-specific role.

Value

An object of class "eye_irt_evidence_grade", stored as a named list, with components "model_id", "grade", "checks", "recovery", "contract", "warning". It contains grade model evidence against an explicit validation contract and associated metadata or diagnostics needed to interpret the result.

eyeprocess documentation built on Sept. 28, 2026, 5:08 p.m.