df_label_value: Functions to Label Data Frames by Grouping Variables

In rstatix: Pipe-Friendly Framework for Basic Statistical Tests

Functions to Label Data Frames by Grouping Variables

Description

Functions to label data frame rows by one or multiple grouping variables.

Usage

df_label_both(data, ..., vars = NULL, label_col = "label", sep = c(", ", ":"))

df_label_value(data, ..., vars = NULL, label_col = "label", sep = ", ")

Arguments

data	a data frame
...	One or more unquoted expressions (or variable names) separated by commas. Used as grouping variables.
vars	a character vector containing the grouping variables of interest.
label_col	column to hold the label of the data subsets. Default column name is "label".
sep	String separating labelling variables and values. Should be of length 2 in the function df_label_both(). 1) One sep is used to separate groups, for example ','; 2) The other sep between group name and levels; for example ':'.

Value

a modified data frame with a column containing row labels.

Functions

• df_label_both(): Displays both the variable name and the factor value.

• df_label_value(): Displays only the value of a factor.

Examples

# Data preparation
df <- head(ToothGrowth)

# Labelling: Non standard evaluation
df %>%
  df_label_both(dose, supp)

# Standard evaluation
df %>%
  df_label_both(dose, supp)

# Nesting the data then label each subset by groups
ToothGrowth %>%
  df_nest_by(dose, supp) %>%
  df_label_both(supp, dose)

rstatix documentation built on Feb. 16, 2023, 6:10 p.m.