seaborn.displot#
- seaborn.displot(data=None, *, x=None, y=None, hue=None, row=None, col=None, weights=None, kind='hist', rug=False, rug_kws=None, log_scale=None, legend=True, palette=None, hue_order=None, hue_norm=None, color=None, col_wrap=None, row_order=None, col_order=None, height=5, aspect=1, facet_kws=None, **kwargs)[源代码]#
用于在 FacetGrid 上绘制分布图的图层级接口。
此函数提供了几种可视化单变量或双变量数据分布的方法，包括由语义映射和跨多个子图的分面定义的数据子集。
kind参数选择要使用的方法：histplot`（使用 ``kind="hist"`()；默认）kdeplot()(使用kind="kde")ecdfplot`（使用 ``kind="ecdf"`()；仅支持单变量）
此外，可以向任何类型的图表添加
rugplot()以显示单个观测值。额外的关键字参数会传递给底层函数，因此您应该参考每个函数的文档，以了解使用此接口制作图形的完整选项集。
有关每种方法的相对优缺点更深入的讨论，请参阅 分布图教程 。图级函数和轴级函数之间的区别在 用户指南 中有进一步解释。
- 参数:
- 数据 :
pandas.DataFrame,numpy.ndarray, 映射, 或序列pandas.DataFrame, numpy.ndarray, 映射, 或序列 输入数据结构。可以是可分配给命名变量的长格式向量集合，也可以是将被内部重塑的宽格式数据集。
- x, y :
data中的向量或键向量或键 指定x轴和y轴位置的变量。
- hue :
data中的向量或键向量或键 语义变量，用于映射以确定绘图元素的颜色。
- row, col :
data中的向量或键向量或键 定义在不同方面绘制子集的变量。
- 权重 : 向量或
数据中的键向量或键 用于计算分布函数的观测权重。
- 种类{“hist”, “kde”, “ecdf”}
数据可视化的方法。选择底层绘图函数并确定一组额外的有效参数。
- 地毯布尔
如果为 True，则显示每个观测值的边际刻度（如在
rugplot()中）。- rug_kwsdict
控制地毯图外观的参数。
- log_scale布尔值或数字，或布尔值或数字对
将轴比例设置为对数。单个值设置图中任何数值轴的数据轴。一对值分别独立设置每个轴。数值被解释为所需的对数底数（默认10）。当为
None或False时，seaborn 将遵循现有的 Axes 比例。- 图例布尔
如果为 False，则抑制语义变量的图例。
- palette : 字符串, 列表, 字典, 或
matplotlib.colors.Colormap字符串, 列表, 字典, 或 选择用于映射
hue语义的颜色时的方法。字符串值传递给color_palette()。列表或字典值意味着分类映射，而颜色映射对象意味着数值映射。- hue_order字符串向量
指定
hue语义的分类级别的处理和绘图顺序。- hue_norm : 元组或
matplotlib.colors.Normalize元组或 一对设置数据单位归一化范围的值，或一个将数据单位映射到 [0, 1] 区间的对象。使用时意味着数值映射。
- 颜色 :
matplotlib 颜色matplotlib 颜色 当不使用色调映射时，指定单一颜色。否则，绘图将尝试连接到 matplotlib 属性循环。
- col_wrap整数
在此宽度处“包裹”列变量，以便列分面跨越多行。与
row分面不兼容。- {row,col}_order字符串向量
指定
row和/或col变量的级别在子图网格中出现的顺序。- 高度标量
每个分面的高度（以英寸为单位）。另见：
aspect。- 方面标量
每个面的宽高比，使得
aspect * height给出每个面在英寸中的宽度。- facet_kwsdict
传递给
FacetGrid的附加参数。- kwargs
其他关键字参数在相关轴级函数中有文档说明：
histplot`（使用 ``kind="hist"`()）kdeplot()(使用kind="kde")ecdfplot`（使用 ``kind="ecdf"`()）
- 数据 :
- 返回:
FacetGrid一个管理一个或多个子图的对象，这些子图对应于条件数据子集，并具有方便的方法来批量设置轴属性。
参见
示例
有关每种绘图类型可用选项的详细信息，请参阅 API 文档中的轴级函数。