score: Score circumplex scales from item responses

In circumplex: Analysis and Visualization of Circular Data

Score circumplex scales from item responses

Description

Calculate mean scores on circumplex scales from item responses by using a set of scoring instructions, which may be loaded from the package or created as a custom data frame.

Usage

score(
  data,
  items,
  instrument,
  na.rm = TRUE,
  prefix = "",
  suffix = "",
  append = TRUE
)

Arguments

data	Required. A data frame containing at least circumplex scales.
items	Required. The variable names or column numbers for the variables in .data that contain all the circumplex items from a single circumplex measure, in ascending order from item 1 to item N.
instrument	Required. An instrument object from the package. To see the available circumplex instruments, use instruments().
na.rm	Optional. A logical that determines if missing values should be omitted from the calculation of scores (default = TRUE). When set to TRUE, scales with missing data are essentially calculated with mean imputation.
prefix	Optional. A string to include at the beginning of the newly calculated scale variables' names, before Abbrev from key and suffix (default = "").
suffix	Optional. A string to include at the end of the newly calculated scale variables' names, after Abbrev from key and prefix (default = "").
append	Optional. A logical that determines whether the calculated score variables will be appended to data or returned on their own (default = TRUE).

Value

A data frame that matches .data except that new variables are appended that contain mean scores on each variable included in key.

See Also

Other tidying functions: ipsatize(), norm_standardize()

Examples

data("raw_iipsc")
instrument("iipsc")
score(raw_iipsc, items = 1:32, instrument = iipsc, prefix = "IIPSC_")

circumplex documentation built on Oct. 28, 2024, 9:06 a.m.