matplotlib.axes.Axes() ⚬ Entries

↩ 🔵 🔵 🔵

---

Primary

၊၊||၊|။

matplotlib.axes.Axes() ⚬｜Documentation｜1st｜20251021002023-00-⌔

matplotlib.axes.Axes — Matplotlib 3.10.8 documentation#matplotlib.axes.Axes

class matplotlib.axes.Axes(fig, ﹡args, facecolor=None, frameon=True, sharex=None, sharey=None, label='', xscale=None, yscale=None, box_aspect=None, forward_navigation_events='auto', ﹡﹡kwargs)

An Axes object encapsulates all the elements of an individual (sub-)plot in a figure.

It contains most of the (sub-)plot elements: Axis, Tick, Line2D, Text, Polygon, etc., and sets the coordinate system.

Like all visible elements in a figure, Axes is an Artist subclass.

The Axes instance supports callbacks through a callbacks attribute which is a CallbackRegistry instance. The events you can connect to are ‘xlim_changed’ and ‘ylim_changed’ and the callback will be called with func(ax) where ax is the Axes instance.

Note: As a user, you do not instantiate Axes directly, but use Axes creation methods instead; e.g. from pyplot or Figure: subplots, subplot_mosaic or Figure.add_axes.

Build an Axes in a figure.

Parameters:

fig: Figure

The Axes is built in the Figure fig.

﹡args

﹡args can be a single (left, bottom, width, height) rectangle or a single Bbox. This specifies the rectangle (in figure coordinates) where the Axes is positioned.

﹡args can also consist of three numbers or a single three-digit number; in the latter case, the digits are considered as independent numbers. The numbers are interpreted as (nrows, ncols, index): (nrows, ncols) specifies the size of an array of subplots, and index is the 1-based index of the subplot being created. Finally, ﹡args can also directly be a SubplotSpec instance.

sharex, sharey: Axes, optional

The x- or y- axis is shared with the x- or y-axis in the input Axes. Note that it is not possible to unshare axes.

frameon: bool, default: True

Whether the Axes frame is visible.

box_aspect: float, optional

Set a fixed aspect for the Axes box, i.e. the ratio of height to width. See set_box_aspect for details.

forward_navigation_events: bool or “auto”, default: “auto”

Control whether pan/zoom events are passed through to Axes below this one. “auto” is True for axes with an invisible patch and False otherwise.

﹡﹡kwargs

Other optional keyword arguments:

📊 ➺

Returns:

Axes

The new Axes object.

Printed 2026-06-28.

(echo:: @ ᯤ ᯤ)

Link to original

Secondary

• • •

---