matplotlib.axes.Axes.set_aspect#

Axes.set_aspect(aspect, adjustable=None, anchor=None, share=False)[source]#

Set the aspect ratio of the axes scaling, i.e. y/x-scale.

Parameters:
aspect{'auto', 'equal'} or float

Possible values:

  • 'auto': fill the position rectangle with data.

  • 'equal': same as aspect=1, i.e. same scaling for x and y.

  • float: The displayed size of 1 unit in y-data coordinates will be aspect times the displayed size of 1 unit in x-data coordinates; e.g. for aspect=2 a square in data coordinates will be rendered with a height of twice its width.

adjustableNone or {'box', 'datalim'}, optional

If not None, this defines which parameter will be adjusted to meet the required aspect. See set_adjustable for further details.

anchorNone or str or (float, float), optional

If not None, this defines where the Axes will be drawn if there is extra space due to aspect constraints. The most common way to specify the anchor are abbreviations of cardinal directions:

value

description

'C'

centered

'SW'

lower left corner

'S'

middle of bottom edge

'SE'

lower right corner

etc.

See set_anchor for further details.

sharebool, default: False

If True, apply the settings to all shared Axes.

See also

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.

Examples using matplotlib.axes.Axes.set_aspect#

Tricontour Demo

Tricontour Demo

Tricontour Smooth Delaunay

Tricontour Smooth Delaunay

Tricontour Smooth User

Tricontour Smooth User

Trigradient Demo

Trigradient Demo

Tripcolor Demo

Tripcolor Demo

Triplot Demo

Triplot Demo

Axes box aspect

Axes box aspect

Controlling view limits using margins and sticky_edges

Controlling view limits using margins and sticky_edges

Multiline

Multiline

Mmh Donuts!!!

Mmh Donuts!!!

Inset locator demo 2

Inset locator demo 2

Scatter Histogram (Locatable Axes)

Scatter Histogram (Locatable Axes)

Simple Anchored Artists

Simple Anchored Artists

Simple Axis Pad

Simple Axis Pad

The double pendulum problem

The double pendulum problem

Multiple axes animation

Multiple axes animation

Anchored Artists

Anchored Artists

Rasterization for vector graphics

Rasterization for vector graphics

3D surface (solid color)

3D surface (solid color)

3D voxel plot of the NumPy logo

3D voxel plot of the NumPy logo

3D voxel / volumetric plot with RGB colors

3D voxel / volumetric plot with RGB colors

Loglog Aspect

Loglog Aspect

Annotate Text Arrow

Annotate Text Arrow

Arranging multiple Axes in a Figure

Arranging multiple Axes in a Figure

Placing colorbars

Placing colorbars

Colormap normalization

Colormap normalization