You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Applications are open for the 2018 John Hunter Matplotlib Summer Fellowship. Apply now!
Version 2.2.2.post1752+g4b1f956cb
Fork me on GitHub

Table Of Contents


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

Create an axis at specific location inside a regular grid.

shape : sequence of 2 ints

Shape of grid in which to place axis. First entry is number of rows, second entry is number of columns.

loc : sequence of 2 ints

Location to place axis within grid. First entry is row number, second entry is column number.

rowspan : int

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

colspan : int

Number of columns for the axis to span downwards.

fig : Figure, optional

Figure to place axis in. Defaults to current figure.


Additional keyword arguments are handed to add_subplot.


The following call

subplot2grid(shape, loc, rowspan=1, colspan=1)

is identical to

gridspec=GridSpec(shape[0], shape[1])
subplotspec=gridspec.new_subplotspec(loc, rowspan, colspan)