You are reading an old version of the documentation (v3.1.3). For the latest version see https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.twiny.html
Version 3.1.3
matplotlib
Fork me on GitHub

Table of Contents

matplotlib.axes.Axes.twiny

Axes.twiny(self)

Create a twin Axes sharing the yaxis

Create a new Axes instance 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

Returns:
ax_twin : 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