p_identified: Conditional cumulative density function of true or observed...

View source: R/p_identified_function.R

p_identifiedR Documentation

Conditional cumulative density function of true or observed scores for identified students

Description

The conditional cumulative density function (cdf) for identified students. Given a value for the true score, it returns the proportion of scores for identified students that will the lower than the target. In short, it returns the percentile for a given true score.

Usage

p_identified(
  x,
  relyt = 1,
  test.cutoff,
  valid = 1e-07,
  nom.cutoff = 1e-07,
  mu = 0
)

Arguments

x

The student's score on a standardized (z-score) metric. Interpreted as a true score if a value is specified for relyt, otherwise intepreted as an observed score.

relyt

Confirmatory test reliability coefficient. Range (0, 1]. Must not be exactly 0. Defaults to 1; in this case, x is assumed to be an observed score. If an alternative value is supplied for relyt, x is assumed to be a true score.

test.cutoff

Confirmatory test cutoff percentile. Range (0, 1). Must not be exactly 0 or 1.

valid

Nomination validity coefficient. Controls the relatedness of the nomination scores and the confirmatory test scores. Range (0, 1). Must not be exactly 0 or 1, and must be less than the square root of the test reliability. Defaults to 1e-7 for a single- stage identification system.

nom.cutoff

Nomination cutoff percentile. Range (0, 1). Must not be exactly 0 or 1. Defaults to 1e-7 for a single- stage identification system.

mu

Population mean true score on a standardized (z-score) metric. Defaults to zero.

Details

See also d_identified for the density function, q_identified for the quantile function, and r_identified for random generation.

Examples

p_identified(
  relyt = .95, valid = .6, test.cutoff = .975,
  nom.cutoff = .9, x = 2.5
)

mcbeem/giftedCalcs documentation built on May 3, 2022, 3:34 a.m.