
Population-SD profiles and explicit shared-rater model intervals
Source:R/api-random-rater-profile.R
confint.mfrm_random_rater.RdPopulation-SD profiles and explicit shared-rater model intervals
Usage
# S3 method for class 'mfrm_random_rater'
confint(object, parm = "rater_sd", level = 0.95, ...)Arguments
- object
A result from
fit_mfrm_random_rater(). Profiling requires estimated rater SD.- parm
"rater_sd"(default) profiles population variation."raters"explicitly requests first-order normal prediction intervals for all observed raters. These are not supplied automatically because their nominal coverage is not established."calibration"explicitly requests observed-information normal approximations for fixed-facet levels and steps, excluding population SDs.- level
Confidence level, between zero and one; default 0.95.
- ...
Unused.
Value
A one-row matrix with Lower and Upper, and attributes level,
method, profile and note. The profile retains every evaluated SD,
refitted likelihood and numerical checks. Unresolved profiles stop with an
explanatory error rather than substituting a Wald interval.
With parm = "raters", one row per rater, computed from saved estimates
and PredictionSE without refitting or RTMB. Attributes retain the method,
target, level and interpretation. Unresolved numerical/information checks,
estimated variance boundaries and unavailable SEs give missing bounds.
With parm = "calibration", one row per fixed-facet level or step,
with the same level/method/target/note attributes and availability guards.
Default calibration tables omit bounds; this explicit calculation uses
saved SEs without refitting and does not establish finite-sample coverage.
Details
For parm = "rater_sd", fixed facets, steps and any estimated
ability SD are refitted at
each candidate rater SD, including zero. A specified known ability SD
stays fixed. Earlier saved fits retain their known N(0,1) population. The interval is the connected profile region around the fitted SD
satisfying twice the log-likelihood loss no greater than
qchisq(level, df = 1). It uses the same approximate marginal likelihood as
the fit. The lower bound is zero when the zero-variance submodel belongs
to this region. An estimated boundary can therefore have a positive upper
limit even though ordinary Wald intervals are unavailable.
This is an asymptotic likelihood-ratio interval, not a finite-sample coverage guarantee. The chi-square reference is nonregular at a true zero variance; the usual one-degree-of-freedom cutoff is conservative under the standard single-variance boundary asymptotics. Few raters, Laplace error and design misspecification can alter coverage. The numerical checks do not establish those asymptotic conditions. The calculation stops if the fitted or profiled ability variance is an estimated zero boundary; that additional nuisance boundary requires a different reference distribution for inference. No ability-SD interval is supplied. This interval does not quantify the predictive distribution of a replacement rater, whose variation is a different target.
The separate parm = "raters" calculation uses the conditional mode plus
or minus qnorm((1 + level)/2) * PredictionSE. It targets realized,
uncentered rater effects relative to the population mean. First-order
calibration uncertainty does not ensure nominal coverage. In particular,
few-rater coverage remains unresolved; see
vignette("mfrmr-random-raters"). Requesting this approximation does not
make it qualified for classification or exclusion of raters. It is not a
profile interval, a bootstrap or an interval for a difference of raters.
References
Self, S. G. and Liang, K.-Y. (1987). Asymptotic properties of maximum likelihood estimators and likelihood ratio tests under nonstandard conditions. Journal of the American Statistical Association, 82, 605–610. doi:10.1080/01621459.1987.10478472 .