pandas.DataFrame.hist

DataFrame.hist(data, 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, **kwds) [source]

Создать гистограмму для DataFrame.

Гистограмма представляет собой графическое изображение распределения данных. Эта функция вызывает matplotlib.pyplot.hist(), для каждой серии в DataFrame, что приводит к одной гистограмме на столбец.

Параметры:

data : DataFrame Объект pandas, содержащий данные. column : string or sequence Если указано, используется для ограничения данных подмножеством столбцов. by : object, optional Если указано, используется для построения гистограмм для отдельных групп. grid : bool, default True Показывать ли сетку на осях. xlabelsize : int, default None Если указано, изменяет размер метки оси X. xrot : float, default None Поворот меток оси X. Например, значение 90 отображает метки оси X, повернутые на 90 градусов по часовой стрелке. ylabelsize : int, default None Если указано, изменяет размер метки оси Y. yrot : float, default None Поворот меток оси Y. Например, значение 90 отображает метки оси Y, повернутые на 90 градусов по часовой стрелке. ax : Matplotlib axes object, default None Оси для построения гистограммы. sharex : bool, default True if ax is None else False В случае subplots=True, совмещать ось X и делать некоторые метки оси X невидимыми; по умолчанию True, если ax=None, иначе False, если ax передан. Обратите внимание, что передача как ax, так и sharex=True изменит все метки оси X для всех подграфиков в фигуре. sharey : bool, default False В случае subplots=True, совмещать ось Y и делать некоторые метки оси Y невидимыми. figsize : tuple Размер фигуры в дюймах. Использует значение в matplotlib.rcParams по умолчанию. layout : tuple, optional Кортеж (строки, столбцы) для макета гистограмм. bins : integer or sequence, default 10 Количество бинов гистограммы. Если целое число, рассчитываются и возвращаются границы бинов + 1. Если bins — последовательность, возвращаются границы бинов, включая левую границу первого бина и правую границу последнего. В этом случае bins возвращается без изменений. **kwds Все остальные параметры построения для передачи в matplotlib.pyplot.hist().

Возвращаемое значение:

matplotlib.AxesSubplot или массив numpy таких объектов

См. также

matplotlib.pyplot.hist

Построить гистограмму с помощью matplotlib.

Примеры

В этом примере построена гистограмма, основанная на длине и ширине некоторых животных, отображаемых в трёх бинах

>>> df = pd.DataFrame({
...     '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'])
>>> hist = df.hist(bins=3)