matplotlib.axes.Axes.plot

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

Строит линии и/или маркеры на Axes. args — аргумент переменной длины, позволяющий задавать несколько пар x, y с необязательной строкой формата. Например, каждое из следующих выражений допустимо:

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

Если x и/или y является двумерным, то соответствующие столбцы будут построены.

Если используется меченые данные, убедитесь, что спецификация цвета не включена в данные, так как в противном случае последний случай plot("v","r", data={"v":..., "r":...) может быть интерпретирован как первый случай, который бы plot(v, r) с использованием стандартного стиля линии и цвета.

Если не используется меченые данные (т.е. без аргумента data), может быть задано произвольное количество групп x, y, fmt, как в:

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

Возвращаемое значение — список линий, которые были добавлены.

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

Следующие символы строки формата принимаются для управления стилем линии или маркера:

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

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

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

Кроме того, вы можете указать цвета многими способами, включая полные имена ('green'), шестнадцатеричные строки ('#008000'), кортежи RGB или RGBA ((0,1,0,1)) или градации серого как строку ('0.8'). Из этих строковых спецификаций можно использовать вместо группы fmt, но кортежи можно использовать только как kwargs.

Стиль линии и цвет комбинируются в одной строке формата, как в 'bo' для синих кругов.

kwargs можно использовать для установки свойств линии (любое свойство, для которого есть метод set_*). Вы можете использовать это для установки метки линии (для автоматических легенд), ширины линии, антиалиасинга, цвета заливки маркера и т. д. Вот пример:

plot([1,2,3], [1,2,3], 'go-', label='line 1', linewidth=2)
plot([1,2,3], [1,4,9], 'rs',  label='line 2')
axis([0, 4, 0, 10])
legend()

Если вы создаете несколько линий одной командой plot, kwargs применяются ко всем этим линиям, например:

plot(x1, y1, x2, y2, antialiased=False)

Ни одна линия не будет иметь антиалиасинга.

Вам не нужно использовать строки формата, которые являются просто сокращениями. Все свойства линий можно контролировать с помощью ключевых аргументов. Например, вы можете задать цвет, маркер, стиль линии и цвет маркера с помощью:

plot(x, y, color='green', linestyle='dashed', marker='o',
     markerfacecolor='blue', markersize=12).

См. Line2D для подробностей.

kwargs являются Line2D свойствами:

Свойство	Описание
`agg_filter`	неизвестно
`alpha`	вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный)
`animated`	[True \| False]
`antialiased` или aa	[True \| False]
`clip_box`	экземпляр `matplotlib.transforms.Bbox`
`clip_on`	[True \| False]
`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`	экземпляр `matplotlib.figure.Figure`
`fillstyle`	[‘full’ \| ‘left’ \| ‘right’ \| ‘bottom’ \| ‘top’ \| ‘none’]
`gid`	строка идентификатора
`label`	строка или любой вывод с преобразованием «%s»
`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`	неизвестно
`picker`	расстояние в пунктах или вызываемая функция выбора `fn(artist, event)`
`pickradius`	расстояние в пунктах
`rasterized`	[True \| False \| None]
`sketch_params`	неизвестно
`snap`	неизвестно
`solid_capstyle`	[‘butt’ \| ‘round’ \| ‘projecting’]
`solid_joinstyle`	[‘miter’ \| ‘round’ \| ‘bevel’]
`transform`	экземпляр `matplotlib.transforms.Transform`
`url`	строка URL
`visible`	[True \| False]
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	любое число

Ключевые слова scalex и scaley, если определены, передаются в autoscale_view(), чтобы определить, масштабируются ли оси x и y автоматически; по умолчанию — True.

Примечание

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

Все аргументы с именами «x», «y».