README.md

Animint2

A badge verifying if this package has passed all its tests.

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. Animint2 is especially useful for large datasets, but smaller datasets can be made interactive, too. It is also capable of generating static data visualizations.

A screencast of an interactive data visualization displaying fertility data from the World Bank. The user types in the selection menu and clicks on the legend, which causes changes in the visualization. GIF.

Play around with this interactive data visualization of data from the World Bank. For more examples, see these galleries, which have screenshots along with links to the interactive data viz, and source code: NAU rcdata animint gallery has 50+ big data viz examples dating back to animint's inception in 2014. GitHub Pages animint gallery is a newer collection of animints that have been published using the animint2pages function.

To learn how to generate your own interactive data visualizations, go to the official Animint2 Manual. If you encounter problems, please see the animint2 wiki or report them.

Installation

# 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 or read the first few chapters of the Animint2 Manual.

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 and gganimate can animate changes between variables over time. The loon package specializes in exploratory data analysis. plotly is probably most similar to animint2 in terms of functionality.

For comparisons between the aforementioned packages and animint2, see the differences wiki page.

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. Thanks! Have a great day.

Other galleries

Vatsal-Rajput created a small gallery with a different index.Rmd file.

nhintruong created a gallery with several example adapted from the animation package, like the wiki page.



tdhock/animint2 documentation built on April 14, 2024, 4:22 p.m.