Merge pull request #25959 from meeseeksmachine/auto-backport-of-pr-25955-on-v3.7.x

timhoffm · web-flow · commit 48891e5910f2 · 2023-05-23T19:52:55.000+02:00
Backport PR #25955 on branch v3.7.x (Update performance note of hist() to mention stairs().)
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -6669,12 +6669,15 @@ def hist(self, x, bins=None, range=None, density=False, weights=None,
         --------
         hist2d : 2D histogram with rectangular bins
         hexbin : 2D histogram with hexagonal bins
+        stairs : Plot a pre-computed histogram
+        bar : Plot a pre-computed histogram
 
         Notes
         -----
-        For large numbers of bins (>1000), plotting can be significantly faster
-        if *histtype* is set to 'step' or 'stepfilled' rather than 'bar' or
-        'barstacked'.
+        For large numbers of bins (>1000), plotting can be significantly
+        accelerated by using `~.Axes.stairs` to plot a pre-computed histogram
+        (``plt.stairs(*np.histogram(data))``), or by setting *histtype* to
+        'step' or 'stepfilled' rather than 'bar' or 'barstacked'.
         """
         # Avoid shadowing the builtin.
         bin_range = range
