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 是数据分布的表示。此函数在 DataFrame 的每一列上调用
matplotlib.pyplot.hist()，从而为每列生成一个直方图。- Parameters:
- dataDataFrame
包含数据的 pandas 对象。
- columnstr 或序列，可选
如果传入，将用于将数据限制为列的子集。
- byobject, optional
如果传入，则用于为单独的组形成直方图。
- gridbool, default True
是否显示坐标轴网格线。
- xlabelsizeint，默认 None
如果指定，将更改 x 轴标签的大小。
- xrotfloat，默认 None
x 轴标签的旋转角度。例如，值为 90 会将 x 轴标签顺时针旋转 90 度。
- ylabelsizeint，默认 None
如果指定，将更改 y 轴标签的大小。
- yrotfloat，默认 None
y 轴标签的旋转角度。例如，值为 90 会将 y 轴标签顺时针旋转 90 度。
- axMatplotlib 坐标轴对象，默认 None
用于绘制直方图的坐标轴。
- sharexbool，如果 ax 为 None，则默认为 True；否则默认为 False
如果 subplots=True，则共享 x 轴并使某些 x 轴标签不可见；如果 ax 为 None，则默认为 True，否则如果传入 ax，则默认为 False。请注意，同时传入 ax 和 sharex=True 将会修改图中所有子图的所有 x 轴标签。
- shareybool，默认 False
如果 subplots=True，则共享 y 轴并使某些 y 轴标签不可见。
- figsize元组，可选
要创建的图形的大小（英寸）。默认使用 matplotlib.rcParams 中的值。
- layout元组，可选
用于直方图布局的 (行, 列) 元组。
- binsint 或序列，默认 10
要使用的直方图 bin 的数量。如果给出整数，则计算并返回 bin + 1 个 bin 边缘。如果 bins 是序列，则给出 bin 边缘，包括第一个 bin 的左边缘和最后一个 bin 的右边缘。在这种情况下，bins 将被原样返回。
- backendstr，默认 None
用于替换选项
plotting.backend中指定的后端。例如，’matplotlib’。或者，要为整个会话指定plotting.backend，请设置pd.options.plotting.backend。- legendbool，默认 False
是否显示图例。
- **kwargs
传递给
matplotlib.pyplot.hist()的所有其他绘图关键字参数。
- Returns:
- matplotlib.AxesSubplot 或它们的 numpy.ndarray
参见
matplotlib.pyplot.hist使用 matplotlib 绘制直方图。
Examples
此示例根据某些动物的长度和宽度绘制直方图，并显示在三个 bin 中
>>> 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)
