pandas.Series.plot

Series.plot(*args, **kwargs)[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:строка или список

Заголовок для графика. Если передана строка, выведите строку в верхней части фигуры. Если передан список и 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 для плоских графиков.

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

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

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

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

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

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

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

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

colormap:строка или объект 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, значения boolean можно строить.

backend:строка, по умолчанию None

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

**kwargs

Параметры для передачи в matplotlib.

Возвращает:

matplotlib.axes.Axes или массив numpy из них

Если бэкенд не является стандартным 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")