get_capl_interpretation {capl}

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