geom_subplot_grid.md

---

title: subplot_grid author: Daniel Jones part: Geometry order: 1011 ...

Draw multiple subplots in a grid orginized by one or two categorial vectors.

Aesthetics

• xgroup (optional): Arrange subplots on the X-axis by categorial data.
• ygroup (optional): Arrange subplots on the Y-axis by categorial data.
• free_y_axis (optional): Whether the y-axis scales can differ across the subplots. Defaults to false. If true, scales are set appropriately for individual subplots.
• free_x_axis (optional): Whether the x-axis scales can differ across the subplots. Defaults to false. If true, scales are set appropriately for individual subplots.

One or both of xgroup or ygroup must be bound. If only one, a single column or row of subplots is drawn, if both, a grid.

Arguments

Geom.subplot_grid(elements::Gadfly.ElementOrFunction...)

Unlike most geometries, Geom.subplot_grid is typically passed one or more parameters. The constructor works for the most part like the layer function. Arbitrary plot elements may be passed, while aesthetic bindings are inherited from the parent plot.

Examples

using RDatasets
using Gadfly

Gadfly.set_default_plot_size(14cm, 8cm)

set_default_plot_size(20cm, 7.5cm)
plot(dataset("datasets", "OrchardSprays"),
     xgroup="Treatment", x="ColPos", y="RowPos", color="Decrease",
     Geom.subplot_grid(Geom.point))

set_default_plot_size(14cm, 25cm)
plot(dataset("vcd", "Suicide"), xgroup="Sex", ygroup="Method", x="Age", y="Freq",
     Geom.subplot_grid(Geom.bar))

Free/fixed scales:

using DataFrames
set_default_plot_size(8cm, 12cm)

widedf = DataFrame(x = [1:10], var1 = [1:10], var2 = [1:10].^2)
longdf = stack(widedf, [:var1, :var2])

Default behavior is for the axes' scales to be fixed across the subplots:

plot(longdf, ygroup="variable", x="x", y="value", Geom.subplot_grid(Geom.point))

We can change this default behavior where appropriate:

plot(longdf, ygroup="variable", x="x", y="value", Geom.subplot_grid(Geom.point, free_y_axis=true))