matplotlib.pyplot.subplot2grid#

matplotlib.pyplot.subplot2grid(shape, loc, rowspan=1, colspan=1, fig=None, **kwargs)[source]#

Create a subplot at a specific location inside a regular grid.

Parameters:
shape(int, int)

Number of rows and of columns of the grid in which to place axis.

loc(int, int)

Row number and column number of the axis location within the grid.

rowspanint, default: 1

Number of rows for the axis to span downwards.

colspanint, default: 1

Number of columns for the axis to span to the right.

figFigure, optional

Figure to place the subplot in. Defaults to the current figure.

**kwargs

Additional keyword arguments are handed to add_subplot.

Returns:
Axes

The Axes of the subplot. The returned Axes can actually be an instance of a subclass, such as projections.polar.PolarAxes for polar projections.

Notes

The following call

ax = subplot2grid((nrows, ncols), (row, col), rowspan, colspan)

is identical to

fig = gcf()
gs = fig.add_gridspec(nrows, ncols)
ax = fig.add_subplot(gs[row:row+rowspan, col:col+colspan])

Examples using matplotlib.pyplot.subplot2grid#

Resizing axes with tight layout

Resizing axes with tight layout

subplot2grid demo

subplot2grid demo

Constrained layout guide

Constrained layout guide

Tight layout guide

Tight layout guide

Arranging multiple Axes in a Figure

Arranging multiple Axes in a Figure