get_capl_interpretation: Compute a CAPL-2 interpretation for a given CAPL-2 protocol...

In capl: Compute and Visualize CAPL-2 Scores and Interpretations

Compute a CAPL-2 interpretation for a given CAPL-2 protocol or domain score.

Description

This function computes an age- and gender-specific CAPL-2 interpretation for a given CAPL-2 protocol or domain score (e.g., pc_interpretation).

Usage

get_capl_interpretation(age = NA, gender = NA, score = NA, protocol = NA)

Arguments

age	A numeric vector (valid values are between 8 and 12).
gender	A character vector (valid values currently include "girl", "g", "female", "f", "boy", "b", "male", "m").
score	A numeric vector. If the protocol argument is set to "pacer" or "steps", this argument must contain integers.
protocol	A character vector representing a CAPL protocol (valid values include "pacer", "plank", "camsa", "pc", "steps", "self_report_pa", "db", "mc", "ku", "capl"; valid values are not case-sensitive).

Details

Other capl functions called by this function include: validate_age(), validate_gender(), validate_character(), validate_number() and validate_scale(). This function will check whether a score for a given protocol is within a valid range; if not, NA will be returned.

Value

Returns a character vector with values of "beginning", "progressing", "achieving" or "excelling" (if valid) or NA (if not valid).

Examples

get_capl_interpretation(
  age = 7:13,
  gender = c("g", "g", "b", "Boy", "m", "f", "Female"),
  score = c(50, 25, 100, 5, 150, 23, 78),
  protocol = "pacer"
)

# [1] NA            "achieving"   "excelling"   "beginning"   "excelling"   "progressing"
# [7] NA

capl documentation built on April 8, 2022, 9:06 a.m.