pandas.DataFrame.hist

DataFrame.hist(столбец=None, by=None, сетка=True, xlabelsize=None, xrot=None, ylabelsize=None, yrot=None, ax=None, sharex=False, sharey=False, figsize=None, layout=None, bins=10, бэкенд=None, легенда=False, **kwargs)

Построить гистограмму столбцов DataFrame.

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

Параметры:

данныеDataFrame

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

столбецstr или sequence, опционально

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

byобъект, опционально

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

сеткаbool, по умолчанию True

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

xlabelsizeint, по умолчанию None

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

xrotfloat, по умолчанию None

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

ylabelsizeint, по умолчанию None

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

yrotfloat, по умолчанию None

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

axОбъект осей Matplotlib, по умолчанию None

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

sharexbool, по умолчанию True, если ax равен None, иначе False

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

shareybool, по умолчанию False

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

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

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

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

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

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

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

бэкендstr, по умолчанию None

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

легендаbool, по умолчанию False

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

**kwargs

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

Возвращает:

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

Смотрите также

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)