Starting

jklymak · jklymak · commit 091986154228 · 2018-07-10T10:39:08.000-07:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -639,6 +639,44 @@ def indicate_inset_zoom(self, inset_ax, **kwargs):
 
         return rectpatch, connects
 
+    def secondary_xaxis(self, loc, conversion, *, **kwargs):
+        """
+        Add a second x-axis to this axes.
+
+        For example if we want to have a second scale for the data plotted on
+        the xaxis.
+
+        Parameters
+        ----------
+        loc : string or scalar
+            The position to put the secondary axis.  Strings can be 'top' or
+            'bottom', scalar can be a float indicating the relative position
+            on the axes to put the new axes (0 being the bottom, and 1.0 being
+            the top.)
+
+        conversion : tuple of floats or function
+            conversion between the parent xaxis values and the secondary xaxis
+            values.  If a tuple of floats, the floats are polynomial
+            co-efficients, with the first entry the highest exponent's
+            co-efficient (i.e. [2, 3, 1] is the same as
+            ``xnew = 2 x**2 + 3 * x + 1``).  If a function is specified it
+            should accept a float as input and return a float as the
+            result.
+
+        Other Parameters
+        ----------------
+        **kwargs : `~matplotlib.axes.Axes` properties.
+            Other miscellaneous axes parameters.
+
+        Returns
+        -------
+        ax : `~matplotlib.axes.Axes` (??)
+
+        """
+        secondary_ax = Secondary_Xaxis(self, loc, conversion, **kwargs)
+        self.add_child_axes(secondary_ax)
+
+
     def text(self, x, y, s, fontdict=None, withdash=False, **kwargs):
         """
         Add text to the axes.
