This package allows to pass network objects to ggplot2 and provides geometries to plot their elements.

Get started

You can install the released version of ggnetwork from CRAN with:

install.packages("ggnetwork")

And the development version from GitHub with:

# install.packages("remotes")
remotes::install_github("briatte/ggnetwork")

The ggnetwork package depends on R 3.5+ and on ggplot2 version 2.0.0+.

Documentation

For further examples that use ggnetwork with other packages to produce animated graphs, see James Curley’s slides on “Interactive and Dynamic Network Visualization in R” (2016). For even more options, see Katherine Ognyanova’s tutorial “Network visualization with R (2019), and David Schoch’s guide “Network Visualizations in R using ggraph and graphlayouts” (2019).

Getting help

If you encounter a clear bug, please file a minimal reproducible example on GitHub.

For questions and other discussion, please contact the package maintainer, or ask other users on Stack Overflow.

Citation

You can get a citation for the package from R:

citation("ggnetwork")

See also

The ggnetwork package was written within a larger development effort around network visualization with ggplot2, on which you can read the following article:

Sam Tyner, François Briatte and Heike Hofmann, “Network Visualization with ggplot2,” The R Journal 9(1): 27–59, 2017.

The article also covers the related packages geomnet and ggnet. It does not cover the more recent ggraph, graphlayouts and tidygraph, although you should turn to those if you need a highly extensive way to build and plot ‘tidy’ networks with ggplot2.

Thanks

Thanks to @achmurzy, @andrewd789, @ArtemSokolov, @aterhorst, @Edouard-Legoupil, @emillykkejensen, @EvanUp, @evinhas, @ferroao, @FinScience, @ghost, @instantkaffee, @jalapic, @jcfisher, @jfaganUK, @kippjohnson, @koheiw, @komalsrathi, @krlmlr, @mbojan, @mcanouil, @mgagliol, @mhairi, @minimaxir, @mkarikom, @nick-youngblut, @pinguinjay, @SantiFilippo, @sciabolazza, @sctyner, @sndmrc, @trinker, @zachcp and two anonymous R Journal reviewers. @heike and @ethen8181 also helped with the tricky issue of having arrows on directed edges, while @sumtxt inspired this package as well as its predecessor, the ggnet package, which also benefitted from discussions with @pedroj and Bertrand Sudre.


Please note that this project is released with a Contributor Code of Conduct.
By participating in this project you agree to abide by its terms.