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

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

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

Parameters:

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 = None, иначе False

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

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

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

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

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

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

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

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

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

backend:str, по умолчанию None

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

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

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

**kwargs

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

Returns:

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)