matplotlib.pyplot.plot

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

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

../../_images/sphx_glr_custom_scale_example_thumb.png

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

../../_images/sphx_glr_custom_projection_example_thumb.png

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

../../_images/sphx_glr_pyplot_simple_thumb.png

Простой Pyplot

Pyplot Formatstr

Pyplot Three

../../_images/sphx_glr_whats_new_98_4_legend_thumb.png

Новинки 0.98.4 Легенда

../../_images/sphx_glr_pyplot_two_subplots_thumb.png

Pyplot Два Подграфика

../../_images/sphx_glr_pyplot_annotate_thumb.png

Демонстрация нескольких фигур

../../_images/sphx_glr_subplot_thumb.png

Несколько подграфиков

../../_images/sphx_glr_shared_axis_demo_thumb.png

Демонстрация общей оси

../../_images/sphx_glr_figure_title_thumb.png

Рассеянные Маскированные

../../_images/sphx_glr_psd_demo_thumb.png

Демо PSD

../../_images/sphx_glr_contour_corner_mask_thumb.png

Маска Угла Контура

../../_images/sphx_glr_specgram_demo_thumb.png

Демонстрация Спектрограммы

../../_images/sphx_glr_tricontour_vs_griddata_thumb.png

Tricontour против Griddata

../../_images/sphx_glr_triinterp_demo_thumb.png

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

../../_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

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

../../_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

Бакалавриат по полу

MovieWriter

../../_images/sphx_glr_basic_example_thumb.png

Примеры простой анимации

../../_images/sphx_glr_basic_example_writer_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

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

../../_images/sphx_glr_common_date_problems_thumb.png

Исправление распространенных проблем с датами

END_OF_DOCUMENT_MARKER

../../_images/sphx_glr_symlog_demo_thumb.png

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

../../_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

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

Учебное пособие по Pyplot

../../_images/sphx_glr_legend_guide_thumb.png

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

../../_images/sphx_glr_patheffects_guide_thumb.png

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

matplotlib.pyplot.plot

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

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