lets_plot.gggrid

lets_plot.gggrid(plots: list, ncol: Optional[int] = None, *, widths: Optional[list] = None, heights: Optional[list] = None, hspace: Optional[float] = None, vspace: Optional[float] = None, fit: Optional[bool] = None, align: Optional[bool] = None)

Combine several plots on one figure, organized in a regular grid.

Parameters

plotslist

A list where each element is a plot specification, a subplots specification, or None. Use value None to fill-in empty cells in grid.

ncolint

Number of columns in grid. If not specified, shows plots horizontally, in one row.

widthslist of numbers

Relative width of each column of grid, left to right.

heightslist of numbers

Relative height of each row of grid, top-down.

hspacefloat, default=4.0

Cell horizontal spacing in px.

vspacefloat, default=4.0

Cell vertical spacing in px.

fitbool, default=True

Whether to stretch each plot to match the aspect ratio of its cell (fit=True), or to preserve the original aspect ratio of plots (fit=False).

alignbool, default=False

If True, align inner areas (i.e. “geom” bounds) of plots. However, cells containing other (sub)grids are not participating in the plot “inner areas” layouting.

Returns

SupPlotsSpec

The grid specification.

Examples

import numpy as np
from lets_plot import *
LetsPlot.setup_html()
np.random.seed(42)
n = 100
x = np.arange(n)
y = np.random.normal(size=n)
w, h = 200, 150
p = ggplot({'x': x, 'y': y}, aes(x='x', y='y')) + ggsize(w, h)
plot_list=[
    gggrid([p+geom_point(), p+geom_histogram(bins=3)]),
    p+geom_line()
]
gggrid(plot_list, ncol=1) + ggsize(400, 300)