Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

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: about 2 months ago
JSON representation

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

Lists

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:

Hide some of the labels
Always show all labels, even when they have too many overlaps
Do not repel labels from data points
Do not repel labels from plot (panel) edges
Expand the scale to make room for labels
Always (or never) draw line segments
Make curved line segments or arrows
Repel labels from data points with different
<br />sizes
Limit labels to a specific area
Remove “a” from the legend
Align labels on the top or bottom edge
Align labels on the left or right edge
Using ggrepel with stat_summary()
Justify multiple lines of text with hjust
Label jittered points
Nudge labels in different directions with ggpp
Label sf objects
Shadows (or glow) under text labels
Verbose timing information
Word cloud
Polar coordinates
Unicode characters (Japanese)
Mathematical expressions

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/