pandas.core.groupby.DataFrameGroupBy.hist

DataFrameGroupBy.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)[source]

Создаёт гистограмму столбцов DataFrame.

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

Параметры:

data:DataFrame

Объект pandas, содержащий данные.

column:str или последовательность, необязательно

Если передано, используется для ограничения данных подмножеством столбцов.

by:объект, необязательно

Если передано, используется для формирования гистограмм для отдельных групп.

grid:bool, по умолчанию True

Показывать ли линии сетки на осях.

xlabelsize:int, по умолчанию None

Если указано, изменяет размер метки оси x.

xrot:float, по умолчанию None

Поворот меток оси x. Например, значение 90 отображает метки оси x, повернутые на 90 градусов по часовой стрелке.

ylabelsize:int, по умолчанию None

Если указано, изменяет размер метки оси y.

yrot:float, по умолчанию None

Поворот меток оси y. Например, значение 90 отображает метки оси y, повернутые на 90 градусов по часовой стрелке.

ax:объект Matplotlib axes, по умолчанию None

Оси для построения гистограммы.

sharex:bool, по умолчанию True, если ax is None, иначе False

В случае subplots=True, использует общую ось x и делает некоторые метки оси x невидимыми; по умолчанию True, если ax is None, иначе False, если ax передан. Обратите внимание, что передача ax и sharex=True изменит все метки оси x для всех подграфиков в figure.

sharey:bool, по умолчанию False

В случае subplots=True, использует общую ось y и делает некоторые метки оси y невидимыми.

figsize:кортеж, необязательно

Размер фигуры в дюймах. Использует значение по умолчанию из matplotlib.rcParams.

layout:кортеж, необязательно

Кортеж (строки, столбцы) для макета гистограмм.

bins:int или последовательность, по умолчанию 10

Количество столбцов гистограммы. Если целое число, вычисляются и возвращаются граничные значения bins + 1. Если bins — последовательность, даёт граничные значения, включая левую границу первого столбца и правую границу последнего столбца. В этом случае bins возвращается без изменений.

backend:строка, по умолчанию None

Бэкенд для использования вместо бэкенда, указанного в опции plotting.backend. Например, ‘matplotlib’. В качестве альтернативы, для указания plotting.backend для всей сессии, установите pd.options.plotting.backend.

legend:bool, по умолчанию False

Показывать ли легенду.

**kwargs

Все остальные ключевые аргументы для построения графиков, которые будут переданы в matplotlib.pyplot.hist().

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

matplotlib.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)