standardize: Standardize circumplex scales using normative data

In circumplex: Analysis and Visualization of Circular Data

Standardize circumplex scales using normative data

Description

Take in a data frame containing circumplex scales, angle definitions for each scale, and normative data (from the package or custom) and return that same data frame with each specified circumplex scale transformed into standard scores (i.e., z-scores) based on comparison to the normative data.

Usage

standardize(
  .data,
  scales,
  angles,
  instrument,
  sample = 1,
  prefix = "",
  suffix = "_z"
)

Arguments

.data	Required. A data frame containing at least circumplex scales.
scales	Required. The variable names or column numbers for the variables in .data that contain circumplex scales to be standardized.
angles	Required. A numeric vector containing the angular displacement of each circumplex scale included in scales (in degrees).
instrument	Required. An instrument object from the package. To see the available circumplex instruments, see instruments().
sample	Required. An integer corresponding to the normative sample to use in standardizing the scale scores (default = 1). See ?norms to see the normative samples available for an instrument.
prefix	Optional. A string to include at the beginning of the newly calculated scale variables' names, before the scale name and suffix (default = "").
suffix	Optional. A string to include at the end of the newly calculated scale variables' names, after the scale name and prefix (default = "_z").

Value

A data frame that matches .data except that new variables are appended that contain standardized versions of scales. These new variables will have the same name as scales but with a "_z" suffix.

See Also

Other tidying functions: ipsatize(), score()

Examples

data("jz2017")
instrument("iipsc")
standardize(jz2017, PA:NO, octants(), instrument = iipsc, sample = 1)

circumplex documentation built on Aug. 22, 2023, 9:11 a.m.