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.Axessubclass that is instantiated. This parameter is incompatible with projection and polar. See axisartist for examples.By default,
Axesis 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_subplotorFigure.add_axes.Added in version 3.11.
- axes_classsubclass type of
- 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.
