matplotlib.axes.SubplotBase

class matplotlib.axes.SubplotBase(fig, *args, **kwargs)[source]

Bases: object

Base class for subplots, which are Axes instances with additional methods to facilitate generating and manipulating a set of Axes within a figure.

Parameters:
figmatplotlib.figure.Figure
*argstuple (nrows, ncols, index) or int

The array of subplots in the figure has dimensions (nrows, ncols), and index is the index of the subplot being created. index starts at 1 in the upper left corner and increases to the right.

If nrows, ncols, and index are all single digit numbers, then args can be passed as a single 3-digit number (e.g. 234 for (2, 3, 4)).

**kwargs

Keyword arguments are passed to the Axes (sub)class constructor.

__dict__ = mappingproxy({'__module__': 'matplotlib.axes._subplots', '__doc__': '\n Base class for subplots, which are :class:`Axes` instances with\n additional methods to facilitate generating and manipulating a set\n of :class:`Axes` within a figure.\n ', '__init__': <function SubplotBase.__init__>, '__reduce__': <function SubplotBase.__reduce__>, 'get_geometry': <function SubplotBase.get_geometry>, 'change_geometry': <function SubplotBase.change_geometry>, 'get_subplotspec': <function SubplotBase.get_subplotspec>, 'set_subplotspec': <function SubplotBase.set_subplotspec>, 'get_gridspec': <function SubplotBase.get_gridspec>, 'update_params': <function SubplotBase.update_params>, 'rowNum': <matplotlib.cbook.deprecation.deprecated.<locals>.deprecate.<locals>._deprecated_property object>, 'colNum': <matplotlib.cbook.deprecation.deprecated.<locals>.deprecate.<locals>._deprecated_property object>, 'is_first_row': <function SubplotBase.is_first_row>, 'is_last_row': <function SubplotBase.is_last_row>, 'is_first_col': <function SubplotBase.is_first_col>, 'is_last_col': <function SubplotBase.is_last_col>, 'label_outer': <function SubplotBase.label_outer>, '_make_twin_axes': <function SubplotBase._make_twin_axes>, '__repr__': <function SubplotBase.__repr__>, '__dict__': <attribute '__dict__' of 'SubplotBase' objects>, '__weakref__': <attribute '__weakref__' of 'SubplotBase' objects>})
__init__(self, fig, *args, **kwargs)[source]
Parameters:
figmatplotlib.figure.Figure
*argstuple (nrows, ncols, index) or int

The array of subplots in the figure has dimensions (nrows, ncols), and index is the index of the subplot being created. index starts at 1 in the upper left corner and increases to the right.

If nrows, ncols, and index are all single digit numbers, then args can be passed as a single 3-digit number (e.g. 234 for (2, 3, 4)).

**kwargs

Keyword arguments are passed to the Axes (sub)class constructor.

__module__ = 'matplotlib.axes._subplots'
__reduce__(self)[source]

Helper for pickle.

__repr__(self)[source]

Return repr(self).

__weakref__

list of weak references to the object (if defined)

change_geometry(self, numrows, numcols, num)[source]

Change subplot geometry, e.g., from (1, 1, 1) to (2, 2, 3).

property colNum
get_geometry(self)[source]

Get the subplot geometry, e.g., (2, 2, 3).

get_gridspec(self)[source]

Return the GridSpec instance associated with the subplot.

get_subplotspec(self)[source]

Return the SubplotSpec instance associated with the subplot.

is_first_col(self)[source]
is_first_row(self)[source]
is_last_col(self)[source]
is_last_row(self)[source]
label_outer(self)[source]

Only show "outer" labels and tick labels.

x-labels are only kept for subplots on the last row; y-labels only for subplots on the first column.

property rowNum
set_subplotspec(self, subplotspec)[source]

Set the SubplotSpec. instance associated with the subplot.

update_params(self)[source]

Update the subplot position from self.figure.subplotpars.