fourvalplot {persval} | R Documentation |
Plot spider chart for four higher-order personal values
Description
This function generates a spider chart based on four higher-order Basic Human Values: Openness to Change, Self-Enhancement, Conservation, and Self-Transcendence. This visualization helps in understanding the profile of higher-order values for individuals or groups.
Usage
fourvalplot(
df,
valueMap,
instrument,
corrected = TRUE,
standdev = TRUE,
na.rm = TRUE
)
Arguments
df |
A dataframe containing computed values for the four higher-order personal values. |
valueMap |
A named vector where names are the four higher-order personal values: Openness to Change ("OPEN"), Self-enhancement ("SELFENH"), Conservation ("CONS"), Self-transcendence ("SELFTRANS"). Vector values correspond to the column names in the dataframe. |
instrument |
Character string specifying the type of instrument used. Supported instruments: "svs", "pvq40", "pvq21", "twivi", "tivi". |
corrected |
Logical. Indicates if data are ipsatized; if FALSE, data are given as raw scores (variable ranges depending on the type of instrument used). Default is TRUE. |
standdev |
Logical. When TRUE, plots mean ± SD lines; when FALSE, plots only the mean. Default is TRUE. |
na.rm |
Logical. When TRUE, NAs are ignored; when FALSE, NAs are preserved and will affect calculations. Default is TRUE. |
Value
A spider chart visualizing the four higher-order values scores.
Examples
df <- data.frame(
open_comp = sample(-4.5:+4.5, 3, replace = TRUE),
selfenh_comp = sample(-4.5:+4.5, 3, replace = TRUE),
cons_comp = sample(-4.5:+4.5, 3, replace = TRUE),
selftrans_comp = sample(-4.5:+4.5, 3, replace = TRUE))
valueMap <- c(OPEN = "open_comp", SELFENH = "selfenh_comp",
CONS = "cons_comp", SELFTRANS = "selftrans_comp")
persval::fourvalplot(df = df, valueMap = valueMap, instrument = "pvq40")