ggbrain: Plot brain atlas regions

In ggseg: Plotting Tool for Brain Atlases

Plot brain atlas regions

Description

Colour brain regions by your own values. Give 'geom_brain()' an atlas like 'dk()' and a data frame, and it matches your values to the right regions and lays out the brain views for you. No data? It just draws the atlas.

Usage

geom_brain(
  mapping = aes(),
  data = NULL,
  atlas,
  hemi = NULL,
  view = NULL,
  position = position_brain(),
  context = TRUE,
  show.legend = NA,
  inherit.aes = TRUE,
  ...
)

Arguments

mapping	Set of aesthetic mappings created by [ggplot2::aes()].
data	A data.frame containing variables to map. If 'NULL', the atlas is plotted without user data. Group it with [dplyr::group_by()] to facet.
atlas	A 'ggseg_atlas' object (e.g. 'dk()', 'aseg()', 'tracula()').
hemi	Character vector of hemispheres to include (e.g. '"left"', '"right"'). Defaults to all hemispheres in the atlas.
view	Character vector of views to include, as recorded in the atlas data. For cortical atlases: '"lateral"', '"medial"'. For subcortical/tract atlases: slice identifiers like '"axial_3"'. Defaults to all views.
position	Position adjustment, either as a string or the result of a call to [position_brain()].
context	Keep the rest of the brain as a soft grey backdrop ('TRUE', the default), or show only the regions you're plotting ('FALSE').
show.legend	Logical. Should this layer be included in the legends?
inherit.aes	Logical. If 'FALSE', overrides the default aesthetics rather than combining with them.
...	Additional arguments passed to [ggplot2::geom_polygon()].

Value

A list of ggplot2 layer and coord objects.

GeomBrain ggproto

'GeomBrain' is a [ggplot2::Geom] ggproto object that handles rendering of brain atlas polygons. It is used internally by [geom_brain()] and should not typically be called directly.

Examples

library(ggplot2)

ggplot() +
  geom_brain(atlas = dk())

ggseg documentation built on June 22, 2026, 9:09 a.m.