checkConsistency: Check the consistency of the norm data model

In cNORM: Continuous Norming

Check the consistency of the norm data model

Description

While abilities increase and decline over age, within one age group, the norm scores always have to show a linear increase or decrease with increasing raw scores. Violations of this assumption are a strong indication for problems in modeling the relationship between raw and norm scores. There are several reasons, why this might occur:

1. Vertical extrapolation: Choosing extreme norm scores, e. g. values -3 <= x and x >= 3 In order to model these extreme values, a large sample dataset is necessary.

2. Horizontal extrapolation: Taylor polynomials converge in a certain radius. Using the model values outside the original dataset may lead to inconsistent results.

3. The data cannot be modeled with Taylor polynomials, or you need another power parameter (k) or R2 for the model.

In general, extrapolation (point 1 and 2) can carefully be done to a certain degree outside the original sample, but it should in general be handled with caution.

Usage

checkConsistency(
  model,
  minAge = NULL,
  maxAge = NULL,
  minNorm = NULL,
  maxNorm = NULL,
  minRaw = NULL,
  maxRaw = NULL,
  stepAge = 1,
  stepNorm = 1,
  warn = FALSE,
  silent = FALSE,
  covariate = NULL
)

Arguments

model	The model from the bestModel function or a cnorm object
minAge	Age to start with checking
maxAge	Upper end of the age check
minNorm	Lower end of the norm value range
maxNorm	Upper end of the norm value range
minRaw	clipping parameter for the lower bound of raw scores
maxRaw	clipping parameter for the upper bound of raw scores
stepAge	Stepping parameter for the age check, usually 1 or 0.1; lower values indicate higher precision / closer checks
stepNorm	Stepping parameter for the norm table check within age with lower scores indicating a higher precision. The choice depends of the norm scale used. With T scores a stepping parameter of 1 is suitable
warn	If set to TRUE, already minor violations of the model assumptions are displayed (default = FALSE)
silent	turn off messages
covariate	In case, a covariate has been used, please specify the degree of the covariate / the specific value here.

Value

Boolean, indicating model violations (TRUE) or no problems (FALSE)

See Also

Other model: bestModel(), cnorm.cv(), derive(), modelSummary(), print.cnorm(), printSubset(), rangeCheck(), regressionFunction(), summary.cnorm()

Examples

result <- cnorm(raw = elfe$raw, group = elfe$group)
modelViolations <- checkConsistency(result,
  minAge = 2, maxAge = 5, stepAge = 0.1,
  minNorm = 25, maxNorm = 75, minRaw = 0, maxRaw = 28, stepNorm = 1
)
plotDerivative(result, minAge = 2, maxAge = 5, minNorm = 25, maxNorm = 75)

cNORM documentation built on Oct. 8, 2023, 5:06 p.m.