pandas.DataFrame.boxplot

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

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

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

Подробнее см. страницу Википедии boxplot.

Параметры:

column:str или список 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’ возвращает кортеж с именами (ось, линии).

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

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

backend:str, по умолчанию None

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

**kwargs

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

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

результат

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

См. также

pandas.Series.plot.hist

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

matplotlib.pyplot.boxplot

Эквивалентная функция в matplotlib.

Примечания

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

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

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

• ‘both’ : кортеж с именами (ось, линии)

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

• Series

• array (для return_type = None)

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

Примеры

Диаграммы размаха можно создать для каждого столбца в dataframe 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']) можно передать в boxplot, чтобы сгруппировать данные по комбинации переменных на оси 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'>