matplotlib.axes.Axes.twiny#

Axes.twiny(axes_class=None, *, delta_zorder=0.0, **kwargs)[source]#

Create a twin Axes sharing the yaxis.

Create a new Axes with an invisible y-axis and an independent x-axis positioned opposite to the original one (i.e. at top). The y-axis autoscale setting will be inherited from the original Axes. To ensure that the tick marks of both x-axes align, see LinearLocator.

Parameters:

axes_classsubclass type of Axes, optional

The axes.Axes subclass that is instantiated. This parameter is incompatible with projection and polar. See axisartist for examples.

By default, Axes is used.

Added in version 3.11.

delta_zorderfloat, default: 0

A zorder offset for the twin Axes, relative to the original Axes. The twin's zorder is set to self.get_zorder() + delta_zorder. By default (delta_zorder is 0), the twin has the same zorder as the original Axes.

kwargsdict

The keyword arguments passed to Figure.add_subplot or Figure.add_axes.

Added in version 3.11.

Returns:

Axes

The newly created Axes instance

Notes

For those who are 'picking' artists while using twiny, pick events are only called for the artists in the top-most Axes.

Examples using matplotlib.axes.Axes.twiny#

[]

Plots with different scales

Plots with different scales

[]

Twin Axes with delta_zorder

Twin Axes with delta_zorder