orb_facet: Split a plot into small multiples

In orbis: Interactive and High-Resolution Layered Graphics with Built-in World Maps

Split a plot into small multiples

Description

Faceting draws one panel per level of a grouping variable, laid out in a grid. Comparing many small panels that share a scale is often clearer than overplotting every group in one panel.

Usage

orb_facet(by, ncol = NULL, scales = c("fixed", "free_x", "free_y", "free"))

Arguments

by	Bare column name to facet by, for example orb_facet(cyl).
ncol	Number of columns in the grid. The default chooses a roughly square arrangement.
scales	Whether panels share their axes: "fixed" (the default, so panels are directly comparable), "free_x", "free_y" or "free".

Value

An object of class orb_facet, to be added to a plot.

Examples

orb(mtcars, x = wt, y = mpg) + orb_points() + orb_facet(cyl)
orb(mtcars, x = wt, y = mpg) + orb_points() +
  orb_facet(cyl, ncol = 3, scales = "free")

orbis documentation built on Aug. 5, 2026, 9:08 a.m.