Skip to contents

Factory function that creates a new S7 subclass of npsych_scores with fixed label, range, and codes properties. The returned class object is also registered in the .npsych_classes environment for discovery by list_npsych_scores().

Usage

new_npsych_scores(
  name,
  label,
  domain = NA_character_,
  short_descriptor = NA_character_,
  range,
  codes = numeric()
)

Arguments

name

A non-empty single string giving the subclass name (e.g., "MOCATOTS"). Used as both the S7 class name and registry key.

label

A single string identifying the test (e.g., "MoCA", "Trail Making Test Part A").

domain

A single string identifying the domain the test belongs to (e.g., "General Cognition", "Language"). Defaults to an empty character vector.

short_descriptor

A short descriptor giving a little bit more information than the label. When available, the entry from the Researchers Data Dictionary; see rdd for more.

range

A numeric vector of length 2 giving the minimum and maximum valid scores.

codes

A named numeric vector of error/special codes (e.g., c("Not administered" = 88)). Defaults to an empty numeric vector.

Value

An S7 class object (subclass of npsych_scores) whose constructor accepts a single .data argument.