teal.data (version 0.5.0)

col_labels: Variable labels

Description

Get or set variable labels in a data.frame.

Usage

col_labels(x, fill = FALSE)
col_labels(x) <- value
col_relabel(x, ...)
get_labels(...)

Value

For col_labels, named character vector of variable labels, the names being the corresponding variable names. If the label attribute is missing, the vector elements will be the variable names themselves if fill = TRUE and NA if fill = FALSE.

For col_labels<- and col_relabel, copy of x with variable labels modified.

Arguments

x

(data.frame or DataFrame) data object

fill

(logical(1)) specifying what to return if variable has no label

value

(character) vector of variable labels of length equal to number of columns in x; if named, names must match variable names in x and will be used as key to set labels; use NA to remove label from variable

...

name-value pairs, where name corresponds to a variable name in x and value is the new variable label

Details

Variable labels can be stored as a label attribute set on individual variables. These functions get or set this attribute, either on all (col_labels) or some variables (col_relabel).

In previous versions of teal.data labels were managed with get_labels(). This function is deprecated as of 0.4.0, use col_labels instead.

Examples

x <- iris
col_labels(x)
col_labels(x) <- paste("label for", names(iris))
col_labels(x)
y <- col_relabel(x, Sepal.Length = "Sepal Length of iris flower")
col_labels(y)