You are reading an old version of the documentation (v2.0.2). For the latest version see https://matplotlib.org/stable/
matplotlib

Travis-CI:

This Page

mpl_toolkits.axes_grid.axes_divider

class mpl_toolkits.axes_grid.axes_divider.Divider(fig, pos, horizontal, vertical, aspect=None, anchor='C')

This is the class that is used calculates the axes position. It divides the given rectangular area into several sub-rectangles. You initialize the divider by setting the horizontal and vertical lists of sizes (mpl_toolkits.axes_grid.axes_size) that the division will be based on. You then use the new_locator method to create a callable object that can be used as the axes_locator of the axes.

Parameters:

fig : Figure

pos : tuple of 4 floats

position of the rectangle that will be divided

horizontal : list of axes_size

sizes for horizontal division

vertical : list of axes_size

sizes for vertical division

aspect : bool

if True, the overall rectangular area is reduced so that the relative part of the horizontal and vertical scales have the same scale.

anchor : {‘C’, ‘SW’, ‘S’, ‘SE’, ‘E’, ‘NE’, ‘N’, ‘NW’, ‘W’}

placement of the reduced rectangle when aspect is True

add_auto_adjustable_area(use_axes, pad=0.1, adjust_dirs=None)
append_size(position, size)
get_anchor()

return the anchor

get_aspect()

return aspect

get_horizontal()

return horizontal sizes

get_horizontal_sizes(renderer)
get_locator()
get_position()

return the position of the rectangle.

get_position_runtime(ax, renderer)
get_vertical()

return vertical sizes

get_vertical_sizes(renderer)
get_vsize_hsize()
locate(nx, ny, nx1=None, ny1=None, axes=None, renderer=None)
Parameters:

nx, nx1 : int

Integers specifying the column-position of the cell. When nx1 is None, a single nx-th column is specified. Otherwise location of columns spanning between nx to nx1 (but excluding nx1-th column) is specified.

ny, ny1 : int

Same as nx and nx1, but for row positions.

axes

renderer

new_locator(nx, ny, nx1=None, ny1=None)

Returns a new locator (mpl_toolkits.axes_grid.axes_divider.AxesLocator) for specified cell.

Parameters:

nx, nx1 : int

Integers specifying the column-position of the cell. When nx1 is None, a single nx-th column is specified. Otherwise location of columns spanning between nx to nx1 (but excluding nx1-th column) is specified.

ny, ny1 : int

Same as nx and nx1, but for row positions.

set_anchor(anchor)
Parameters:

anchor : {‘C’, ‘SW’, ‘S’, ‘SE’, ‘E’, ‘NE’, ‘N’, ‘NW’, ‘W’}

anchor position

value description
‘C’ Center
‘SW’ bottom left
‘S’ bottom
‘SE’ bottom right
‘E’ right
‘NE’ top right
‘N’ top
‘NW’ top left
‘W’ left
set_aspect(aspect=False)
Parameters:aspect : bool
set_horizontal(h)
Parameters:

h : list of axes_size

sizes for horizontal division

set_locator(_locator)
set_position(pos)

set the position of the rectangle.

Parameters:

pos : tuple of 4 floats

position of the rectangle that will be divided

set_vertical(v)
Parameters:

v : list of axes_size

sizes for vertical division

class mpl_toolkits.axes_grid.axes_divider.AxesLocator(axes_divider, nx, ny, nx1=None, ny1=None)

A simple callable object, initialized with AxesDivider class, returns the position and size of the given cell.

Parameters:

axes_divider : AxesDivider

nx, nx1 : int

Integers specifying the column-position of the cell. When nx1 is None, a single nx-th column is specified. Otherwise location of columns spanning between nx to nx1 (but excluding nx1-th column) is specified.

ny, ny1 : int

Same as nx and nx1, but for row positions.

get_subplotspec()
class mpl_toolkits.axes_grid.axes_divider.SubplotDivider(fig, *args, **kwargs)

The Divider class whose rectangle area is specified as a subplot geometry.

Parameters:

fig : matplotlib.figure.Figure

args : tuple (numRows, numCols, plotNum)

The array of subplots in the figure has dimensions numRows, numCols, and plotNum is the number of the subplot being created. plotNum starts at 1 in the upper left corner and increases to the right.

If numRows <= numCols <= plotNum < 10, args can be the decimal integer numRows * 100 + numCols * 10 + plotNum.

change_geometry(numrows, numcols, num)

change subplot geometry, e.g., from 1,1,1 to 2,2,3

get_geometry()

get the subplot geometry, e.g., 2,2,3

get_position()

return the bounds of the subplot box

get_subplotspec()

get the SubplotSpec instance

set_subplotspec(subplotspec)

set the SubplotSpec instance

update_params()

update the subplot position from fig.subplotpars

class mpl_toolkits.axes_grid.axes_divider.AxesDivider(axes, xref=None, yref=None)

Divider based on the pre-existing axes.

Parameters:

axes : Axes

xref

yref

append_axes(position, size, pad=None, add_to_figure=True, **kwargs)

create an axes at the given position with the same height (or width) of the main axes.

position
[“left”|”right”|”bottom”|”top”]

size and pad should be axes_grid.axes_size compatible.

new_horizontal(size, pad=None, pack_start=False, **kwargs)

Add a new axes on the right (or left) side of the main axes.

Parameters:

size : axes_size or float or string

A width of the axes. If float or string is given, from_any function is used to create the size, with ref_size set to AxesX instance of the current axes.

pad : axes_size or float or string

Pad between the axes. It takes same argument as size.

pack_start : bool

If False, the new axes is appended at the end of the list, i.e., it became the right-most axes. If True, it is inserted at the start of the list, and becomes the left-most axes.

kwargs

All extra keywords arguments are passed to the created axes. If axes_class is given, the new axes will be created as an instance of the given class. Otherwise, the same class of the main axes will be used.

new_vertical(size, pad=None, pack_start=False, **kwargs)

Add a new axes on the top (or bottom) side of the main axes.

Parameters:

size : axes_size or float or string

A height of the axes. If float or string is given, from_any function is used to create the size, with ref_size set to AxesX instance of the current axes.

pad : axes_size or float or string

Pad between the axes. It takes same argument as size.

pack_start : bool

If False, the new axes is appended at the end of the list, i.e., it became the right-most axes. If True, it is inserted at the start of the list, and becomes the left-most axes.

kwargs

All extra keywords arguments are passed to the created axes. If axes_class is given, the new axes will be created as an instance of the given class. Otherwise, the same class of the main axes will be used.