matplotlib.axes.Axes.plot

Axes.plot(self, *args, scalex=True, scaley=True, 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 и свойств линий необходимы только в случае явного отклонения от этих значений по умолчанию. В качестве альтернативы, вы также можете изменить цикл стилей, используя rcParams["axes.prop_cycle"] (по умолчанию: cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])).

Параметры:

Параметры:	`x, yarray-like or scalar` Горизонтальные / вертикальные координаты точек данных. Значения x необязательны и по умолчанию равны `range(len(y))`. Обычно эти параметры являются одномерными массивами. Они также могут быть скалярами или двумерными (в этом случае столбцы представляют отдельные наборы данных). Эти аргументы не могут передаваться как ключевые. `fmtstr, optional` Строка формата, например, 'ro' для красных кружков. Подробное описание строк формата см. в разделе Примечания. Строки формата — это просто сокращения для быстрого задания основных свойств линии. Все эти и другие свойства также можно задавать с помощью ключевых аргументов. Этот аргумент не может передаваться как ключевой. `dataindexable object, optional` Объект с метками данных. Если он задан, укажите имена меток для построения по x и y. Примечание Технически существует небольшая неоднозначность в вызовах, где вторая метка является допустимым fmt. `plot('n', 'o', data=obj)` может быть `plt(x, y)` или `plt(y, fmt)`. В таких случаях выбирается первое толкование, но выдается предупреждение. Вы можете подавить предупреждение, добавив пустую строку формата `plot('n', 'o', '', data=obj)`.
Возвращает:	lines Список объектов `Line2D`, представляющих нарисованные данные.

x, yarray-like or scalar

Горизонтальные / вертикальные координаты точек данных. Значения x необязательны и по умолчанию равны range(len(y)).

Обычно эти параметры являются одномерными массивами.

Они также могут быть скалярами или двумерными (в этом случае столбцы представляют отдельные наборы данных).

Эти аргументы не могут передаваться как ключевые.

fmtstr, optional

Строка формата, например, 'ro' для красных кружков. Подробное описание строк формата см. в разделе Примечания.

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

Этот аргумент не может передаваться как ключевой.

dataindexable object, optional

Объект с метками данных. Если он задан, укажите имена меток для построения по x и y.

Примечание

Технически существует небольшая неоднозначность в вызовах, где вторая метка является допустимым fmt. plot('n', 'o', data=obj) может быть plt(x, y) или plt(y, fmt). В таких случаях выбирается первое толкование, но выдается предупреждение. Вы можете подавить предупреждение, добавив пустую строку формата plot('n', 'o', '', data=obj).

Возвращает:

lines: Список объектов Line2D, представляющих нарисованные данные.

Другие параметры:

scalex, scaleybool, optional, default: True

Эти параметры определяют, адаптируются ли пределы просмотра к пределам данных. Значения передаются в autoscale_view.

**kwargsLine2D 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`	функция фильтра, которая принимает массив (m, n, 3) чисел с плавающей точкой и значение dpi, и возвращает массив (m, n, 3)
`alpha`	число с плавающей точкой или None
`animated`	булево значение
`antialiased` или aa	булево значение
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	Объект Patch или (Path, Transform) или None
`color` или c	цвет
`contains`	вызываемый объект
`dash_capstyle`	{'butt', 'round', 'projecting'}
`dash_joinstyle`	{'miter', 'round', 'bevel'}
`dashes`	последовательность чисел с плавающей точкой (чернила включения/выключения в точках) или (None, None)
`data`	массив (2, N) или два одномерных массива
`drawstyle` или ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
`figure`	`Figure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gid`	строка
`in_layout`	булево значение
`label`	объект
`linestyle` или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
`linewidth` или lw	число с плавающей точкой
`marker`	стиль маркера
`markeredgecolor` или mec	цвет
`markeredgewidth` или mew	число с плавающей точкой
`markerfacecolor` или mfc	цвет
`markerfacecoloralt` или mfcalt	цвет
`markersize` или ms	число с плавающей точкой
`markevery`	None или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой)
`path_effects`	`AbstractPathEffect`
`picker`	число с плавающей точкой или вызываемый объект [[Artist, Event], Tuple[bool, dict]]
`pickradius`	число с плавающей точкой
`rasterized`	булево значение или None
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`solid_capstyle`	{'butt', 'round', 'projecting'}
`solid_joinstyle`	{'miter', 'round', 'bevel'}
`transform`	`matplotlib.transforms.Transform`
`url`	строка
`visible`	булево значение
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	число с плавающей точкой

См. также

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

Примечания

Строки формата

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

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

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

Поддерживаются и другие комбинации, такие как [color][marker][line], но обратите внимание, что их разбор может быть неоднозначным.

Маркеры

символ	описание
`'.'`	маркер точки
`','`	маркер пикселя
`'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
'or'   # red circles
'-g'   # green solid line
'--'   # dashed line with default color
'^k:'  # black triangle_up markers connected by a dotted line

Цвета

Поддерживаются сокращения цветов — однобуквенные коды

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

и 'CN' цвета, которые индексируют в цикл свойств по умолчанию.

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