You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Version 2.1.1.post1080+g0db0992
matplotlib
Fork me on GitHub

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.