pandas.DataFrame.hist

DataFrame.hist(column=None, by=None, grid=True, xlabelsize=None, xrot=None, ylabelsize=None, yrot=None, ax=None, sharex=False, sharey=False, figsize=None, layout=None, bins=10, backend=None, legend=False, **kwargs)

绘制 DataFrame 列的直方图。

histogram 是数据分布的表示。此函数调用 matplotlib.pyplot.hist() ，在 DataFrame 中的每个系列上，结果是每列一个直方图。

参数:

数据DataFrame

持有数据的 pandas 对象。

列str 或序列，可选

如果传递，将用于将数据限制为列的子集。

通过对象，可选

如果传递了，则用于为单独的组形成直方图。

网格布尔值, 默认为 True

是否显示轴网格线。

xlabelsizeint, 默认为 None

如果指定，则更改 x 轴标签的大小。

xrot浮点数，默认无

x 轴标签的旋转。例如，值为 90 时，x 标签会顺时针旋转 90 度显示。

ylabelsizeint, 默认为 None

如果指定，则更改 y 轴标签的大小。

yrot浮点数，默认无

y轴标签的旋转。例如，值为90表示将y轴标签顺时针旋转90度。

axMatplotlib 轴对象，默认为 None

要绘制直方图的轴。

sharex布尔值，如果 ax 为 None 则默认为 True，否则为 False

如果 subplots=True，共享 x 轴并将某些 x 轴标签设置为不可见；如果 ax 为 None，则默认为 True，否则如果传递了 ax，则默认为 False。请注意，传递 ax 和 sharex=True 会改变图中所有子图的 x 轴标签。

sharey布尔值, 默认为 False

如果 subplots=True，共享 y 轴并将一些 y 轴标签设置为不可见。

figsizetuple, 可选

要创建的图形的大小（英寸）。默认使用 matplotlib.rcParams 中的值。

布局tuple, 可选

直方图布局的 (行, 列) 元组。

binsint 或序列, 默认 10

要使用的直方图箱数。如果给定一个整数，则计算并返回 bins + 1 个箱边缘。如果 bins 是一个序列，则给出箱边缘，包括第一个箱的左边缘和最后一个箱的右边缘。在这种情况下，bins 保持不变。

后端str, 默认为 None

要使用的后端，而不是选项 plotting.backend 中指定的后端。例如，’matplotlib’。或者，要为整个会话指定 plotting.backend，请设置 pd.options.plotting.backend。

图例布尔值, 默认为 False

是否显示图例。

**kwargs

所有其他要传递给 matplotlib.pyplot.hist() 的绘图关键字参数。

返回:

matplotlib.Axes 或 numpy.ndarray 的它们

返回一个 AxesSubplot 对象或一个 AxesSubplot 对象的 numpy 数组。

参见

matplotlib.pyplot.hist

使用 matplotlib 绘制直方图。

例子

这个例子基于一些动物的长度和宽度绘制了一个直方图，显示在三个箱子中

>>> data = {"length": [1.5, 0.5, 1.2, 0.9, 3], "width": [0.7, 0.2, 0.15, 0.2, 1.1]}
>>> index = ["pig", "rabbit", "duck", "chicken", "horse"]
>>> df = pd.DataFrame(data, index=index)
>>> hist = df.hist(bins=3)