seaborn.heatmap

seaborn.heatmap(data, *, vmin=None, vmax=None, cmap=None, center=None, robust=False, annot=None, fmt='.2g', annot_kws=None, linewidths=0, linecolor='white', cbar=True, cbar_kws=None, cbar_ax=None, square=False, xticklabels='auto', yticklabels='auto', mask=None, ax=None, **kwargs)

将矩形数据绘制为颜色编码的矩阵。

这是一个轴级别的函数，如果没有为 ax 参数提供任何内容，它将把热图绘制到当前活动的轴上。这部分轴空间将被占用并用于绘制色图，除非 cbar 为 False 或为 cbar_ax 提供了单独的轴。

参数:

数据矩形数据集

可以强制转换为 ndarray 的 2D 数据集。如果提供了 Pandas DataFrame，将使用索引/列信息来标记列和行。

vmin, vmax浮动，可选

用于锚定颜色映射的值，否则它们将从数据和其他关键字参数中推断出来。

cmapmatplotlib 色图名称或对象，或颜色列表，可选

数据值到颜色空间的映射。如果没有提供，默认值将取决于是否设置了 center。

中心float, 可选

在绘制发散数据时，用于中心化色图的值。使用此参数将更改默认的 cmap ，如果未指定的话。

稳健bool, 可选

如果为 True 且 vmin 或 vmax 缺失，则使用稳健的分位数来计算色图范围，而不是使用极值。

annot布尔值或矩形数据集，可选

如果为 True，则在每个单元格中写入数据值。如果是一个与 data 形状相同的类数组对象，则使用此对象来注释热图，而不是数据。请注意，DataFrame 将根据位置匹配，而不是索引。

fmtstr, 可选

添加注释时使用的字符串格式化代码。

annot_kws键值映射的字典，可选

当 annot 为 True 时，matplotlib.axes.Axes.text() 的关键字参数。

线宽float, 可选

分割每个单元格的线条宽度。

linecolor颜色, 可选

分割每个单元格的线条颜色。

cbarbool, 可选

是否绘制颜色条。

cbar_kws键值映射的字典，可选

用于 matplotlib.figure.Figure.colorbar() 的关键字参数。

cbar_axmatplotlib 轴, 可选

要在其中绘制颜色条的轴，否则从主轴中获取空间。

平方bool, 可选

如果为真，将 Axes 的纵横比设置为 “equal”，以便每个单元格都呈正方形。

xticklabels, yticklabels“auto”, bool, list-like, 或 int, 可选

如果为 True，绘制数据框的列名。如果为 False，则不绘制列名。如果为类列表，则将这些替代标签作为 xticklabels 绘制。如果为整数，则使用列名，但仅绘制每隔 n 个标签。如果为 “auto”，则尝试密集地绘制不重叠的标签。

掩码布尔数组或DataFrame，可选

如果传递了 mask ，数据将不会在 mask 为 True 的单元格中显示。具有缺失值的单元格会自动被屏蔽。

axmatplotlib 轴, 可选

要在其中绘制图形的轴，否则使用当前活动的轴。

kwargs其他关键字参数

所有其他关键字参数都传递给 matplotlib.axes.Axes.pcolormesh()。

返回:

axmatplotlib Axes

带有热图的 Axes 对象。

参见

clustermap

使用层次聚类绘制矩阵以排列行和列。

示例