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’. Остальные колонки, которые не указаны, будут нанесены на дополнительные подграфики (по одной колонке на подграфик). .. versionadded:: 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. .. versionchanged:: 0.25.0

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Новое в версии 1.1.0.

Изменено в версии 1.2.0: Теперь применимо к графикам (scatter, hexbin).

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

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

Новое в версии 1.1.0.

Изменено в версии 1.2.0: Теперь применимо к графикам (scatter, hexbin).

rot:целое число, по умолчанию None

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

fontsize:целое число, по умолчанию None

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

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

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

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

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

position:число с плавающей точкой

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

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

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

yerr:DataFrame, Series, массив, список, словарь и строка

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

xerr:DataFrame, Series, массив, список, словарь и строка

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

stacked:bool, по умолчанию False для графиков line и bar, и True для area графика

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

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

Сортировать имена колонок, чтобы определить порядок построения графика.

Устарело начиная с версии 1.5.0: Аргумент sort_columns устарел и будет удален в будущей версии.

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

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

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

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

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

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

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

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

Новое в версии 1.0.0.

**kwargs

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

Возвращает

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

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

Примечания

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

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