pandas.plotting.boxplot

pandas.plotting.boxplot(data, column=None, by=None, ax=None, fontsize=None, rot=0, grid=True, figsize=None, layout=None, return_type=None, **kwargs)[source]

Построение диаграммы размаха для столбцов DataFrame.

Построение диаграммы размаха и ящиков для столбцов DataFrame, необязательно с группировкой по другим столбцам. Диаграмма размаха — это метод графического отображения групп числовых данных с помощью квартилей. Ящик охватывает значения квартилей Q1 и Q3 данных, а линия представляет медиану (Q2). Усы простираются от краёв ящика, показывая диапазон данных. По умолчанию они простираются не более чем на 1.5 * IQR (IQR = Q3 - Q1) от краёв ящика, заканчиваясь на самой дальней точке данных в этом интервале. Выбросы отображаются отдельными точками.

Для получения дополнительной информации см. статью Википедии о диаграмме размаха.

Параметры:

data:DataFrame

Данные для визуализации.

column:str или список строк, необязательно

Имя столбца или список имён, или вектор. Может быть любым допустимым входом для pandas.DataFrame.groupby().

by:str или массив-подобный объект, необязательно

Столбец в DataFrame для pandas.DataFrame.groupby(). Одна диаграмма размаха будет построена для каждого значения столбцов в by.

ax:объект класса matplotlib.axes.Axes, необязательно

Оси matplotlib, которые будут использоваться в диаграмме размаха.

fontsize:float или str

Размер шрифта метки шкалы в пунктах или в виде строки (например, large).

rot:float, по умолчанию 0

Угол поворота меток (в градусах) относительно системы координат экрана.

grid:bool, по умолчанию True

Установка в значение True покажет сетку.

figsize:Кортеж (ширина, высота) в дюймах

Размер фигуры для создания в matplotlib.

layout:кортеж (строки, столбцы), необязательно

Например, (3, 5) отобразит подграфики, используя 3 строки и 5 столбцов, начиная с левого верхнего угла.

return_type:{‘axes’, ‘dict’, ‘both’} или None, по умолчанию ‘axes’

Тип возвращаемого объекта. По умолчанию axes.

• ‘axes’ возвращает оси matplotlib, на которых нарисована диаграмма размаха.

• ‘dict’ возвращает словарь, значениями которого являются объекты matplotlib Lines диаграммы размаха.

• ‘both’ возвращает именованную кортеж с структурами (ax, lines).

• при группировке с by, возвращается Series, сопоставляющий столбцы с return_type.

  Если return_type равен None, возвращается массив NumPy осей с той же формой, что и layout.

**kwargs

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

Возвращаемое значение:

result

См. Примечания.

См. также

pandas.Series.plot.hist

Построение гистограммы.

matplotlib.pyplot.boxplot

Эквивалентный график в Matplotlib.

Примечания

Тип возвращаемого значения зависит от параметра return_type:

• ‘axes’ : объект класса matplotlib.axes.Axes

• ‘dict’ : словарь объектов matplotlib.lines.Line2D

• ‘both’ : именованная кортеж со структурой (ax, lines)

Для данных, сгруппированных с by, возвращается Series вышеуказанных или массив NumPy:

• Series

• array (для return_type = None)

Используйте return_type='dict' при необходимости тонкой настройки внешнего вида линий после построения графика. В этом случае возвращается словарь, содержащий линии, образующие ящики, колпачки, выбросы, медианы и усы.

Примеры

Диаграммы размаха можно создать для каждого столбца в фрейме данных, df.boxplot() или указав используемые столбцы:

>>> np.random.seed(1234)
>>> df = pd.DataFrame(np.random.randn(10, 4),
...                   columns=['Col1', 'Col2', 'Col3', 'Col4'])
>>> boxplot = df.boxplot(column=['Col1', 'Col2', 'Col3'])  

Диаграммы размаха распределений переменных, сгруппированных по значениям третьей переменной, можно создать, используя опцию by. Например:

>>> df = pd.DataFrame(np.random.randn(10, 2),
...                   columns=['Col1', 'Col2'])
>>> df['X'] = pd.Series(['A', 'A', 'A', 'A', 'A',
...                      'B', 'B', 'B', 'B', 'B'])
>>> boxplot = df.boxplot(by='X')

Список строк (например, ['X', 'Y']) можно передать в диаграмму размаха, чтобы сгруппировать данные по сочетанию переменных на оси x:

>>> df = pd.DataFrame(np.random.randn(10, 3),
...                   columns=['Col1', 'Col2', 'Col3'])
>>> df['X'] = pd.Series(['A', 'A', 'A', 'A', 'A',
...                      'B', 'B', 'B', 'B', 'B'])
>>> df['Y'] = pd.Series(['A', 'B', 'A', 'B', 'A',
...                      'B', 'A', 'B', 'A', 'B'])
>>> boxplot = df.boxplot(column=['Col1', 'Col2'], by=['X', 'Y'])

Макет диаграммы размаха можно настроить, передав кортеж в layout:

>>> boxplot = df.boxplot(column=['Col1', 'Col2'], by='X',
...                      layout=(2, 1))

Дополнительный форматирование можно выполнить для диаграммы размаха, например, скрывая сетку (grid=False), поворачивая метки на оси x (т. е. rot=45) или изменяя размер шрифта (т. е. fontsize=15):

>>> boxplot = df.boxplot(grid=False, rot=45, fontsize=15)  

Параметр return_type может быть использован для выбора типа элемента, возвращаемого функцией boxplot. При выборе return_type='axes', возвращаются оси matplotlib, на которых нарисована диаграмма размаха:

>>> boxplot = df.boxplot(column=['Col1', 'Col2'], return_type='axes')
>>> type(boxplot)
<class 'matplotlib.axes._axes.Axes'>

При группировке с by, возвращается Series, сопоставляющий столбцы с return_type:

>>> boxplot = df.boxplot(column=['Col1', 'Col2'], by='X',
...                      return_type='axes')
>>> type(boxplot)
<class 'pandas.core.series.Series'>

Если return_type равен None, возвращается массив NumPy осей с той же формой, что и layout:

>>> boxplot = df.boxplot(column=['Col1', 'Col2'], by='X',
...                      return_type=None)
>>> type(boxplot)
<class 'numpy.ndarray'>