# thomasp85/ggraph

Grammar of Graph Graphics

Repository: https://github.com/thomasp85/ggraph
Canonical: https://ross.abutalabs.com/products/ggraph
Homepage: https://ggraph.data-imaginist.com
Language: R
License: NOASSERTION
License Family: other
Topics: graph-visualization, ggplot2, visualization, network-visualization, r, ggplot-extension
Last push: 2025-08-25T06:42:17+00:00

## Health v2 (maintenance only)
Score: 41/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 38, release rhythm 12, longevity 100
- inputs: {"age_days": 3885, "days_push": 373, "days_rel": 373, "gap_med": null, "n_releases_24m": 1}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1116, forks 114 (observed 2026-08-28T04:03:38.717993+00:00)

## What it is
ggraph is an R package that extends ggplot2's grammar of graphics to relational data such as networks, graphs, and trees. It adds the concept of layouts to the grammar and provides dedicated geom_node_*() and geom_edge_*() geoms so graph visualizations compose like any other ggplot2 plot.

## Use cases
- visualize network graphs in R using ggplot2 syntax
- plot nodes and edges of an igraph or tidygraph graph
- draw trees, dendrograms, or hierarchical data as plots
- create treemaps, icicle plots, hive plots, or circle packing charts
- make faceted network visualizations grouped by node or edge attributes
- add statistical graph graphics to a tidyverse data-science workflow

## When to choose
- You already use ggplot2 and the tidyverse and want network, graph, or tree plots in the same declarative style
- You need a wide choice of graph layouts (Kamada-Kawai, hive, treemap, circle packing, plus all igraph layouts) combined with layered geoms and facets
- You want publication-quality static graph figures with full control over nodes, edges, and theming

## When to avoid
- You need interactive, browser-based network exploration rather than static graphics
- You are not working in R (the package is a ggplot2/tidygraph companion)
- You want a one-line plot function with no grammar-of-graphics learning curve

## Facets
- artifact type: library
- maturity: stable
- function: data-visualization, charts
- domain: data-visualization, data-science
- platform: cross-platform
- tags: r, ggplot2, ggplot2-extension, tidygraph, igraph, network-graphs, graph-layouts, trees, treemaps, hive-plots, circle-packing, node-edge-geoms, cran, statistical-graphics

## Member repositories
- thomasp85/ggraph (main) score 41

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:38.717993+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:42:06.315101+00:00, confidence not recorded.
  - readme: https://github.com/thomasp85/ggraph (fetched 2026-08-28T04:03:38.717993+00:00, sha 128ee0eb2265)
  - homepage: https://ggraph.data-imaginist.com (fetched 2026-08-29T12:45:49.283837+00:00, sha af9b560f91c6)
  - site_page: https://ggraph.data-imaginist.com/authors.html (fetched 2026-08-29T12:45:49.293422+00:00, sha 4e7e59546a15)
- Data as of 2026-08-30T08:39:29.467469+00:00.