matplotlib.axes.Axes.plot

Axes.plot(*args, data=None, **kwargs) [source]

Построение графика y по x в виде линий и/или маркеров.

Подписи сигнатур:

plot([x], y, [fmt], data=None, **kwargs)
plot([x], y, [fmt], [x2], y2, [fmt2], ..., **kwargs)

Координаты точек или узлов линии задаются параметрами x и y.

Необязательный параметр fmt является удобным способом определения базового форматирования, такого как цвет, маркер и тип линии. Это сокращенная строковая нотация, описанная в разделе Замечания ниже.

>>> plot(x, y)        # plot x and y using default line style and color
>>> plot(x, y, 'bo')  # plot x and y using blue circle markers
>>> plot(y)           # plot y using x as index array 0..N-1
>>> plot(y, 'r+')     # ditto, but with red plusses

Вы можете использовать свойства Line2D в качестве ключевых аргументов для большего контроля над внешним видом. Свойства линий и fmt могут быть смешаны. Следующие два вызова дают одинаковые результаты:

>>> plot(x, y, 'go--', linewidth=2, markersize=12)
>>> plot(x, y, color='green', marker='o', linestyle='dashed',
        linewidth=2, markersize=12)

При конфликте с fmt, ключевые аргументы имеют приоритет.

Построение данных с метками

Есть удобный способ построения объектов с метками данных (т.е. данных, к которым можно получить доступ по индексу obj['y']). Вместо предоставления данных в параметрах x и y, вы можете предоставить объект в параметре data и просто указать метки для x и y:

>>> plot('xlabel', 'ylabel', data=obj)

Поддерживаются все индексируемые объекты. Это может быть, например, dict, массив pandas.DataFame или структурированный массив NumPy.

Построение нескольких наборов данных

Существует несколько способов построения нескольких наборов данных.

• Наиболее прямой способ — многократно вызывать plot. Пример:

  >>> plot(x1, y1, 'bo')
  >>> plot(x2, y2, 'go')
  

• В качестве альтернативы, если ваши данные уже представлены двумерным массивом, вы можете передать его непосредственно в x и y. Для каждого столбца будет нарисован отдельный набор данных.

  Пример: массив a, где первый столбец представляет значения x, а другие столбцы — столбцы y:

  >>> plot(a[0], a[1:])
  

• Третий способ — указать несколько наборов [x], y, [fmt] групп:

  >>> plot(x1, y1, 'g^', x2, y2, 'g-')
  

  В этом случае любые дополнительные ключевые аргументы применяются ко всем наборам данных. Также этот синтаксис нельзя комбинировать с параметром data.

По умолчанию каждой линии назначается другой стиль, задаваемый циклом стилей. Параметры fmt и свойств линии необходимы только в случае, если вы хотите явно отклониться от этих значений по умолчанию. В качестве альтернативы, вы также можете изменить цикл стилей с помощью параметра rcParam 'axes.prop_cycle'.

Параметры:	x, y : array-like or scalar Горизонтальные/вертикальные координаты точек данных. Значения x необязательны. Если они не указаны, они по умолчанию равны [0, ..., N-1]. Обычно эти параметры представляют собой массивы длиной N. Однако поддерживаются и скаляры (эквивалентно массиву с постоянным значением). Параметры также могут быть двумерными. В этом случае столбцы представляют отдельные наборы данных. fmt : str, optional Строка формата, например, 'ro' для красных кругов. Полное описание строк формата см. в разделе Замечания. Строки формата — это просто сокращения для быстрого задания основных свойств линии. Все эти свойства и многие другие можно также настроить с помощью ключевых аргументов. data : indexable object, optional Объект с метками данных. Если задан, укажите имена меток для построения в x и y. Примечание Технически существует небольшая неоднозначность в вызовах, где вторая метка является допустимым fmt. plot('n', 'o', data=obj) может быть plt(x, y) или plt(y, fmt). В таких случаях выбирается первое толкование, но выдается предупреждение. Вы можете подавить предупреждение, добавив пустую строку формата plot('n', 'o', '', data=obj).
Возвращает:	lines Список объектов Line2D, представляющих построенные данные.
Другие параметры:	scalex, scaley : bool, optional, default: True Эти параметры определяют, адаптируются ли пределы отображения к пределам данных. Значения передаются в autoscale_view. **kwargs : Line2D properties, optional

kwargs используются для задания свойств, таких как метка линии (для автоматических легенд), ширина линии, сглаживание, цвет заливки маркера. Пример: >>> plot([1,2,3], [1,2,3], 'go-', label='line 1', linewidth=2) >>> plot([1,2,3], [1,4,9], 'rs', label='line 2') Если вы создаёте несколько линий с одной командой построения графика, kwargs применяются ко всем этим линиям. Вот список доступных свойств Line2D: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный) animated булево значение antialiased или aa булево значение clip_box экземпляр Bbox clip_on булево значение clip_path [(Path, Transform) | Patch | None] color или c любой цвет matplotlib contains вызываемая функция dash_capstyle ['butt' | 'round' | 'projecting'] dash_joinstyle ['miter' | 'round' | 'bevel'] dashes последовательность включения/выключения чернил в пунктах drawstyle ['default' | 'steps' | 'steps-pre' | 'steps-mid' | 'steps-post'] figure экземпляр Figure fillstyle ['full' | 'left' | 'right' | 'bottom' | 'top' | 'none'] gid строка-идентификатор label объект linestyle или ls ['solid' | 'dashed', 'dashdot', 'dotted' | (смещение, последовательность включения/выключения) | '-' | '--' | '-.' | ':' | 'None' | ' ' | ''] linewidth или lw вещественное значение в пунктах marker A valid marker style markeredgecolor или mec любой цвет matplotlib markeredgewidth или mew вещественное значение в пунктах markerfacecolor или mfc любой цвет matplotlib markerfacecoloralt или mfcalt любой цвет matplotlib markersize или ms вещественное число markevery [None | целое число | кортеж длиной 2 из целых чисел | срез | список/массив целых чисел | вещественное число | кортеж длиной 2 из вещественных чисел] path_effects AbstractPathEffect picker расстояние в пунктах или вызываемая функция выбора fn(artist, event) pickradius расстояние в пунктах rasterized булево значение или None sketch_params (масштаб: вещественное число, длина: вещественное число, случайность: вещественное число) snap булево значение или None solid_capstyle ['butt' | 'round' | 'projecting'] solid_joinstyle ['miter' | 'round' | 'bevel'] transform экземпляр matplotlib.transforms.Transform url строка url visible булево значение xdata одномерный массив ydata одномерный массив zorder вещественное число

См. также

scatter

Диаграмма рассеяния XY с маркерами различного размера и/или цвета (иногда также называется диаграммой пузырьков).

Примечания

Строки форматирования

Строка форматирования состоит из части для цвета, маркера и линии:

fmt = '[color][marker][line]'

Каждая из них является необязательной. Если не указано, используется значение из цикла стилей. Исключение: Если line указано, но нет marker, данные будут отображаться в виде линии без маркеров.

Цвета

Поддерживаются следующие сокращения цветов:

символ	цвет
'b'	синий
'g'	зелёный
'r'	красный
'c'	голубой
'm'	пурпурный
'y'	жёлтый
'k'	чёрный
'w'	белый

Если цвет — единственная часть строки форматирования, вы также можете использовать любой спецификатор matplotlib.colors, например, полные имена ('green') или шестнадцатеричные строки ('#008000').

Маркеры

символ	описание
'.'	маркер точки
','	маркер пикселя
'o'	маркер круга
'v'	маркер треугольника вниз
'^'	маркер треугольника вверх
'<'	маркер треугольника влево
'>'	маркер треугольника вправо
'1'	маркер tri_down
'2'	маркер tri_up
'3'	маркер tri_left
'4'	маркер tri_right
's'	маркер квадрата
'p'	маркер пятиугольника
'*'	маркер звезды
'h'	маркер шестиугольника1
'H'	маркер шестиугольника2
'+'	маркер плюса
'x'	маркер креста
'D'	маркер ромба
'd'	маркер тонкого ромба
'|'	маркер вертикальной линии
'_'	маркер горизонтальной линии

Стиле линии

символ	описание
'-'	сплошная линия
'--'	штриховая линия
'-.'	пунктирная линия
':'	точечная линия

Примеры строк форматирования:

'b'    # blue markers with default shape
'ro'   # red circles
'g-'   # green solid line
'--'   # dashed line with default color
'k^:'  # black triangle_up markers connected by a dotted line

Примечание

Помимо вышеописанных аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все аргументы со следующими именами: 'x', 'y'.

Примеры использования matplotlib.axes.Axes.plot

Цвет по значению y

Демонстрация цветов

Стиль с циклом

Простой график

Демонстрация triinterp

Маркер Path

Демонстрация полярной системы координат

Полярная легенда