https://github.com/slowkow/ggrepel

:round_pushpin: Repel overlapping text labels away from each other in your ggplot2 figures.
https://github.com/slowkow/ggrepel

cran ggplot2 rstats text visualization

Last synced: 2 days ago
JSON representation

:round_pushpin: Repel overlapping text labels away from each other in your ggplot2 figures.

• Host: GitHub
• URL: https://github.com/slowkow/ggrepel
• Owner: slowkow
• License: gpl-3.0
• Created: 2016-01-03T22:10:58.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-11-04T15:51:47.000Z (about 1 month ago)
• Last Synced: 2024-11-26T06:05:21.537Z (16 days ago)
• Topics: cran, ggplot2, rstats, text, visualization
• Language: R
• Homepage: https://ggrepel.slowkow.com
• Size: 39 MB
• Stars: 1,222
• Watchers: 26
• Forks: 96
• Open Issues: 36
• Metadata Files:
  • Readme: README.md
  • Changelog: NEWS.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-r-dataviz - ggrepel - Repel overlapping text labels away from each other. (ggplot / Text)
• jimsghstars - slowkow/ggrepel - :round_pushpin: Repel overlapping text labels away from each other in your ggplot2 figures. (R)

README

        
ggrepel 

============================================

[![Build Status][bb]][githubactions] [![CRAN_Status_Badge][cb]][cran] [![CRAN_Downloads_Badge][db]][r-pkg]

[bb]: https://github.com/slowkow/ggrepel/workflows/R-CMD-check/badge.svg

[githubactions]: https://github.com/slowkow/ggrepel/actions?query=workflow%3AR-CMD-check

[cb]: https://www.r-pkg.org/badges/version/ggrepel?color=blue

[cran]: https://CRAN.R-project.org/package=ggrepel

[db]: https://cranlogs.r-pkg.org/badges/ggrepel

[r-pkg]: https://cranlogs.r-pkg.org

Overview

--------

ggrepel provides geoms for [ggplot2] to repel overlapping text labels:

[ggplot2]: https://ggplot2.tidyverse.org

- `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.

```r

library(ggrepel)

ggplot(mtcars, aes(wt, mpg, label = rownames(mtcars))) +

  geom_text_repel() +

  geom_point(color = 'red') +

  theme_classic(base_size = 16)

```







Installation

------------

```r

# The easiest way to get ggrepel is to install it from CRAN:

install.packages("ggrepel")

# Or get the the development version from GitHub:

# install.packages("devtools")

devtools::install_github("slowkow/ggrepel")

```

Usage

-----

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

[examples]: https://ggrepel.slowkow.com/articles/examples.html

Examples

--------

Click one of the images below to go to see the code example:















































Contributing

------------

Please [submit an issue][issues] to report bugs or ask questions.

Please contribute bug fixes or new features with a [pull request][pull] to this

repository.

[issues]: https://github.com/slowkow/ggrepel/issues

[pull]: https://help.github.com/articles/using-pull-requests/