Class _AxesBase

lib/matplotlib/axes/_base.py:558–5056

@_api.define_aliases({"facecolor": ["fc"]})
class _AxesBase(martist.Artist):
    name = "rectilinear"

    # axis names are the prefixes for the attributes that contain the
    # respective axis; e.g. 'x' <-> self.xaxis, containing an XAxis.
    # Note that PolarAxes uses these attributes as well, so that we have
    # 'x' <-> self.xaxis, containing a ThetaAxis. In particular we do not
    # have 'theta' in _axis_names.
    # In practice, this is ('x', 'y') for all 2D Axes and ('x', 'y', 'z')
    # for Axes3D.
    _axis_names = ("x", "y")
    _shared_axes = {name: cbook.Grouper() for name in _axis_names}
    _twinned_axes = cbook.Grouper()

    _subclass_uses_cla = False

    dataLim: mtransforms.Bbox
    """The bounding `.Bbox` enclosing all data displayed in the Axes."""

    spines: mspines.Spines
    """
    The `.Spines` container for the Axes&#x27; spines, i.e. the lines denoting the
    data area boundaries.
    """

    xaxis: maxis.XAxis
    """
    The `.XAxis` instance.

    Common axis-related configuration can be achieved through high-level wrapper
    methods on Axes; e.g. `ax.set_xticks <.Axes.set_xticks>` is a shortcut for
    `ax.xaxis.set_ticks <.Axis.set_ticks>`. The *xaxis* attribute gives direct
    direct access to the underlying `~.axis.Axis` if you need more control.

    See also

    - :ref:`Axis wrapper methods on Axes <axes-api-axis>`
    - :doc:`Axis API </api/axis_api>`
    """

    yaxis: maxis.YAxis
    """
    The `.YAxis` instance.

    Common axis-related configuration can be achieved through high-level wrapper
    methods on Axes; e.g. `ax.set_yticks <.Axes.set_yticks>` is a shortcut for
    `ax.yaxis.set_ticks <.Axis.set_ticks>`. The *yaxis* attribute gives direct
    access to the underlying `~.axis.Axis` if you need more control.

    See also

    - :ref:`Axis wrapper methods on Axes <axes-api-axis>`
    - :doc:`Axis API </api/axis_api>`
    """

    def __str__(self):
        return "{0}({1[0]:g},{1[1]:g};{1[2]:g}x{1[3]:g})".format(
            type(self).__name__, self._position.bounds)