sjmisc (version 1.0.2)

set_var_labels: Attach variable label(s) to a single variable or data frame

Description

This function sets variable labels to a single variable or to a set of variables in a data frame. To each variable, the attribute "label" or "variable.label" with the related variable name is attached. Most functions of the sjPlot package can automatically retrieve the variable name to use it as axis labels or plot title (see details).

Usage

set_var_labels(x, lab, attr.string = NULL)

Arguments

x

A single variable (vector) or data frame with variables.

lab

If x is a vector (single variable), use a single character string with the variable label for x. If x is a data.frame, use a vector with character labels of same le

attr.string

The attribute string for the variable label. To ensure compatibility to the foreign-package, use the default string "variable.label". If you want to save data with the haven package, use attr.string = "label"

Value

• x, with attached variable label attribute(s), which contains the variable name(s); or with removed label-attribute if lab = "".

Details

See 'Details' in get_val_labels

See Also

• http://www.strengejacke.de/sjPlot/datainit/{sjPlot manual: data initialization}
• http://www.strengejacke.de/sjPlot/view_spss/{sjPlot manual: inspecting (SPSS imported) data frames}
• get_var_labels

Examples

Run this code

# sample data set, imported from SPSS.
data(efc)

library(sjPlot)
sjt.frq(efc$e42dep)
sjt.frq(data.frame(efc$e42dep, efc$e16sex))

# ---------------------------------------------
# manually set value and variable labels
# ---------------------------------------------
dummy <- sample(1:4, 40, replace=TRUE)
dummy <- set_val_labels(dummy, c("very low", "low", "mid", "hi"))
dummy <- set_var_labels(dummy, "Dummy-variable")
# auto-detection of value labels by default, auto-detection of
# variable labels if parameter "title" set to NULL.
library(sjPlot)
sjp.frq(dummy, title = NULL)

# ---------------------------------------------
# Set variable labels for data frame
# ---------------------------------------------
dummy <- data.frame(a = sample(1:4, 10, replace = TRUE),
                    b = sample(1:4, 10, replace = TRUE),
                    c = sample(1:4, 10, replace = TRUE))
dummy <- set_var_labels(dummy,
                        c("Variable A",
                          "Variable B",
                          "Variable C"))
str(dummy)

# remove one variable label
dummy <- set_var_labels(dummy,
                        c("Variable A",
                          "",
                          "Variable C"))
str(dummy)

Run the code above in your browser using DataLab