DOC: Improve module docs of matplotlib.scale

timhoffm · timhoffm · commit ee66f09902e1 · 2024-12-20T09:06:08.000+01:00
diff --git a/lib/matplotlib/scale.py b/lib/matplotlib/scale.py
@@ -1,6 +1,22 @@
 """
 Scales define the distribution of data values on an axis, e.g. a log scaling.
-They are defined as subclasses of `ScaleBase`.
+
+Scales are subclasses `ScaleBase`, their mapping is implemented through `.Transform`
+subclasses that are separable and have an inverse.
+
+The following scales are builtin:
+
+============= ===================== ================================ ===============================
+Name          Class                 Transform                        Inverted transform
+============= ===================== ================================ ===============================
+"asinh"       `AsinhScale`          `AsinhTransform`                 `InvertedAsinhTransform`
+"function"    `FuncScale`           `FuncTransform`                  `FuncTransform`
+"functionlog" `FuncScaleLog`        `FuncTransform` + `LogTransform`
+"linear"      `LinearScale`         `IdentityTransform`              `IdentityTransform`
+"log"         `LogScale`            `LogTransform`                   `InvertedLogTransform`
+"logit"       `LogitScale`          `LogitTransform`                 `LogisticTransform`
+"symlog"      `SymmetricalLogScale` `SymmetricalLogTransform`        `InvertedSymmetricLogTransform`
+============= ===================== ================================ ===============================
 
 See also `.axes.Axes.set_xscale` and the scales examples in the documentation.
 
@@ -412,6 +428,8 @@ class SymmetricalLogScale(ScaleBase):
     *linthresh* allows the user to specify the size of this range
     (-*linthresh*, *linthresh*).
 
+    See :doc:`/gallery/scales/symlog_demo` for a detailed description.
+
     Parameters
     ----------
     base : float, default: 10
