pandas.DataFrame.plot

DataFrame.plot(*args, **kwargs)[source]

Построение графиков для Series или DataFrame.

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

Параметры:

data:Series или DataFrame

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

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

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

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

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

kind:строка

Тип графика:

• ‘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:последовательность

Значения для меток оси x.

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

Значения для меток оси y.

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

Размер шрифта для меток x и y.

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

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

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

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

position:float

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

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

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

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

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

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

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

stacked:bool, по умолчанию False для линейных и гистограмм, True для area графика

Если 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 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")