plotPercentiles: Plot norm curves against actual percentiles

In WLenhard/cNORM: Continuous Norming

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. In case, you get 'jagged' or disorganized percentile curve, try to reduce the 'k' and/or 't' parameter in modeling.

Usage

plotPercentiles(
  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,
  title = NULL,
  subtitle = NULL,
  points = F
)

Arguments

model	The Taylor polynomial regression model object from the cNORM
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)
title	custom title for plot
subtitle	custom title for plot
points	Logical indicating whether to plot the data points. Default is TRUE.

See Also

plotNormCurves, plotPercentileSeries

Other plot: compare(), plot.cnorm(), plot.cnormBetaBinomial(), plot.cnormBetaBinomial2(), plotDensity(), plotDerivative(), plotNorm(), plotNormCurves(), 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 Nov. 30, 2024, 4:45 p.m.