matplotlib.axes.Axes.apply_aspect#

Axes.apply_aspect(position=None)[source]#

Adjust the Axes for a specified data aspect ratio.

Depending on get_adjustable this will modify either the Axes box (position) or the view limits. In the former case, get_anchor will affect the position.

Parameters:

positionNone or .Bbox: If not None, this defines the position of the Axes within the figure as a Bbox. See get_position for further details.

See also

matplotlib.axes.Axes.set_aspect: For a description of aspect ratio handling.
matplotlib.axes.Axes.set_adjustable: Set how the Axes adjusts to achieve the required aspect ratio.
matplotlib.axes.Axes.set_anchor: Set the position in case of extra space.

Notes

This is called automatically when each Axes is drawn. You may need to call it yourself if you need to update the Axes position and/or view limits before the Figure is drawn.