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


Travis-CI:

This Page

matplotlib.axes.Axes.twiny

Axes.twiny()

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.