scale_within: Scale and center variables within the levels of another...

View source: R/standardize.R

scale_withinR Documentation

Scale and center variables within the levels of another variable.

Description

scale_within centers and/or scales variables in a data.frame (using scale) depending on the levels of one or more other variables. By default, variables are standardized (i.e., centered and scaled). A typical application is the within-subject standardization of variables in a repeated measures design.

Usage

scale_within(
  data,
  variables = NULL,
  within = NULL,
  prefix = "",
  center = TRUE,
  scale = TRUE
)

Arguments

data

a data.frame.

variables

a character string (or vector) specifying one or more variables that scale is applied to. If unspecified, scale_within will be applied to all variables in data.

within

an optional character string specifying the name of one or more variables in data. If specified, scale is applied separately for each of the levels of the variable (or for each combination of levels, if more than one variable is specified). Alternatively, a vector directly containing the level values.

prefix

a character string that is inserted before each scaled variable. By default (empty string) the original variables are replaced.

center

argument passed on to scale.

scale

argument passed on to scale.

Value

The original data.frame including the centered and / or scaled variables.

Author(s)

Pascal J. Kieslich

Felix Henninger

See Also

scale for the R base scale function.

mt_standardize for standardizing measures in a mousetrap data object.

Examples

ChickWeight_scaled <-  scale_within(
 ChickWeight, variables="weight",
 within="Chick", prefix="z_")
 

PascalKieslich/mousetrap documentation built on Jan. 31, 2024, 9:26 p.m.