pandas.core.groupby.DataFrameGroupBy.plot

propertyDataFrameGroupBy.plot[source]

Создать графики Series или DataFrame.

Использует бэкенд, указанный в параметре plotting.backend. По умолчанию используется matplotlib.

Параметры:

data:Series или DataFrame

Объект, для которого вызывается метод.

x:метка или позиция, по умолчанию None

Используется только если data — DataFrame.

y:метка, позиция или список меток, позиций, по умолчанию None

Позволяет построить график одной колонки против другой. Используется только если data — DataFrame.

kind:str

Тип графика:

• ‘line’ : линейный график (по умолчанию)

• ‘bar’ : вертикальная гистограмма

• ‘barh’ : горизонтальная гистограмма

• ‘hist’ : гистограмма

• ‘box’ : ящик с усами

• ‘kde’ : график оценки плотности ядра

• ‘density’ : то же, что и ‘kde’

• ‘area’ : график областей

• ‘pie’ : круговая диаграмма

• ‘scatter’ : диаграмма рассеяния (только для DataFrame)

• ‘hexbin’ : диаграмма гексаграмм (только для DataFrame)

ax:объект matplotlib axes, по умолчанию None

Ось текущей фигуры.

subplots:bool или последовательность итерируемых объектов, по умолчанию False

Следует ли группировать колонки в подграфики:

• False : Подграфики не будут использоваться

• True : Создавать отдельные подграфики для каждой колонки.

• Последовательность итерируемых объектов меток колонок: Создать подграфик для каждой группы колонок. Например, [(‘a’, ‘c’), (‘b’, ‘d’)] создаст 2 подграфика: один с колонками ‘a’ и ‘c’, и один с колонками ‘b’ и ‘d’. Остальные колонки, которые не указаны, будут нанесены на дополнительные подграфики (по одной колонке на подграфик).

  Добавлена в версии 1.5.0.

sharex:bool, по умолчанию True, если ax is None, иначе False

В случае subplots=True, использовать общую ось x и сделать некоторые метки оси x невидимыми; по умолчанию True, если ax is None, иначе False, если передана ось ax; Обратите внимание, что передача как оси ax, так и sharex=True изменит все метки оси x для всех осей в фигуре.

sharey:bool, по умолчанию False

В случае subplots=True, использовать общую ось y и сделать некоторые метки оси y невидимыми.

layout:кортеж, необязательно

(строки, столбцы) для макета подграфиков.

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

Размер объекта фигуры.

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

Использовать индекс в качестве меток для оси x.

title:str или список

Заголовок для графика. Если передана строка, выводится строка в верхней части фигуры. Если передается список и subplots — True, выводится каждый элемент списка над соответствующим подграфиком.

grid:bool, по умолчанию None (по умолчанию в стиле matlab)

Линии сетки осей.

legend:bool или {‘reverse’}

Поместить легенду на подграфики осей.

style:список или словарь

Стиль matplotlib линий по колонке.

logx:bool или ‘sym’, по умолчанию False

Использовать логарифмическую или симлогарифмическую шкалу по оси x.

logy:bool или ‘sym’, по умолчанию False

Использовать логарифмическую или симлогарифмическую шкалу по оси y.

loglog:bool или ‘sym’, по умолчанию False

Использовать логарифмическую или симлогарифмическую шкалу по обеим осям.

xticks:последовательность

Значения для использования в xticks.

yticks:последовательность

Значения для использования в yticks.

xlim:кортеж/список из 2 элементов

Установить пределы по оси x текущей оси.

ylim:кортеж/список из 2 элементов

Установить пределы по оси y текущей оси.

xlabel:метка, необязательно

Имя для метки оси x. По умолчанию используется имя индекса в качестве метки x или имя колонки x для графиков.

Изменено в версии 2.0.0: Теперь применимо к гистограммам.

ylabel:метка, необязательно

Имя для метки оси y. По умолчанию метка оси y не отображается или используется имя колонки y для графиков.

Изменено в версии 2.0.0: Теперь применимо к гистограммам.

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

Поворот меток (xticks для вертикальных, yticks для горизонтальных графиков).

fontsize:float, по умолчанию None

Размер шрифта для xticks и yticks.

colormap:str или объект matplotlib colormap, по умолчанию None

Цветовая карта для выбора цветов. Если строка, загрузить цветовую карту с этим именем из matplotlib.

colorbar:bool, необязательно

Если True, нарисовать цветковую шкалу (актуально только для графиков ‘scatter’ и ‘hexbin’).

position:float

Указать относительные выравнивания для макета гистограмм. От 0 (левый/нижний край) до 1 (правый/верхний край). По умолчанию 0,5 (центр).

table:bool, Series или DataFrame, по умолчанию False

Если True, нарисовать таблицу, используя данные в DataFrame, и данные будут транспонированы, чтобы соответствовать макету matplotlib по умолчанию. Если переданы Series или DataFrame, использовать переданные данные для рисования таблицы.

yerr:DataFrame, Series, массив-подобный объект, словарь и строка

См. Графики с ошибками для подробностей.

xerr:DataFrame, Series, массив-подобный объект, словарь и строка

Аналогично yerr.

stacked:bool, по умолчанию False в графиках линий и столбцов и True в графиках областей

Если True, создать стопкой график.

secondary_y:bool или последовательность, по умолчанию False

Следует ли строить на вторичной оси y, если список/кортеж, какие колонки строить на вторичной оси y.

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

При использовании вторичной оси y автоматически добавлять меткам колонок в легенде “(справа)”.

include_bool:bool, по умолчанию False

Если True, булевые значения могут быть нанесены на график.

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

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

**kwargs

Параметры для передачи методу matplotlib plotting.

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

matplotlib.axes.Axes или numpy.ndarray из них

Если бэкенд не по умолчанию matplotlib, возвращаемое значение будет объектом, возвращаемым бэкендом.

Примечания

• См. документацию matplotlib в Интернете для получения дополнительной информации по этому вопросу.

• Если kind = ‘bar’ или ‘barh’, вы можете указать относительные выравнивания для макета гистограмм с помощью ключевого слова position. От 0 (левый/нижний край) до 1 (правый/верхний край). По умолчанию 0,5 (центр)

Примеры

Для Series:

>>> ser = pd.Series([1, 2, 3, 3])
>>> plot = ser.plot(kind='hist', title="My plot")

Для DataFrame:

>>> 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'])
>>> plot = df.plot(title="DataFrame Plot")

Для SeriesGroupBy:

>>> lst = [-1, -2, -3, 1, 2, 3]
>>> ser = pd.Series([1, 2, 2, 4, 6, 6], index=lst)
>>> plot = ser.groupby(lambda x: x > 0).plot(title="SeriesGroupBy Plot")

Для DataFrameGroupBy:

>>> df = pd.DataFrame({"col1" : [1, 2, 3, 4],
...                   "col2" : ["A", "B", "A", "B"]})
>>> plot = df.groupby("col2").plot(kind="bar", title="DataFrameGroupBy Plot")