pandas.DataFrame.plot

DataFrame.plot(*args, **kwargs)

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

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

Параметры:

данныеSeries или DataFrame

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

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

Используется только если данные являются DataFrame.

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

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

kindstr

Тип графика для создания:

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

• 'bar' : вертикальная столбчатая диаграмма

• 'barh' : горизонтальная столбчатая диаграмма

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

• 'box' : boxplot

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

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

• 'area' : график площади

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

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

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

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

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

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

Группировать ли столбцы в подграфики:

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

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

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

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

sharexbool, по умолчанию True, если ax равен None, иначе False

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

shareybool, по умолчанию False

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

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

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

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

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

use_indexbool, по умолчанию True

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

titlestr или list

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

сеткаbool, по умолчанию None (стиль matlab по умолчанию)

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

легендаbool или {'reverse'}

Разместить легенду на подграфиках оси.

стильсписок или словарь

Стиль линии matplotlib для каждого столбца.

logxbool или 'sym', по умолчанию False

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

logybool или ‘sym’ по умолчанию False

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

loglogbool или 'sym', по умолчанию False

Использовать логарифмическое масштабирование или симметричное логарифмическое масштабирование на обеих осях x и y.

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

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

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

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

xlim2-элементный кортеж/список

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

ylim2-элементный кортеж/список

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

подпись оси Xlabel, optional

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

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

ylabellabel, optional

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

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

rotfloat, по умолчанию None

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

размер шрифтаfloat, по умолчанию None

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

цветовая картаstr или объект цветовой карты matplotlib, по умолчанию None

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

colorbarbool, необязательно

Если True, отображать цветовую шкалу (актуально только для диаграмм рассеяния и шестиугольных диаграмм).

позицияfloat

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

таблицаbool, Series или DataFrame, по умолчанию False

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

yerrDataFrame, Series, array-like, dict и str

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

xerrDataFrame, Series, array-like, dict и str

Эквивалентно yerr.

stackedbool, по умолчанию False для линейных и столбчатых графиков, и True для площадных графиков

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

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

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

mark_rightbool, по умолчанию True

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

include_boolbool, по умолчанию False

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

бэкендstr, по умолчанию None

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

**kwargs

Опции для передачи методу построения графиков matplotlib.

Возвращает:

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

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

Примечания

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

• Если kind = 'bar' или 'barh', вы можете указать относительные выравнивания для макета столбчатой диаграммы, задав позиция ключевое слово. От 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")