You are reading an old version of the documentation (v2.0.1). For the latest version see https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.twiny.html
matplotlib

Travis-CI:

This Page

matplotlib.axes.Axes.twiny

Axes.twiny()

Create a twin Axes sharing the yaxis

create a twin of Axes for generating a plot with a shared y-axis but independent x axis. The x-axis of self will have ticks on bottom and the returned axes will have ticks on the top.

Note

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