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

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

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

Параметры:

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

Возвращает:

axes : matplotlib.AxesSubplot or numpy.ndarray of them

См. также

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)