matplotlib.figure.Figure.add_gridspec#

Figure.add_gridspec(nrows=1,ncols=1,**kwargs)[source]#

Low-level API for creating aGridSpec that has this figure as a parent.

This is a low-level API, allowing you to create a gridspec andsubsequently add subplots based on the gridspec. Most users donot need that freedom and should use the higher-level methodssubplots orsubplot_mosaic.

Parameters:
nrowsint, default: 1

Number of rows in grid.

ncolsint, default: 1

Number of columns in grid.

Returns:
GridSpec
Other Parameters:
**kwargs

Keyword arguments are passed toGridSpec.

Examples

Adding a subplot that spans two rows:

fig=plt.figure()gs=fig.add_gridspec(2,2)ax1=fig.add_subplot(gs[0,0])ax2=fig.add_subplot(gs[1,0])# spans two rows:ax3=fig.add_subplot(gs[:,1])

Examples usingmatplotlib.figure.Figure.add_gridspec#

Custom spines with axisartist

Custom spines with axisartist

Scatter plot with histograms

Scatter plot with histograms

Resize Axes with tight layout

Resize Axes with tight layout

Create multiple subplots using plt.subplots

Create multiple subplots using plt.subplots

Arranging multiple Axes in a Figure

Arranging multiple Axes in a Figure

Constrained layout guide

Constrained layout guide