RGraphSpace: A lightweight interface between igraph and ggplot2 graphics

Highlights

• Native ggplot2 interface for igraph objects
• Optimized geoms for large-scale network visualization
• Spatial alignment of networks with reference backgrounds
• Interoperability with ggraph and tidygraph workflows

Overview

RGraphSpace is an R package that generates ggplot2 graphics for igraph objects (Csardi and Nepusz 2006), scaling nodes and edges to a unit space. The package implements new ggplot2 prototypes (Wickham 2016), optimized for representing large networks. This enables extensive customization of aesthetics and visual style, including interoperability with ggraph and tidygraph workflows (Pedersen 2024). Two specialized geoms translate graph data into geometric layers.

1. geom_nodespace(): Renders network nodes. Extends GeomPoint aesthetic mappings and exposes node state information to the edge layer.
2. geom_edgespace(): Renders the relationships between nodes. Extends GeomSegment aesthetic mappings; unlike standard segments, it is node-aware and dynamically adjusts start and end points based on node position and size.

Installation in R (>=4.5)

Dependencies to build the vignettes

install.packages("knitr")
install.packages("rmarkdown")
install.packages("remotes")

Development version

remotes::install_github("sysbiolab/RGraphSpace", build_vignettes=TRUE)

Tutorials

• https://sysbiolab.github.io/RGraphSpace

• https://sysbiolab.github.io/PathwaySpace

Citation

If you use RGraphSpace, please cite:

• Sysbiolab Team (2026). RGraphSpace: A lightweight interface between 'igraph' and 'ggplot2' graphics. R package version 1.3.0. Doi: 10.32614/CRAN.package.RGraphSpace

Licenses

The RGraphSpace package is distributed under Artistic-2.0

References

• Wickham H: ggplot2: Elegant Graphics for Data Analysis. Springer-Verlag New York, 2016. https://ggplot2.tidyverse.org

• Csardi G, Nepusz T: The igraph software package for complex network research. InterJournal, Complex Systems 1695. 2006. https://igraph.org

• Pedersen T: tidygraph: A Tidy API for Graph Manipulation. R package version 1.3.1. 2024. doi:10.32614/CRAN.package.tidygraph