You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Version 2.1.1.post1080+g0db0992
Fork me on GitHub

This Page



Define which parameter the Axes will change to achieve a given aspect.

Possible values are:

value description
‘box’ change the physical size of the Axes
‘datalim’ change xlim or ylim
‘box-forced’ same as ‘box’, but axes can be shared

‘box’ does not allow axes sharing, as this can cause unintended side effect. For cases when sharing axes is fine, use ‘box-forced’.

See also

for a description of aspect handling.