# Getting started with ggrepel

### Kamil Slowikowski

### 2021-01-15

## Overview

ggrepel provides geoms for ggplot2 to repel overlapping text labels:

- `geom_text_repel()`
- `geom_label_repel()`

Text labels repel away from each other, away from data points, and away from edges of the plotting area (panel).

Let’s compare `geom_text()` and `geom_text_repel()`:

    library(ggrepel)
    set.seed(42)

    dat <- subset(mtcars, wt > 2.75 & wt < 3.45)
    dat$car <- rownames(dat)

    p <- ggplot(dat, aes(wt, mpg, label = car)) +
      geom_point(color = "red")

    p1 <- p + geom_text() + labs(title = "geom_text()")

    p2 <- p + geom_text_repel() + labs(title = "geom_text_repel()")

    gridExtra::grid.arrange(p1, p2, ncol = 2)

## Installation

ggrepel is available on CRAN:

    install.packages("ggrepel")

The latest development version may have new features, and you can get it from GitHub:

    # Use the devtools package
    # install.packages("devtools")
    devtools::install_github("slowkow/ggrepel")

## Usage

See the examples page to learn more about how to use ggrepel in your project.