diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 2412f815cd42..42891ce558c5 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -4715,7 +4715,31 @@ def hexbin(self, x, y, C=None, gridsize=100, bins=None,
the hexagons are approximately regular.
Alternatively, if a tuple (*nx*, *ny*), the number of hexagons
- in the *x*-direction and the *y*-direction.
+ in the *x*-direction and the *y*-direction. In the
+ *y*-direction, counting is done along vertically aligned
+ hexagons, not along the zig-zag chains of hexagons; see the
+ following illustration.
+
+ .. plot::
+
+ import numpy
+ import matplotlib.pyplot as plt
+
+ np.random.seed(19680801)
+ n= 300
+ x = np.random.standard_normal(n)
+ y = np.random.standard_normal(n)
+
+ fig, ax = plt.subplots(figsize=(4, 4))
+ h = ax.hexbin(x, y, gridsize=(5, 3))
+ hx, hy = h.get_offsets().T
+ ax.plot(hx[24::3], hy[24::3], 'ro-')
+ ax.plot(hx[-3:], hy[-3:], 'ro-')
+ ax.set_title('gridsize=(5, 3)')
+ ax.axis('off')
+
+ To get approximately regular hexagons, choose
+ :math:`n_x = \\sqrt{3}\\,n_y`.
bins : 'log' or int or sequence, default: None
Discretization of the hexagon values.
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy