tidyverse.org valid

ggplot2

For agents: Reference documentation for ggplot2, the R data visualization package: ggplot(), layers, geoms, aesthetics, annotations, labels and saving plots.

ggplot2r packagedata visualizationplottinggeoms

Their llms.txt

The beginning of the file, from our validated copy saved 2026-10-23T01:41:25.038Z. Cached copy · Source on tidyverse.org

# ggplot2

## Overview

ggplot2 is a system for declaratively creating graphics, based on [The
Grammar of
Graphics](https://link.springer.com/book/10.1007/0-387-28695-0). You
provide the data, tell ggplot2 how to map variables to aesthetics, what
graphical primitives to use, and it takes care of the details.

## Installation

``` r
# The easiest way to get ggplot2 is to install the whole tidyverse:
install.packages("tidyverse")

# Alternatively, install just ggplot2:
install.packages("ggplot2")

# Or the development version from GitHub:
# install.packages("pak")
pak::pak("tidyverse/ggplot2")
```

## Cheatsheet

[![ggplot2
cheatsheet](https://raw.githubusercontent.com/rstudio/cheatsheets/master/pngs/thumbnails/data-visualization-cheatsheet-thumbs.png)](https://github.com/rstudio/cheatsheets/blob/master/data-visualization.pdf)

## Usage

It’s hard to succinctly describe how ggplot2 works because it embodies a
deep philosophy of visualisation. However, in most cases you start with
[`ggplot()`](https://ggplot2.tidyverse.org/reference/ggplot.md), supply
a dataset and aesthetic mapping (with
[`aes()`](https://ggplot2.tidyverse.org/reference/aes.md)). You then add
on layers (like
[`geom_point()`](https://ggplot2.tidyverse.org/reference/geom_point.md)
or
[`geom_histogram()`](https://ggplot2.tidyverse.org/reference/geom_histogram.md)),
scales (like
[`scale_colour_brewer()`](https://ggplot2.tidyverse.org/reference/scale_brewer.md)),
faceting specifications (like
[`facet_wrap()`](https://ggplot2.tidyverse.org/reference/facet_wrap.md))
and coordinate systems (like
[`coord_flip()`](https://ggplot2.tidyverse.org/reference/coord_flip.md)).

``` r
library(ggplot2)

ggplot(mpg, aes(displ, hwy, colour = class)) +
  geom_point()
```

![Scatterplot of engine displacement versus highway miles per gallon,
for 234 cars coloured by 7 'types' of car. The displacement and miles
per gallon are inversely
correlated.](reference/figures/README-example-1.png)

## Lifecycle
…

Related sites

Other listed sites in Data and analytics. See the whole category →

Machine-readable: GET /v1/resolve?q=tidyverse.org · GET /v1/domain/tidyverse.org · this page as Accept: application/json or text/markdown · MCP lookup_domain

Automatically discovered from public files. Inclusion does not imply endorsement or publisher participation.

Claim my listing on Agent Web Map for tidyverse.org:
1. POST https://agentwebmap.com/v1/sites/tidyverse.org/claims and keep claim_id and claim_secret private.
2. Publish the proof: add the line "AgentWebMap ownership: <token>" (token from step 1) to https://tidyverse.org/llms.txt, or use the DNS, meta-tag or well-known method the response describes.
3. POST https://agentwebmap.com/v1/sites/tidyverse.org/verify with {"claim_id": "...", "claim_secret": "..."}.
4. Save the api_key from the answer; it manages the listing (PATCH https://agentwebmap.com/v1/sites/tidyverse.org).
MCP equivalent: tools begin_ownership_claim, then verify_domain, at https://agentwebmap.com/mcp. Docs: https://agentwebmap.com/docs#verify

Corrections or removal requests: contact the directory.