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 : string or sequence Если указано, будет использоваться для ограничения данных подмножеством столбцов. by : object, optional Если указано, используется для построения гистограмм для отдельных групп. grid : boolean, default True Показывать ли линии сетки на осях. xlabelsize : int, default None Если указано, изменяет размер метки оси X. xrot : float, default None Поворот меток оси X. Например, значение 90 отображает метки оси X, повернутые на 90 градусов по часовой стрелке. ylabelsize : int, default None Если указано, изменяет размер метки оси Y. yrot : float, default None Поворот меток оси Y. Например, значение 90 отображает метки оси Y, повернутые на 90 градусов по часовой стрелке. ax : Matplotlib axes object, default None Оси для построения гистограммы. sharex : boolean, default True if ax is None else False В случае subplots=True, делится осью X и делает некоторые метки оси X невидимыми; по умолчанию True, если ax равно None, иначе False, если передаётся ax. Обратите внимание, что передача ax и sharex=True изменит все метки оси X для всех подграфиков в фигуре. sharey : boolean, default False В случае subplots=True, делится осью Y и делает некоторые метки оси Y невидимыми. figsize : tuple Размер фигуры в дюймах. По умолчанию используется значение в matplotlib.rcParams. layout : tuple, optional Кортеж (строки, столбцы) для макета гистограмм. bins : integer or sequence, default 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)