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. Seeset_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 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
#
Controlling view limits using margins and sticky_edges
Scatter Histogram (Locatable Axes)
Rasterization for vector graphics
3D voxel plot of the numpy logo
3D voxel / volumetric plot with rgb colors
Arranging multiple Axes in a Figure