matplotlib.pyplot.hexbin

matplotlib.pyplot。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 , margins =False , * , data=None ,**kwargs )

制作点x和y的二维六边形分箱图。

如果C为None，则六边形的值由六边形中的点数确定。否则，C指定坐标 (x[i], y[i]) 处的值。对于每个六边形，使用reduce_C_function减少这些值。

参数：

x, y类数组

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

类C数组，可选

如果给定，这些值将在 bin 中累积。否则，每个点的值为 1。必须与x 和y具有相同的长度。

gridsize int 或 (int, int)，默认值：100

如果是单个 int，则x方向上的六边形数。选择y方向上的六边形数量，以使六边形近似规则。

或者，如果是元组 ( nx , ny )，则为x方向和y方向的六边形数。

bins 'log' 或 int 或序列，默认值：无

六边形值的离散化。

• 如果None，则不应用分箱；每个六边形的颜色直接对应其计数值。

• 如果为“log”，则对颜色图使用对数刻度。在内部，\(log_{10}(i+1)\)用于确定六边形颜色。这相当于norm=LogNorm().

• 如果是整数，则除以指定数量的 bin 中的计数，并相应地为六边形着色。

• 如果是一系列值，则要使用的 bin 的下限的值。

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

在水平轴上使用线性或 log10 刻度。

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

在垂直轴上使用线性或 log10 刻度。

mincnt int > 0，默认值：无

如果不是None ，则仅显示单元格 中点数超过mincnt的单元格。

边际布尔值，默认值：False

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

范围4 元组浮点数，默认值：无

bin 的限制（xmin、xmax、ymin、ymax）。默认基于 gridsize、x、y、xscale和yscale分配限制。

如果xscale或yscale设置为“log”，则限制应为 10 的幂的指数。例如，“线性”比例中的 x 限制为 1 和 50，'log 中的 y 限制为 10 和 1000 ' 比例，输入 (1, 50, 1, 3)。

返回：

PolyCollection

APolyCollection定义六边形箱。

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

• PolyCollection.get_array包含 M 个六边形的值。

如果margins是True，水平条和垂直条（都是 PolyCollections）将作为属性hbar和vbar附加到返回集合。

其他参数：

cmap str 或Colormap，默认值：（rcParams["image.cmap"]默认值'viridis'：）

用于将标量数据映射到颜色的颜色图实例或注册的颜色图名称。

范数str 或Normalize, 可选

在使用cmap映射到颜色之前，用于将标量数据缩放到 [0, 1] 范围的标准化方法。默认情况下，使用线性缩放，将最小值映射到 0，将最大值映射到 1。

如果给出，这可以是以下之一：

• 一个实例Normalize或其子类之一（请参阅Colormap Normalization）。

• 刻度名称，即“linear”、“log”、“symlog”、“logit”等之一。有关可用刻度的列表，请调用matplotlib.scale.get_scale_names()。Normalize在这种情况下，会动态生成并实例化一个合适的子类。

vmin, vmax浮点数，可选

当使用标量数据且没有明确的norm时，vmin和vmax定义颜色图覆盖的数据范围。默认情况下，颜色图覆盖所提供数据的完整值范围。给定范数实例时使用vmin / vmax是错误的 （但可以接受将范数 名称与vmin / vmax一起使用）。str

alpha介于 0 和 1 之间的浮点数，可选

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

线宽浮动，默认值：无

如果None，默认为 1.0。

edgecolors {'face', 'none', None } 或颜色，默认：'face'

六边形边缘的颜色。可能的值为：

• 'face'：以与填充颜色相同的颜色绘制边缘。

• 'none'：不绘制边。这有时会导致六边形之间出现难看的未绘制像素。

• 无：以默认颜色绘制轮廓。

• 明确的颜色。

reduce_C_function可调用，默认：numpy.mean

在 bin 内聚合C的函数。如果 没有给出C ，则忽略它。这必须有签名：

def reduce_C_function(C: array) -> float

常用的功能有：

• numpy.mean: 平均分

• numpy.sum: 点值的积分

• numpy.amax：取自最大点的值

数据可索引对象，可选

如果给定，以下参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）：

x , y , C

**kwargsPolyCollection属性

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

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	类数组或标量或无
animated	布尔
antialiased或 aa 或抗锯齿	布尔或布尔列表
array	类数组或无
capstyle	CapStyle或 {'butt', 'projecting', 'round'}
clim	（vmin：浮动，vmax：浮动）
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap或 str 或 无
color	rgba 元组的颜色或列表
edgecolor或 ec 或 edgecolors	颜色或颜色列表或“脸”
facecolor或 facecolors 或 fc	颜色或颜色列表
figure	Figure
gid	字符串
hatch	{'/'、'\'、'|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}
in_layout	布尔
joinstyle	JoinStyle或 {'miter', 'round', 'bevel'}
label	目的
linestyle或破折号或线条样式或 ls	str 或元组或其列表
linewidth或线宽或lw	浮动或浮动列表
mouseover	布尔
norm	Normalize或 str 或 无
offset_transform或 transOffset	未知
offsets	(N, 2) 或 (2,) 类数组
path_effects	AbstractPathEffect
paths	类似数组的列表
picker	None 或 bool 或 float 或可调用
pickradius	未知
rasterized	布尔
sizes	ndarray 或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	字符串
urls	str 或 None 的列表
verts	类似数组的列表
verts_and_codes	未知
visible	布尔
zorder	漂浮

也可以看看

hist2d

二维直方图矩形箱