matplotlib.pyplot.plot

matplotlib.pyplot.plot(*args, **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')

Если вы создаёте несколько линий одной командой plot, 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 \| int \| кортеж длины 2 из int \| срез \| список/массив int \| float \| кортеж длины 2 из float]
`path_effects`	`AbstractPathEffect`
`picker`	Расстояние в точках или вызываемая функция выбора `fn(artist, event)`
`pickradius`	Расстояние в точках
`rasterized`	Булево значение или None
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`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.pyplot.plot`

../../_images/sphx_glr_pyplot_simple_thumb.png

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

../../_images/sphx_glr_pyplot_formatstr_thumb.png

Форматирование графика

../../_images/sphx_glr_pyplot_three_thumb.png

Три графика

../../_images/sphx_glr_whats_new_98_4_legend_thumb.png

Новое в версии 0.98.4 (Легенда)

../../_images/sphx_glr_pyplot_two_subplots_thumb.png

END_OF_DOCUMENT_MARKER

../../_images/sphx_glr_masked_demo_thumb.png

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

../../_images/sphx_glr_nan_test_thumb.png

Тест NaN

../../_images/sphx_glr_scatter_masked_thumb.png

Маскированный график рассеяния

../../_images/sphx_glr_psd_demo_thumb.png

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

../../_images/sphx_glr_triinterp_demo_thumb.png

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

../../_images/sphx_glr_marker_path_thumb.png

Маркер с путем

../../_images/sphx_glr_dolphin_thumb.png

Дельфины

../../_images/sphx_glr_titles_demo_thumb.png

Демонстрация заголовков

../../_images/sphx_glr_text_fontdict_thumb.png

Управление стилем текста и меток с помощью словаря

../../_images/sphx_glr_text_rotation_relative_to_line_thumb.png

Поворот текста относительно линии

../../_images/sphx_glr_multiline_thumb.png

Многострочный текст

../../_images/sphx_glr_stix_fonts_demo_thumb.png

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

../../_images/sphx_glr_usetex_demo_thumb.png

Демонстрация использования LaTeX

../../_images/sphx_glr_plot_solarizedlight2_thumb.png

Стиль оформления Solarized Light

../../_images/sphx_glr_integral_thumb.png

Интеграл как площадь под кривой

XKCD

../../_images/sphx_glr_bachelors_degrees_by_gender_thumb.png

Диплом бакалавра по полу

../../_images/sphx_glr_frame_grabbing_sgskip_thumb.png

Захват кадров

../../_images/sphx_glr_ginput_demo_sgskip_thumb.png

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

../../_images/sphx_glr_print_stdout_sgskip_thumb.png

Вывод в стандартный поток

../../_images/sphx_glr_coords_report_thumb.png

Отчет о координатах

../../_images/sphx_glr_customize_rc_thumb.png

Настройка параметров

../../_images/sphx_glr_set_and_get_thumb.png

Установка и получение

../../_images/sphx_glr_agg_buffer_thumb.png

Буфер Agg

../../_images/sphx_glr_findobj_demo_thumb.png

Поиск объектов

../../_images/sphx_glr_zorder_demo_thumb.png

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

../../_images/sphx_glr_transoffset_thumb.png

Смещение преобразования

../../_images/sphx_glr_multipage_pdf_thumb.png

PDF с несколькими страницами

../../_images/sphx_glr_custom_projection_thumb.png

Пользовательская проекция

../../_images/sphx_glr_symlog_demo_thumb.png

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

../../_images/sphx_glr_custom_scale_thumb.png

Пользовательская шкала

../../_images/sphx_glr_anscombe_thumb.png

Четвёрки Анскомба

../../_images/sphx_glr_ticklabels_rotation_thumb.png

Поворот пользовательских меток

../../_images/sphx_glr_pylab_with_gtk_sgskip_thumb.png

Pylab с GTK

../../_images/sphx_glr_toolmanager_sgskip_thumb.png

Управление инструментами

../../_images/sphx_glr_simple_legend01_thumb.png

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

../../_images/sphx_glr_rectangle_selector_thumb.png

Выбор прямоугольника

../../_images/sphx_glr_customizing_thumb.png

Настройка Matplotlib с помощью стилей и rcParams

Руководство по использованию

Учебник по Pyplot

../../_images/sphx_glr_legend_guide_thumb.png

Руководство по легендам

../../_images/sphx_glr_patheffects_guide_thumb.png

Руководство по эффектам пути

matplotlib.pyplot.plot

Примечания

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

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