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]

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

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

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

Параметры

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

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

by:str или array-like, необязательно

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

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

Ось matplotlib, которая должна использоваться диаграммой размаха.

fontsize:число или строка

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

rot:int или 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 Line диаграммы размаха.

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

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

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

**kwargs

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

Возвращает

result

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

См. также

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' при необходимости изменения внешнего вида линий после построения графика. В этом случае возвращается словарь, содержащий линии, образующие ящики, колпачки, выбросы, медианы и усы.

Примеры

Диаграммы размаха можно создать для каждого столбца в 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._subplots.AxesSubplot'>

При группировке с 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'>