checkConsistency {cNORM} | R Documentation

## 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)

[Package cNORM version 2.0.3 Index]