Merge pull request #16338 from anntzer/symlogdoc

QuLogic · web-flow · commit 32d3306e78e9 · 2020-03-09T20:37:19.000-04:00
Document SymmetricalLogLocator parameters.
diff --git a/lib/matplotlib/ticker.py b/lib/matplotlib/ticker.py
@@ -2439,11 +2439,28 @@ def nonsingular(self, vmin, vmax):
 
 class SymmetricalLogLocator(Locator):
     """
-    Determine the tick locations for symmetric log axes
+    Determine the tick locations for symmetric log axes.
     """
 
     def __init__(self, transform=None, subs=None, linthresh=None, base=None):
-        """Place ticks on the locations ``base**i*subs[j]``."""
+        """
+        Parameters
+        ----------
+        transform : `~.scale.SymmetricalLogTransform`, optional
+            If set, defines the *base* and *linthresh* of the symlog transform.
+        base, linthresh : float, optional
+            The *base* and *linthresh* of the symlog transform, as documented
+            for `.SymmetricalLogScale`.  These parameters are only used if
+            *transform* is not set.
+        subs : sequence of float, default: [1]
+            The multiples of integer powers of the base where ticks are placed,
+            i.e., ticks are placed at
+            ``[sub * base**i for i in ... for sub in subs]``.
+
+        Notes
+        -----
+        Either *transform*, or both *base* and *linthresh*, must be given.
+        """
         if transform is not None:
             self._base = transform.base
             self._linthresh = transform.linthresh
