plotPercentiles: Plot norm curves against actual percentiles

View source: R/plot.R

plotPercentilesR Documentation

Plot norm curves against actual percentiles

Description

The function plots the norm curves based on the regression model against the actual percentiles from the raw data. As in 'plotNormCurves', please check for inconsistent curves, especially intersections. Violations of this assumption are a strong indication for problems in modeling the relationship between raw and norm scores. 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. The original percentiles are displayed as distinct points in the according color, the model based projection of percentiles are drawn as lines. Please note, that the estimation of the percentiles of the raw data is done with the quantile function with the default settings. Please consult help(quantile) and change the 'type' parameter accordingly. In case, you get 'jagged' or disorganized percentile curve, try to reduce the 'k' parameter in modeling.

Usage

plotPercentiles(
  data,
  model,
  minRaw = NULL,
  maxRaw = NULL,
  minAge = NULL,
  maxAge = NULL,
  raw = NULL,
  group = NULL,
  percentiles = c(0.025, 0.1, 0.25, 0.5, 0.75, 0.9, 0.975),
  scale = NULL,
  type = 7,
  title = NULL,
  covariate = NULL
)

Arguments

data

The raw data including the percentiles and norm scores or a cnorm object

model

The model from the bestModel function (optional)

minRaw

Lower bound of the raw score (default = 0)

maxRaw

Upper bound of the raw score

minAge

Variable to restrict the lower bound of the plot to a specific age

maxAge

Variable to restrict the upper bound of the plot to a specific age

raw

The name of the raw variable

group

The name of the grouping variable; the distinct groups are automatically determined

percentiles

Vector with percentile scores, ranging from 0 to 1 (exclusive)

scale

The norm scale, either 'T', 'IQ', 'z', 'percentile' or self defined with a double vector with the mean and standard deviation, f. e. c(10, 3) for Wechsler scale index points; if NULL, scale information from the data preparation is used (default)

type

The type parameter of the quantile function to estimate the percentiles of the raw data (default 7)

title

custom title for plot

covariate

In case, a covariate has been used, please specify the degree of the covariate / the specific value here. If no covariate is specified, both degrees will be plotted.

See Also

plotNormCurves, plotPercentileSeries

Other plot: plot.cnorm(), plotDensity(), plotDerivative(), plotNormCurves(), plotNorm(), plotPercentileSeries(), plotRaw(), plotSubset()

Examples

# Load example data set, compute model and plot results
result <- cnorm(raw = elfe$raw, group = elfe$group)
plotPercentiles(result)

WLenhard/cNORM documentation built on Feb. 26, 2024, 3:09 p.m.