matplotlib.axes.Axes.hexbin

Axes.hexbin(x, y, C=None, gridsize=100, bins=None, xscale='linear', yscale='linear', extent=None, cmap=None, norm=None, vmin=None, vmax=None, alpha=None, linewidths=None, edgecolors='face', reduce_C_function=<function mean>, mincnt=None, marginals=False, *, data=None, **kwargs)

制作一个二维六边形分块图 x ， y .

如果 C 是 None ，六边形的值由六边形中的点数决定。否则， C 指定坐标（x）处的值 [i] Y [i] ). 对于每个六边形，使用 reduce_C_function .

参数:

x, y类数组

数据位置。 x 和 y 长度必须相同。

C类似数组，可选

如果给定，这些值将在存储箱中累积。否则，每个点的值都为1。长度必须与 x 和 y .

gridsizeint或（int，int），默认值：100

如果是单个整数，则 x -方向。中的六边形数 y -选择方向使六边形近似规则。

或者，如果一个元组( nx ， ny )，中的六边形数 x -方向和 y -方向。

bins'log'或int或sequence，默认值：None

六边形值的离散化。

• 如果 None ，不应用binning；每个六边形的颜色直接对应其计数值。
• 如果是“对数”，请使用对数刻度作为颜色映射。内部， \(log_{{10}}(i+1)\) 用于确定六边形颜色。这相当于 norm=LogNorm() .
• 如果是整数，则将计数除以指定的箱数，并相应地为六边形着色。
• 如果是一个值序列，则为要使用的箱的下限值。

xscale{'linear'，'log'}，默认值：'linear'

在水平轴上使用线性或对数10刻度。

yscale{'linear'，'log'}，默认值：'linear'

在垂直轴上使用线性或对数10刻度。

明尼特 ：int>0，默认值： Noneint>0，默认值：

如果没有 None ，仅显示超过 明尼特 单元格中的点数。

边际值 ：bool，默认值： 假布尔，默认值：

如果边缘是 True ，将边缘密度绘制为沿x轴底部和y轴左侧的彩色映射矩形。

程度 ：float，默认值： None浮动，默认值：

垃圾桶的限制。默认值根据 网格大小 ， x ， y ， X标度 和 大比例尺 .

如果 X标度 或 大比例尺 设置为“log”，限值应为10次方的指数。例如，对于“线性”比例中的x极限1和50，以及“对数”比例中的y极限10和1000，输入（1、50、1、3）。

标尺的顺序是（左、右、下、上）。

返回:

PolyCollection

A PolyCollection 定义六角形料仓。

• PolyCollection.get_offsets 包含一个包含M个六边形中心的x，y位置的Mx2数组。
• PolyCollection.get_array 包含M六边形的值。

如果 边际值 是 True ，水平条和垂直条（两个多集合）将作为属性附加到返回集合。 hbar 和 vbar .

其他参数:

cmap : str or Colormap, default: rcParams["image.cmap"] (default: 'viridis')str或

用于将bin值映射到颜色的Colormap实例或注册的Colormap名称。

norm ： Normalize 可选正常化，可选

Normalize实例将bin值缩放到规范的colormap范围 [0, 1] 用于映射到颜色。默认情况下，使用线性缩放将数据范围映射到颜色条范围。

VMN，Vmax浮点，默认值：无

颜色条范围。如果 None ，自动选择合适的最小/最大值 Normalize 实例（在默认线性缩放的情况下，默认为各个箱子的最小/最大值）。不推荐使用 vmin / vmax 什么时候？ norm 给出。

alpha在0和1之间浮动，可选

alpha混合值，介于0（透明）和1（不透明）之间。

线宽度 ：float，默认值： None浮动，默认值：

如果 None ，默认为1.0。

绿色染料 ：'face'、'none'， None }或颜色，默认值：“face”{'face'、'none'，

六边形边的颜色。可能的值包括：

• “面”：用与填充颜色相同的颜色绘制边。
• “无”：不绘制边。这有时会导致六边形之间出现难看的未着色像素。
• None ：以默认颜色绘制轮廓。
• 明显的颜色。

reduce_C_function ：可调用，默认值： numpy.mean可调用，默认值：

聚合函数 C 在垃圾箱里。如果 C 没有给出。必须有签名：

def reduce_C_function(C: array) -> float

常用功能有：

• numpy.mean ：点的平均值
• numpy.sum ：点值的积分
• numpy.max ：取最大点的值

**kwargs ： PolyCollection 性质多集合属性

所有其他关键字参数都传递给 PolyCollection ：

财产	描述
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动或无
animated	布尔
antialiased 或者aa或者抗锯齿药	布尔或布尔列表
array	恩达雷
capstyle	“对接”、“圆形”、“突出”
clim	（V最小：浮动，V最大：浮动）
clip_box	Bbox
clip_on	布尔
clip_path	面片或（路径、变换）或无
cmap	Colormap 或str或None
color	rgba元组的颜色或列表
contains	未知的
edgecolor 或ec或edgecolors	颜色或颜色列表或“面”
facecolor 或者facecolors或者fc	颜色或颜色列表
figure	Figure
gid	STR
hatch	'/'、''、''、'-'、'+'、'X'、'O'、'O'、'、'、'*'
in_layout	布尔
joinstyle	'miter'、'round'、'bevel'
label	对象
linestyle 或虚线或线型或ls	str或tuple或其列表
linewidth 或线宽或lw	浮动或浮动列表
norm	Normalize 或无
offset_position	未知的
offsets	类似于（N，2）或（2，）
path_effects	AbstractPathEffect
picker	无、布尔或可呼叫
pickradius	未知的
rasterized	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	STR
urls	str或None列表
visible	布尔
zorder	浮动

笔记

注解

除了上述参数外，此函数还可以 data 关键字参数。如果这样的话 data 参数，下列参数也可以是字符串 s ，解释为 data[s] （除非引起例外）： x ， y .

作为传递的对象 data 必须支持项目访问 (data[s] ）和会员资格测试 (s in data ）

使用实例 matplotlib.axes.Axes.hexbin

Hexbin演示