# hadley/ggplot2-book

ggplot2: elegant graphics for data analysis

Repository: https://github.com/hadley/ggplot2-book
Canonical: https://ross.abutalabs.com/products/ggplot2-book
Homepage: https://ggplot2-book.org/
Language: Perl
License Family: other
Last push: 2025-03-12T05:25:29+00:00

## Health v2 (maintenance only)
Score: 28/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 11, release rhythm 8, longevity 100
- inputs: {"age_days": 6680, "days_push": 539, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- 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 1687, forks 716 (observed 2026-08-28T04:05:22.180324+00:00)

## What it is
The source for 'ggplot2: Elegant Graphics for Data Analysis', an open-access book by Hadley Wickham, Danielle Navarro, and Thomas Lin Pedersen, built with bookdown and available online at ggplot2-book.org. It teaches the Grammar of Graphics underlying ggplot2 and how to create and customize data visualizations in R.

## Use cases
- learn ggplot2 from scratch
- understand the grammar of graphics theory
- customize ggplot2 plots beyond default recipes
- find a free reference book for R data visualization
- learn faceting, aesthetics, and geoms in ggplot2
- contribute corrections to the ggplot2 book

## When to choose
- you want a free, authoritative, in-depth explanation of ggplot2 and its underlying theory
- you need to understand why plots work, not just copy recipes
- you are learning R-based data visualization from the ggplot2 author

## When to avoid
- you need a cookbook of ready-made plot recipes for specific graphics
- you use a plotting library other than ggplot2 or a language other than R
- you need a stable printed edition rather than a work-in-progress draft

## Facets
- artifact type: learning-resource
- maturity: active
- function: data-visualization, documentation
- domain: data-visualization, data-science, tutorials
- platform: cross-platform
- tags: r, ggplot2, bookdown, grammar-of-graphics, open-access-book

## Member repositories
- hadley/ggplot2-book (main) score 28

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:22.180324+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-30T03:38:51.515519+00:00, confidence not recorded.
  - readme: https://github.com/hadley/ggplot2-book (fetched 2026-08-28T04:05:22.180324+00:00, sha 56cf62825882)
  - homepage: https://ggplot2-book.org/ (fetched 2026-08-29T11:13:42.390398+00:00, sha f0a148f6210b)
  - site_page: https://ggplot2-book.org/getting-started.html (fetched 2026-08-29T11:13:42.400261+00:00, sha 30c46107a8bc)
- Data as of 2026-08-30T08:39:29.467469+00:00.