Merge pull request #15375 from EJEP/note_hist_speed

timhoffm · web-flow · commit c178929d9a80 · 2019-11-09T17:38:16.000Z
Add note to hist docstring about speed
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -6603,6 +6603,11 @@ def hist(self, x, bins=None, range=None, density=False, weights=None,
         --------
         hist2d : 2D histograms
 
+        Notes
+        -----
+        For large numbers of bins (>1000), 'step' and 'stepfilled' can be
+        significantly faster than 'bar' and 'barstacked'.
+
         """
         # Avoid shadowing the builtin.
         bin_range = range
