{introverse} quick docs

 dplyr::rename()
   get_help() docs

Description

The rename() function is part of the {dplyr} package, which is part of the {tidyverse}.

We use rename() to quickly rename columns in tibbles (data frames). No quotes are needed.

To use this function, you need to either first load the {dplyr} library, or always use the function with dplyr::rename() notation.

# Load the library
library(dplyr)
# Or, load the full tidyverse:
library(tidyverse)

# Or, use :: notation
dplyr::rename()

Conceptual Usage

tibble %>% 
  rename(new_name_of_column = current_name_of_column)

Examples

The examples below use the carnivores dataset. Learn more about this dataset with get_help("carnivores").

# Show the carnivores dataset
carnivores

## # A tibble: 9 × 4
##   name              genus        awake brainwt
##   <chr>             <fct>        <dbl>   <dbl>
## 1 Arctic fox        Vulpes        11.5  0.0445
## 2 Cheetah           Acinonyx      11.9 NA     
## 3 Dog               Canis         13.9  0.07  
## 4 Gray seal         Haliochoerus  17.8  0.325 
## 5 Jaguar            Panthera      13.6  0.157 
## 6 Lion              Panthera      10.5 NA     
## 7 Northern fur seal Callorhinus   15.3 NA     
## 8 Red fox           Vulpes        14.2  0.0504
## 9 Tiger             Panthera       8.2 NA

# Rename the `name` column in carnivores to `common_name`
carnivores %>% 
  rename(common_name = name)

## # A tibble: 9 × 4
##   common_name       genus        awake brainwt
##   <chr>             <fct>        <dbl>   <dbl>
## 1 Arctic fox        Vulpes        11.5  0.0445
## 2 Cheetah           Acinonyx      11.9 NA     
## 3 Dog               Canis         13.9  0.07  
## 4 Gray seal         Haliochoerus  17.8  0.325 
## 5 Jaguar            Panthera      13.6  0.157 
## 6 Lion              Panthera      10.5 NA     
## 7 Northern fur seal Callorhinus   15.3 NA     
## 8 Red fox           Vulpes        14.2  0.0504
## 9 Tiger             Panthera       8.2 NA

# Rename the `name` column in carnivores to `common_name`, 
# and rename the `brainwt` column to `brain_weight_kg`
carnivores %>% 
  rename(common_name = name, 
         brain_weight_kg = brainwt)

## # A tibble: 9 × 4
##   common_name       genus        awake brain_weight_kg
##   <chr>             <fct>        <dbl>           <dbl>
## 1 Arctic fox        Vulpes        11.5          0.0445
## 2 Cheetah           Acinonyx      11.9         NA     
## 3 Dog               Canis         13.9          0.07  
## 4 Gray seal         Haliochoerus  17.8          0.325 
## 5 Jaguar            Panthera      13.6          0.157 
## 6 Lion              Panthera      10.5         NA     
## 7 Northern fur seal Callorhinus   15.3         NA     
## 8 Red fox           Vulpes        14.2          0.0504
## 9 Tiger             Panthera       8.2         NA