pandas.DataFrame.boxplot

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

Построить диаграмму размаха для столбцов DataFrame.

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

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

Параметры:

column : str или список str, необязательно Имя столбца или список имён, или вектор. Может быть любой допустимый вход для pandas.DataFrame.groupby(). by : str или массив-подобный объект, необязательно Столбец в DataFrame для pandas.DataFrame.groupby(). Одна диаграмма размаха будет создана для каждого значения столбцов в by. ax : объект класса matplotlib.axes.Axes, необязательно Ось matplotlib, которая будет использована для построения диаграммы размаха. fontsize : float или str Размер шрифта меток на оси в пунктах или в виде строки (например, large). rot : int или float, по умолчанию 0 Угол поворота меток (в градусах) относительно координатной системы экрана. grid : boolean, по умолчанию 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. **kwds Все остальные ключевые аргументы для построения, которые будут переданы matplotlib.pyplot.boxplot().

Возвращает:

result : Тип возвращаемого значения зависит от параметра return_type: ‘axes’ : объект класса matplotlib.axes.Axes ‘dict’ : словарь объектов matplotlib.lines.Line2D ‘both’ : именованный кортеж со структурой (ax, lines) Для данных, сгруппированных с by: Series array (для return_type = None).

См. также

Series.plot.hist

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

matplotlib.pyplot.boxplot

Эквивалентная функция построения в Matplotlib.

Примечания

Используйте 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'>