https://github.com/animint/animint2
Animated interactive grammar of graphics
https://github.com/animint/animint2
Last synced: 2 months ago
JSON representation
Animated interactive grammar of graphics
- Host: GitHub
- URL: https://github.com/animint/animint2
- Owner: animint
- Created: 2014-06-11T02:48:08.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2025-10-21T18:02:49.000Z (2 months ago)
- Last Synced: 2025-10-22T05:58:24.800Z (2 months ago)
- Language: R
- Homepage: https://animint.github.io/animint2/
- Size: 183 MB
- Stars: 70
- Watchers: 6
- Forks: 27
- Open Issues: 48
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
- jimsghstars - animint/animint2 - Animated interactive grammar of graphics (R)
README
`animint2` is a fork of `ggplot2` with
* web-based output,
* and interactivity specified in R code,
* using common column names across data sets.
It supports
* multiple selection variables across multiple linked plots,
* each with multiple layers/geoms (each with its own data set),
* multiple interactive legends per plot,
* multiple panels/facets per plot,
* tooltips, animation, a guided tour, large data sets, and
* rendering from R code chunks in Rmd files, on GitHub Pages, or on any other web server (no special web server required)
Examples can be seen in the [Gallery](https://animint.github.io/gallery/) and manual, [Animated interactive data visualization using animint2 in R](https://animint-manual-en.netlify.app/).
Slides in [English](https://docs.google.com/presentation/d/1QDwo9x4OM7UKAXffJrny6nSfeytFR0kO5NB-NQEspcE/edit?usp=sharing) and [French](https://docs.google.com/presentation/d/1WpRZs9qz9wm1yik_MLj8tIJyWuL5-IBPYKLhOHZ9X4Y/edit?usp=sharing) for a 30-60 minute presentation about animint2!
[Abstract](https://github.com/animint/animint2/wiki/Presentations#30-60-minute-talk),
[Video of presentation in French at Toulouse-Dataviz](https://www.youtube.com/watch?v=Em6AVJi37zo).
[](https://codecov.io/gh/animint/animint2)
## About
Animint2 is an R package for generating and sharing animated interactive data visualizations, sometimes referred to as animints. It is a fork of, and uses similar syntax to, [ggplot2](https://ggplot2.tidyverse.org/). Animint2 is especially useful for large datasets, but smaller datasets can be made interactive, too. It is also capable of generating static data visualizations.
Try interacting with
* [this interactive data visualization of data from the World Bank](https://rcdata.nau.edu/genomic-ml/WorldBank-facets/), or
* [a more recent version which also includes a world map](https://tdhock.github.io/2025-01-WorldBank-facets-map/), or
* [its French translation](https://tdhock.github.io/2025-08-BanqueMondiale-facets-map/)!
For more examples, see these galleries, which have screenshots along with links to the interactive data viz, and source code:
* [GitHub Pages animint gallery](https://animint.github.io/gallery) is a newer collection of 50+ animints that have been published using `animint2pages()`.
* [La galerie en français pour animint2](https://animint.github.io/gallery-fr/) is the French version of the gallery!
* [NAU rcdata animint gallery](https://rcdata.nau.edu/genomic-ml/animint-gallery/) is a gallery of 50+ older examples dating back to animint's inception in 2014.
To learn how to generate your own interactive data visualizations, go to the official [Animint2 Manual](https://animint-manual-en.netlify.app) (newly rendered using quarto since Sept 2025).
If you encounter problems, please see the [animint2 wiki](https://github.com/animint/animint2/wiki) or [report them](https://github.com/animint/animint2/issues).
## Installation
``` r
# Install the official package from CRAN.
# This is the option most people should choose:
install.packages("animint2")
# If you want to install the development version:
devtools::install_github("animint/animint2")
```
## Use
Animint2 uses the same implementation of `ggplot2`’s grammar of graphics—with a few additions. If you’re familiar with `ggplot2`, using `animint2` will be easy. If you’re not, no worries. To get started, see the brief [Animint2 Quick Start Guide](https://animint.github.io/animint2/articles/animint2.html) or read the first few chapters of the [Animint2 Manual](https://rcdata.nau.edu/genomic-ml/animint2-manual/Ch00-preface.html).
`animint2` renders and animates data visualizations. It can neither manipulate the datasets you give it nor generate its own data.
## Similar Packages
`animint2` isn’t the only R package that can create animated or interactive data visualizations.
[animation](https://cran.r-project.org/package=animation) and [gganimate](https://cloud.r-project.org/web/packages/gganimate/index.html) can animate changes between variables over time. The [loon](https://cran.r-project.org/package=loon) package specializes in exploratory data analysis. [plotly](https://cran.r-project.org/package=plotly) is probably most similar to animint2 in terms of functionality.
For comparisons between the aforementioned packages and `animint2`, see [the differences wiki page](https://github.com/animint/animint2/wiki/Differences-with-other-packages).
## Problems?
The `animint2` package is a work in progress. If you spot any bugs or unexpected behaviors, please let us know by [reporting it as an issue on GitHub](https://github.com/animint/animint2/issues). Thanks! Have a great day.
## Other galleries
Toby Hocking maintains repositories on specific subjects:
* [gallery-ml](https://tdhock.github.io/gallery-ml) contains data visualizations related to machine learning algorithms.
* [gallery-change-point](https://tdhock.github.io/gallery-change-point) contains data visualizations related to change-point detection algorithms.
* [gallery-hic](https://tdhock.github.io/gallery-hic) contains data visualizations related to Hi-C data analysis.
[Vatsal-Rajput](https://github.com/Vatsal-Rajput/Vatsal-Animint-Gallery/tree/gh-pages) created a small gallery with a different index.Rmd file.
[nhintruong](https://nhintruong.github.io/gallery_repo/) created a gallery with several examples adapted from the animation package, like [the wiki page](https://github.com/tdhock/animint/wiki/Ports-of-animation-examples).