Documentation Link

https://matplotlib.org/devdocs/api/_as_gen/matplotlib.axes.Axes.margins.html

Problem

From #20942 (comment):

Axes.margins is not quite clear.

Suggested improvement

Actions:

• Synchronize with set_xmargin / set_ymargin
• Bring in context (link?) with view limits (set_xlim, set_ylim)
• Note that the view limits are only updated in the next autoscale_view. Margins only stall the view. Not true anymore, accessing lims unstalls them.
• Maybe add explanation docs on how limits are handled.
  Include / consolidate the following and cross-link from the API docs:
  • https://matplotlib.org/stable/gallery/subplots_axes_and_figures/axes_margins.html
  • https://matplotlib.org/stable/users/explain/axes/autoscale.html

Matplotlib Version

3.4.x

Matplotlib documentation version

3.4.x