From 91dd808ed6a8b514b292e915509c72e7fc07f47d Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Mon, 17 Oct 2022 01:29:56 +0200
Subject: [PATCH] DOC: Explain gridsize in hexbin()
Closes #21349.
---
lib/matplotlib/axes/_axes.py | 26 +++++++++++++++++++++++++-
1 file changed, 25 insertions(+), 1 deletion(-)
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