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, по умолчанию 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.

Новое в версии 1.0.0.

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

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

Новое в версии 1.1.0.

**kwargs

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

Returns

matplotlib.AxesSubplot или numpy.ndarray из них

См. также

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)