pyplot

matplotlib.pyplot

Предоставляет интерфейс для построения графиков, похожий на MATLAB.

pylab объединяет pyplot и numpy в один пространство имён. Это удобно для интерактивной работы, но для программирования рекомендуется сохранять пространства имён отдельными, например:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1);
y = np.sin(x)
plt.plot(x, y)

matplotlib.pyplot.acorr(x, hold=None, data=None, **kwargs)

Построение автокорреляционной функции x.

Параметры:	x : последовательность скалярных значений hold : булево значение, по умолчанию: True detrend : вызываемая функция, по умолчанию: mlab.detrend_none x центрируется функцией detrend. По умолчанию - нет нормализации. normed : булево значение, по умолчанию: True если True, данные нормализуются по автокорреляции в лаге 0. usevlines : булево значение, по умолчанию: True если True, используется Axes.vlines для построения вертикальных линий от начала координат до значения автокорреляции. В противном случае используется Axes.plot. maxlags : целое число, по умолчанию: 10 количество лагов для отображения. Если None, возвращаются все 2 * len(x) - 1 лаги.
Возвращаемое значение:	(lags, c, line, b) : где: lags - вектор лагов длиной 2`maxlags+1. c - вектор автокорреляций длиной 2`maxlags+1. line - экземпляр Line2D, возвращаемый функцией plot. b - ось x.
Дополнительные параметры:
	linestyle : Line2D свойство, по умолчанию: None Используется только если usevlines равно False. marker : строка, по умолчанию: ‘o’

Примечания

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

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

Дополнительные ключевые параметры: hold = [True|False] переопределяют состояние hold по умолчанию

Примеры

xcorr - верхний график, а acorr - нижний график.

(Исходный код, png, hires.png, pdf)

matplotlib.pyplot.angle_spectrum(x, Fs=None, Fc=None, window=None, pad_to=None, sides=None, hold=None, data=None, **kwargs)

Построение спектра фазы.

Вызов функции:

angle_spectrum(x, Fs=2, Fc=0,  window=mlab.window_hanning,
               pad_to=None, sides='default', **kwargs)

Вычисляется спектр фазы (спектр фазы с обёрнутым значением) x. Данные дополняются до длины pad_to, и к сигналу применяется функция окна window.

x: одномерный массив или последовательность

Массив или последовательность содержащая данные

Ключевые аргументы:

Fs: скаляр

Частота дискретизации (образцов в единицу времени). Она используется для вычисления частот Фурье, freqs, в циклах за единицу времени. Значение по умолчанию - 2.

window: вызываемая функция или массив

Функция или вектор длины NFFT. Для создания векторов окон, см. window_hanning(), window_none(), numpy.blackman(), numpy.hamming(), numpy.bartlett(), scipy.signal(), scipy.signal.get_window(), и т.д. По умолчанию - window_hanning(). Если в качестве аргумента передается функция, она должна принимать фрагмент данных и возвращать фрагмент, обработанный окном.

sides: [ ‘default’ | ‘onesided’ | ‘twosided’ ]

Указывает, какие части спектра возвращать. Значение по умолчанию задаёт поведение по умолчанию, которое возвращает односторонний спектр для вещественных данных и двусторонний для комплексных данных. ‘onesided’ - принудительно возвращает односторонний спектр, ‘twosided’ - двусторонний.

pad_to: целое число

Число точек, до которого дополняются данные фрагмента при выполнении FFT. Хотя не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может дать больше точек на графике, что позволит получить больше деталей. Соответствует параметру n в вызове fft(). Значение по умолчанию - None, которое устанавливает pad_to равным длине входного сигнала (т.е. без дополнения).

Fc: целое число

Центральная частота x (по умолчанию 0), которая смещает диапазон значений x на графике для отражения диапазона частот, используемого при получении сигнала, а затем его фильтрации и дискретизации до базовой полосы.

Возвращает кортеж (spectrum, freqs, line):

spectrum: одномерный массив

Значения для спектра фазы в радианах (вещественные значения)

freqs: одномерный массив

Частоты, соответствующие элементам в spectrum

line: a Line2D instance

Линия, созданная этой функцией

Ключевые слова kwargs управляют свойствами Line2D:

Свойство	Описание
agg_filter	неизвестно
alpha	вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated	[True | False]
antialiased или aa	[True | False]
axes	экземпляр Axes
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’ | (смещение, последовательность on-off-dash) | '-' | '--' | '-.' | ':' | '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 | срез | список/массив целых чисел | вещественное число | пара вещественных чисел длиной 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	любое число

Пример:

(Исходный код, png, hires.png, pdf)

См. также

magnitude_spectrum()

angle_spectrum() отображает величины соответствующих частот.

phase_spectrum()

phase_spectrum() отображает развёрнутую версию этой функции.

specgram()

specgram() может отображать спектр фаз сегментов сигнала в цветовой карте.

Примечания

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

• Все аргументы с такими именами: ‘x’.

Дополнительные ключевые слова: hold = [True|False] переопределяет состояние удержания по умолчанию

matplotlib.pyplot.annotate(*args, **kwargs)

Добавляет аннотацию к точке xy с текстом s.

Дополнительные ключевые слова передаются в Text.

Параметры:

s : str Текст аннотации xy : итерируемый объект Последовательность длиной 2, определяющая точку (x,y) для аннотации xytext : итерируемый объект, необязательно Последовательность длиной 2, определяющая точку (x,y) для размещения текста. Если None, по умолчанию xy. xycoords : str, элемент, преобразование, вызываемый объект или кортеж, необязательно Система координат, в которой задана xy. Для str допустимые значения: Свойство Описание ‘figure points’ точки от нижнего левого угла фигуры ‘figure pixels’ пиксели от нижнего левого угла фигуры ‘figure fraction’ доля фигуры от нижнего левого угла ‘axes points’ точки от нижнего левого угла осей ‘axes pixels’ пиксели от нижнего левого угла осей ‘axes fraction’ доля осей от нижнего левого угла ‘data’ использование системы координат объекта, к которому добавляется аннотация (по умолчанию) ‘polar’ (theta,r) если не родные координаты ‘data’ Если передан объект Artist, единицы измерения — доля от его области. Если передан объект Transform, используйте его для преобразования xy в экранные координаты Если передан вызываемый объект, он должен принимать объект RendererBase в качестве входных данных и возвращать объект Transform или Bbox Если tuple должно быть кортежем длиной 2 из str, Artist, Transform или вызываемых объектов. Первое преобразование используется для координаты x, а второе для y. См. Добавление аннотаций к осям для получения более подробной информации. По умолчанию 'data' textcoords : str, Artist, Transform, вызываемый объект или кортеж, необязательно Система координат, в которой задан xytext и которая может отличаться от системы координат, используемой для xy. Все xycoords значения допустимы, а также следующие строки: Свойство Описание ‘offset points’ смещение (в пунктах) от значения xy ‘offset pixels’ смещение (в пикселях) от значения xy По умолчанию значение xycoords arrowprops : dict, необязательно Если не None, свойства, используемые для рисования стрелки FancyArrowPatch между xy и xytext. Если arrowprops не содержит ключ 'arrowstyle', разрешённые ключи: Ключ Описание width ширина стрелки в пунктах headwidth ширина основания головки стрелки в пунктах headlength длина головки стрелки в пунктах shrink доля общей длины, на которую стрелка «сжимается» с обоих концов ? любой ключ для matplotlib.patches.FancyArrowPatch Если arrowprops содержит ключ 'arrowstyle', вышеперечисленные ключи запрещены. Допустимые значения 'arrowstyle': Имя Атрибуты Допустимые ключи для FancyArrowPatch: Ключ Описание По умолчанию None annotation_clip : bool, необязательно Управляет видимостью аннотации, когда она выходит за область осей. Если True, аннотация будет отображаться только тогда, когда xy находится внутри осей. Если False, аннотация всегда будет отображаться независимо от её положения. По умолчанию None, которое ведёт себя как True только если xycoords — “data”.

Возвращает:

Аннотация

matplotlib.pyplot.arrow(x, y, dx, dy, hold=None, **kwargs)

Добавление стрелки на ось.

Вызов:

arrow(x, y, dx, dy, **kwargs)

Рисует стрелку на указанной оси от (x, y) до (x + dx, y + dy). Использует объект FancyArrow для построения стрелки.

Результат стрелки зависит от соотношения сторон и пределов осей. Это может привести к стрелке, головка которой не квадратная по отношению к стволу. Для создания стрелки, головка которой квадратная по отношению к стволу, используйте annotate(), например:

ax.annotate("", xy=(0.5, 0.5), xytext=(0, 0),
    arrowprops=dict(arrowstyle="->"))

Необязательные параметры kwargs управляют построением и свойствами стрелки:

Аргументы конструктора

width: float (по умолчанию: 0.001)

ширина хвоста стрелки

length_includes_head: [True | False] (по умолчанию: False)

True, если головка учитывается при вычислении длины.

head_width: float или None (по умолчанию: 3*width)

общая ширина головки стрелки

head_length: float или None (по умолчанию: 1.5 * head_width)

длина головки стрелки

shape: [‘full’, ‘left’, ‘right’] (по умолчанию: ‘full’)

рисование левой половины, правой половины или полной стрелки

overhang: float (по умолчанию: 0)

дробная часть, на которую стрелка отклоняется назад (0 означает треугольную форму). Может быть отрицательным или больше единицы.

head_starts_at_zero: [True | False] (по умолчанию: False)

если True, головка начинается с координаты 0, вместо того чтобы заканчиваться на координате 0.

Другие допустимые kwargs (унаследованные от Patch):

Свойство	Описание
agg_filter	неизвестно
alpha	float или None
animated	[True | False]
antialiased или aa	[True | False] или None для значения по умолчанию
axes	объект Axes
capstyle	[‘butt’ | ‘round’ | ‘projecting’]
clip_box	объект matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
color	спецификация цвета matplotlib
contains	вызываемая функция
edgecolor или ec	спецификация цвета mpl, или None для значения по умолчанию, или ‘none’ для отсутствия цвета
facecolor или fc	спецификация цвета mpl, или None для значения по умолчанию, или ‘none’ для отсутствия цвета
figure	объект matplotlib.figure.Figure
fill	[True | False]
gid	строка идентификатора
hatch	[‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
label	строка или что-то выводимое с помощью преобразования ‘%s’.
linestyle или ls	[‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (смещение, последовательность выкл.-вкл.-пунктир) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	число с плавающей точкой или None для значения по умолчанию
path_effects	неизвестно
picker	[None|число с плавающей точкой|логическое значение|вызываемая функция]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	объект Transform
url	строка url
visible	[True | False]
zorder	любое число

Пример:

(Исходный код, png, hires.png, pdf)

Дополнительные параметры kwargs: hold = [True|False] переопределяет состояние удержания по умолчанию

matplotlib.pyplot.autoscale(enable=True, axis='both', tight=None)

Автомасштабирование осей к данным (переключение).

Удобный метод для простого автоматического масштабирования области отображения осей. Он включает или выключает автоматическое масштабирование, а затем, если автоматическое масштабирование включено для любой оси, выполняет масштабирование по указанной оси или осям.

enable: [True | False | None]

True (по умолчанию) включает автоматическое масштабирование, False — выключает. None оставляет состояние автоматического масштабирования неизменным.

axis: [‘x’ | ‘y’ | ‘both’]

которая ось должна быть обработана; по умолчанию — ‘both’

tight: [True | False | None]

Если True, устанавливает пределы отображения на пределы данных; если False, позволяет локатору и отступам расширить пределы отображения; если None, использует плотное масштабирование, если единственный элемент — изображение, иначе обрабатывает tight как False. Настройка tight сохраняется для последующего автоматического масштабирования до ее явного изменения.

Возвращает None.

matplotlib.pyplot.autumn()

Устанавливает цветовую карту по умолчанию на autumn и применяет её к текущему изображению, если таковое имеется. Смотрите справку (colormaps) для получения дополнительной информации

matplotlib.pyplot.axes(*args, **kwargs)

Добавление области осей к рисунку.

Область осей добавляется в положение rect, определяемое:

• axes() само по себе создаёт область осей по умолчанию, занимающую всё subplot(111) окно.
• axes(rect, axisbg='w') где rect = [left, bottom, width, height] в нормированных единицах (0, 1). axisbg — цвет фона осей, по умолчанию белый.
• axes(h) где h — экземпляр области осей, делает h текущей осью. Возвращается экземпляр Axes.

kwarg	Принимает	Описание
axisbg	цвет	цвет фона области осей
frameon	[True|False]	отображать рамку?
sharex	otherax	текущая область осей разделяет атрибут оси x с otherax
sharey	otherax	текущая область осей разделяет атрибут оси y с otherax
polar	[True|False]	использовать полярную систему координат?
aspect	[str | num]	[‘equal’, ‘auto’] или число. Если число, то отношение x-единиц/y-единиц в пространстве экрана. Также см. set_aspect().

Примеры:

• examples/pylab_examples/axes_demo.py размещает пользовательскую область осей.
• examples/pylab_examples/shared_axis_demo.py использует sharex и sharey.

matplotlib.pyplot.axhline(y=0, xmin=0, xmax=1, hold=None, **kwargs)

Добавление горизонтальной линии через ось.

Параметры:	y : скаляр, необязательно, по умолчанию: 0 Положение y в координатах данных горизонтальной линии. xmin : скаляр, необязательно, по умолчанию: 0 Должно быть между 0 и 1, 0 — крайняя левая часть графика, 1 — крайняя правая часть графика. xmax : скаляр, необязательно, по умолчанию: 1 Должно быть между 0 и 1, 0 — крайняя левая часть графика, 1 — крайняя правая часть графика.
Возвращает:	Line2D

См. также

axhspan

для примера построения и исходного кода

Additional

Примечания

Аргументы kwargs передаются в Line2D и могут использоваться для управления свойствами линии.

Примеры

• нарисовать толстую красную горизонтальную линию в ‘y’ = 0, охватывающую диапазон значений x:

  >>> axhline(linewidth=4, color='r')
  

• нарисовать горизонтальную линию по умолчанию в ‘y’ = 1, охватывающую диапазон значений x:

  >>> axhline(y=1)
  

• нарисовать горизонтальную линию по умолчанию в ‘y’ = .5, охватывающую среднюю половину диапазона значений x:

  >>> axhline(y=.5, xmin=0.25, xmax=0.75)
  

Допустимые значения kwargs — свойства Line2D, за исключением ‘transform’:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated	[True | False]
antialiased или aa	[True | False]
axes	экземпляр Axes
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	расстояние в точках или вызываемая функция pick 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	любое число

matplotlib.pyplot.axhspan(ymin, ymax, xmin=0, xmax=1, hold=None, **kwargs)

Добавить горизонтальный отрезок (прямоугольник) на оси.

Вызов:

axhspan(ymin, ymax, xmin=0, xmax=1, **kwargs)

Координаты y заданы в единицах данных, а x — в единицах осей (относительные, от 0 до 1).

Отобразить горизонтальный отрезок (прямоугольник) от ymin до ymax. При значениях по умолчанию xmin = 0 и xmax = 1, он всегда охватывает весь диапазон значений x, независимо от настроек xlim, даже если вы их измените, например, с помощью команды set_xlim() . То есть, горизонтальная протяжённость задаётся в координатах осей: 0=слева, 0.5=посередине, 1.0=справа, а положение y — в координатах данных.

Возвращаемое значение — экземпляр matplotlib.patches.Polygon.

Примеры:

• Отобразить серую прямоугольную область от y = 0.25 до 0.75, которая охватывает весь горизонтальный диапазон осей:

  >>> axhspan(0.25, 0.75, facecolor='0.5', alpha=0.5)
  

Допустимые ключевые параметры — свойства Polygon:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой или None
animated	[True | False]
antialiased или aa	[True | False] или None по умолчанию
axes	экземпляр Axes
capstyle	[‘butt’ | ‘round’ | ‘projecting’]
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
color	спецификация цвета matplotlib
contains	функция-вызов
edgecolor или ec	спецификация цвета mpl, или None по умолчанию, или ‘none’ для отсутствия цвета
facecolor или fc	спецификация цвета mpl, или None по умолчанию, или ‘none’ для отсутствия цвета
figure	экземпляр matplotlib.figure.Figure
fill	[True | False]
gid	строка-идентификатор
hatch	[‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
label	строка или что-то, что можно распечатать с помощью преобразования ‘%s’
linestyle или ls	[‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (смещение, последовательность on-off-dash) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	число с плавающей точкой или None по умолчанию
path_effects	неизвестно
picker	[None|число с плавающей точкой|булево значение|функция-вызов]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка-URL
visible	[True | False]
zorder	любое число

Пример:

(Исходный код, png, hires.png, pdf)

Дополнительные ключевые параметры: hold = [True|False] переопределяет состояние hold по умолчанию

matplotlib.pyplot.axis(*v, **kwargs)

Удобный метод для получения или установки свойств осей.

Вызов без аргументов:

>>> axis()

возвращает текущие пределы осей [xmin, xmax, ymin, ymax].:

>>> axis(v)

устанавливает минимальные и максимальные значения осей x и y, с v = [xmin, xmax, ymin, ymax].:

>>> axis('off')

отключает линии и метки осей.:

>>> axis('equal')

изменяет пределы осей x или y таким образом, чтобы равные приращения x и y имели одинаковую длину; окружность является круговой.:

>>> axis('scaled')

достигает того же результата, изменяя размеры области графика вместо пределов данных осей.:

>>> axis('tight')

изменяет пределы осей x и y таким образом, чтобы все данные были показаны. Если все данные уже отображаются, он переместит их в центр фигуры без изменения (xmax - xmin) или (ymax - ymin). Обратите внимание, что это немного отличается от MATLAB.:

>>> axis('image')

масштабируется с пределами осей, равными пределам данных.:

>>> axis('auto')

и:

>>> axis('normal')

устарели. Они восстанавливают стандартное поведение; пределы осей автоматически масштабируются, чтобы данные удобно помещались в область графика.

если len(*v)==0, вы можете передать xmin, xmax, ymin, ymax в качестве аргументов ключевого слова, чтобы выборочно изменить только эти пределы, не изменяя другие.

>>> axis('square')

изменяет диапазоны пределов (xmax-xmin) и (ymax-ymin) осей x и y таким образом, чтобы они были одинаковыми и имели одинаковое масштабирование, что приводит к квадратному графику.

Возвращается кортеж (xmin, xmax, ymin, ymax).

См. также

xlim(), ylim()

Для установки пределов x и y по отдельности.

matplotlib.pyplot.axvline(x=0, ymin=0, ymax=1, hold=None, **kwargs)

Добавление вертикальной линии по оси.

Параметры:	x : скаляр, необязательно, по умолчанию: 0 Позиция x в координатах данных вертикальной линии. ymin : скаляр, необязательно, по умолчанию: 0 Должно быть между 0 и 1, 0 — нижняя часть графика, 1 — верхняя. ymax : скаляр, необязательно, по умолчанию: 1 Должно быть между 0 и 1, 0 — нижняя часть графика, 1 — верхняя.
Возвращает:	Line2D

См. также

axhspan

для примера построения и исходного кода

Additional

Примеры

• нарисовать толстую красную вертикальную линию в точке x = 0, охватывающую весь диапазон y:

  >>> axvline(linewidth=4, color='r')
  

• нарисовать стандартную вертикальную линию в точке x = 1, охватывающую весь диапазон y:

  >>> axvline(x=1)
  

• нарисовать стандартную вертикальную линию в точке x = 0,5, охватывающую среднюю половину диапазона y:

  >>> axvline(x=.5, ymin=0.25, ymax=0.75)
  

Допустимые аргументы ключевого слова — свойства Line2D, за исключением ‘transform’:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated	[True | False]
antialiased или aa	[True | False]
axes	экземпляр Axes
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	любое число

matplotlib.pyplot.axvspan(xmin, xmax, ymin=0, ymax=1, hold=None, **kwargs)

Добавить вертикальную область (прямоугольник) на оси.

Вызов:

axvspan(xmin, xmax, ymin=0, ymax=1, **kwargs)

Координаты x задаются в единицах данных, а координаты y — в единицах осей (относительные единицы от 0 до 1).

Отобразить вертикальную область (прямоугольник) от xmin до xmax. С значениями по умолчанию ymin = 0 и ymax = 1, эта область всегда охватывает диапазон значений y, независимо от настроек ylim, даже если вы их измените, например, с помощью команды set_ylim(). То есть, вертикальное положение задаётся в единицах осей: 0=нижняя часть, 0,5=середина, 1,0=верхняя часть, но положение по y задаётся в единицах данных.

Возвращаемое значение — экземпляр matplotlib.patches.Polygon.

Примеры:

• нарисовать вертикальный зелёный полупрозрачный прямоугольник от x=1,25 до 1,55, который охватывает весь диапазон значений y на осях:

  >>> axvspan(1.25, 1.55, facecolor='g', alpha=0.5)
  

Допустимые аргументы kwargs — свойства Polygon:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей запятой или None
animated	[True | False]
antialiased или aa	[True | False] или None по умолчанию
axes	экземпляр Axes
capstyle	[‘butt’ | ‘round’ | ‘projecting’]
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
color	спецификация цвета matplotlib
contains	вызываемая функция
edgecolor или ec	спецификация цвета mpl, или None по умолчанию, или ‘none’ для отсутствия цвета
facecolor или fc	спецификация цвета mpl, или None по умолчанию, или ‘none’ для отсутствия цвета
figure	экземпляр matplotlib.figure.Figure
fill	[True | False]
gid	строка-идентификатор
hatch	[‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
label	строка или любой печатаемый объект с преобразованием ‘%s’
linestyle или ls	[‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (offset, on-off-dash-seq) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	число с плавающей запятой или None по умолчанию
path_effects	неизвестно
picker	[None|число с плавающей запятой|логическое значение|вызываемая функция]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка URL
visible	[True | False]
zorder	любое число

См. также

axhspan()

для примера кода и графика

Дополнительные аргументы kwargs: hold = [True|False] переопределяет состояние hold по умолчанию

matplotlib.pyplot.bar(left, height, width=0.8, bottom=None, hold=None, data=None, **kwargs)

Построение гистограммы.

Построение гистограммы с прямоугольниками, ограниченными:

left, left + width, bottom, bottom + height

(левыми, правыми, нижними и верхними границами)

Параметры:

left : последовательность скаляров координаты x левых границ столбцов height : последовательность скаляров высоты столбцов width : скаляр или массив, необязательно ширина(ы) столбцов по умолчанию: 0.8 bottom : скаляр или массив, необязательно координата(ы) y столбцов по умолчанию: None color : скаляр или массив, необязательно цвета граней столбцов edgecolor : скаляр или массив, необязательно цвета границ столбцов linewidth : скаляр или массив, необязательно ширина(ы) границ столбцов. Если None, используется значение по умолчанию; Если 0, границы не рисуются. По умолчанию: None tick_label : строка или массив, необязательно метки делений столбцов по умолчанию: None xerr : скаляр или массив, необязательно если не None, используется для построения погрешности(ей) на графике столбцов по умолчанию: None yerr : скаляр или массив, необязательно если не None, используется для построения погрешности(ей) на графике столбцов по умолчанию: None ecolor : скаляр или массив, необязательно устанавливает цвет погрешности(ей) по умолчанию: None capsize : скаляр, необязательно определяет длину в точках колпачков погрешности(ей) по умолчанию: None, которое будет взято из значения errorbar.capsize rcParam. error_kw : словарь, необязательно словарь аргументов kwargs, которые будут переданы методу errorbar. ecolor и capsize могут быть указаны здесь вместо независимых аргументов kwargs. align : {‘edge’, ‘center’}, необязательно Если ‘edge’, выравнивает столбцы по левым краям (для вертикальных столбцов) и по нижним краям (для горизонтальных столбцов). Если ‘center’, интерпретирует аргумент left как координаты центров столбцов. Для выравнивания по правому краю передайте отрицательное значение width. orientation : {‘vertical’, ‘horizontal’}, необязательно Ориентация столбцов. log : boolean, необязательно Если True, устанавливает масштаб оси в логарифмический. По умолчанию: False

Возвращает:

bars : matplotlib.container.BarContainer Контейнер со всеми столбцами + погрешностями

См. также

barh

Построение горизонтальной гистограммы.

Примечания

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

• Все аргументы с именами: ‘linewidth’, ‘bottom’, ‘yerr’, ‘height’, ‘xerr’, ‘edgecolor’, ‘tick_label’, ‘color’, ‘left’, ‘width’, ‘ecolor’.

Дополнительные kwargs: hold = [True|False] переопределяет состояние hold по умолчанию

Примеры

Пример: Сгруппированная гистограмма.

(Исходный код, png, hires.png, pdf)

matplotlib.pyplot.barbs(*args, **kw)

Построение 2-мерного поля барбов.

Подписи вызова:

barb(U, V, **kw)
barb(U, V, C, **kw)
barb(X, Y, U, V, **kw)
barb(X, Y, U, V, C, **kw)

Аргументы:

X, Y:

Координаты x и y положений барбов (по умолчанию это головка барба; см. аргумент pivot)

U, V:

Компоненты x и y оси барба

C:

Дополнительный массив, используемый для отображения цветов барбов

Все аргументы могут быть 1-мерными или 2-мерными массивами или последовательностями. Если X и Y отсутствуют, они будут сгенерированы как равномерная сетка. Если U и V являются 2-мерными массивами, но X и Y - 1-мерными, и если len(X) и len(Y) соответствуют размерности столбцов и строк U, то X и Y будут расширены с numpy.meshgrid().

U, V, C могут быть масками, но маскированные X, Y в настоящее время не поддерживаются.

Аргументы ключевых слов:

length:

Длина барба в пунктах; остальные части барба масштабируются относительно этого значения. По умолчанию 9

pivot: [ ‘tip’ | ‘middle’ ]

Часть стрелки, которая находится в точке сетки; стрелка вращается вокруг этой точки, откуда и происходит название pivot. По умолчанию ‘tip’

barbcolor: [ цвет | последовательность цветов ]

Устанавливает цвет всех частей барба, кроме флагов. Этот параметр аналогичен параметру edgecolor для полигонов, который можно использовать вместо него. Однако этот параметр переопределит facecolor.

flagcolor: [ цвет | последовательность цветов ]

Устанавливает цвет флагов на барбе. Этот параметр аналогичен параметру facecolor для полигонов, который можно использовать вместо него. Однако этот параметр переопределит facecolor. Если этот параметр не установлен (и C также не установлен), то flagcolor будет установлен в соответствии с barbcolor, так что барб будет иметь одинаковый цвет. Если C установлен, flagcolor не оказывает влияния.

sizes:

Словарь коэффициентов, определяющих отношение данного элемента к длине барба. Нужно включать только те значения, которые нужно переопределить. Эти элементы включают:

• ‘spacing’ - расстояние между элементами (флагами, полными/полуполными барбами)
• ‘height’ - высота (расстояние от оси до вершины) флага или полной барбы
• ‘width’ - ширина флага, вдвое ширина полной барбы
• ‘emptybarb’ - радиус круга, используемого для малых величин

fill_empty:

Флаг, указывающий, должны ли быть заполнены пустые барбы (кружки), которые выводятся, цветом флага. Если они не заполнены, они будут выведены без применения цвета к центру. По умолчанию False

rounding:

Флаг, указывающий, следует ли округлять величину вектора при назначении компонентов барба. Если True, величина округляется до ближайшего кратного половины значения барба. Если False, величина просто усекается до следующего меньшего кратного. По умолчанию True

barb_increments:

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

• ‘half’ - полубарбы (по умолчанию 5)
• ‘full’ - целые барбы (по умолчанию 10)
• ‘flag’ - флаги (по умолчанию 50)

flip_barb:

Либо один булевый флаг, либо массив булевых значений. Один булевый флаг указывает, должны ли линии и флаги указывать на противоположную сторону для всех барбов. Массив (который должен быть того же размера, что и другие массивы данных) указывает, следует ли переворачивать для каждого отдельного барба. Нормальное поведение заключается в том, что барбы и линии указывают вправо (это следует из того, что барбы ветра в Северном полушарии указывают на низкое давление).

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

:     /\    \
:    /  \    \
:   /    \    \    \
:  /      \    \    \
: ------------------------------

Наибольшее приращение задается треугольником (или «флагом»). После них идут целые линии (барбы). Наименьшее приращение - это половина линии. Естественно, всегда может быть не более одной половины линии. Если величина мала и требуется только одна половина линии, без целых линий или треугольников, то половина линии смещена от конца барба, чтобы ее можно было легко отличить от барбов с одной целой линией. Величина для показанного выше барба номинально равна 65, используя стандартные приращения 50, 10 и 5.

linewidths и edgecolors могут быть использованы для настройки барба. Дополнительные PolyCollection аргументы ключевых слов:

Свойство	Описание
agg_filter	неизвестно
alpha	float или None
animated	[True | False]
antialiased или antialiaseds	Булево значение или последовательность булевых значений
array	неизвестно
axes	экземпляр Axes
clim	последовательность из двух чисел с плавающей точкой
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ ( Path, Transform) | Patch | None ]
cmap	палитра цветов или зарегистрированное имя палитры
color	аргумент цвета matplotlib или последовательность кортежей rgba
contains	вызываемая функция
edgecolor или edgecolors	спецификация цвета matplotlib или последовательность спецификаций
facecolor или facecolors	спецификация цвета matplotlib или последовательность спецификаций
figure	экземпляр matplotlib.figure.Figure
gid	строка-идентификатор
hatch	[ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]
label	строка или любой печатаемый объект с преобразованием ‘%s’
linestyle или linestyles или dashes	[‘сплошная’ | ‘пунктирная’, ‘пунктирная с точками’, ‘точковая’ | (смещение, последовательность вкл/выкл штрихов) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	неизвестно
offset_position	неизвестно
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	неизвестно
picker	[None|число с плавающей точкой|булево|вызываемая функция]
pickradius	неизвестно
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка url
urls	неизвестно
visible	[True | False]
zorder	любое число

Пример:

(Исходный код)

(png, hires.png, pdf)

(png, hires.png, pdf)

Примечания

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

• Все позиционные и все ключевые аргументы.

Дополнительные ключевые аргументы: hold = [True|False] переопределяет состояние hold по умолчанию

matplotlib.pyplot.barh(bottom, width, height=0.8, left=None, hold=None, **kwargs)

Построение горизонтальной диаграммы.

Построение горизонтальной диаграммы с прямоугольниками, ограниченными:

left, left + width, bottom, bottom + height

(левыми, правыми, нижними и верхними границами)

bottom, width, height, и left могут быть скалярами или последовательностями.

Параметры:	bottom : скаляр или последовательность координата(ы) y столбцов width : скаляр или последовательность ширина(ы) столбцов height : последовательность скаляров, необязательно, по умолчанию: 0.8 высота(ы) столбцов left : последовательность скаляров координаты x левых границ столбцов
Возвращаемое значение:	matplotlib.patches.Rectangle экземпляры.
Другие параметры:
	color : скаляр или последовательность, необязательно цвета столбцов edgecolor : скаляр или последовательность, необязательно цвета границ столбцов linewidth : скаляр или последовательность, необязательно, по умолчанию: None ширина границ столбцов. Если None, используется значение по умолчанию; Если 0, границы не выводятся. tick_label : строка или последовательность, необязательно, по умолчанию: None метки столбцов xerr : скаляр или последовательность, необязательно, по умолчанию: None если не None, используется для построения погрешностей по оси x yerr : скаляр или последовательность, необязательно, по умолчанию: None если не None, используется для построения погрешностей по оси y ecolor : скаляр или последовательность, необязательно, по умолчанию: None устанавливает цвет погрешностей capsize : скаляр, необязательно определяет длину колпачков погрешностей в пунктах по умолчанию: None, в этом случае используется значение из errorbar.capsize rcParam. error_kw : словарь kwargs, передаваемых в метод errorbar. ecolor и capsize могут быть указаны здесь, а не как отдельные kwargs. align : [‘edge’ | ‘center’], необязательно, по умолчанию: ‘edge’ Если edge, выравнивает столбцы по левым границам (для вертикальных столбцов) и по нижним границам (для горизонтальных столбцов). Если center, интерпретирует значение left как координаты центров столбцов. log : boolean, необязательно, по умолчанию: False Если True, устанавливает масштаб оси в логарифмический

См. также

bar

Построение вертикальной диаграммы.

Additional

Примечания

Дополнительные необязательные аргументы color, edgecolor, linewidth, xerr, и yerr могут быть скалярами или последовательностями длиной, равной количеству столбцов. Это позволяет использовать bar в качестве основы для построения столбчатых диаграмм или свечных графиков. Подробности: xerr и yerr передаются напрямую в errorbar(), поэтому они также могут иметь форму 2xN для независимого задания нижних и верхних погрешностей.

Другие необязательные kwargs:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой или None
animated	[True | False]
antialiased или aa	[True | False] или None для значения по умолчанию
axes	экземпляр Axes
capstyle	[‘butt’ | ‘round’ | ‘projecting’]
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
color	спецификация цвета matplotlib
contains	вызываемая функция
edgecolor или ec	спецификация цвета mpl, или None для значения по умолчанию, или ‘none’ для отсутствия цвета
facecolor или fc	спецификация цвета mpl, или None для значения по умолчанию, или ‘none’ для отсутствия цвета
figure	экземпляр matplotlib.figure.Figure
fill	[True | False]
gid	строка-идентификатор
hatch	[‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
label	строка или любой объект, отображаемый с помощью преобразования ‘%s’
linestyle или ls	[‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (смещение, последовательность выкл.-вкл.) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	число с плавающей точкой или None для значения по умолчанию
path_effects	неизвестно
picker	[None|число с плавающей точкой|логическое значение|вызываемая функция]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка URL
visible	[True | False]
zorder	любое число

matplotlib.pyplot.bone()

устанавливает по умолчанию цветовую карту bone и применяет её к текущему изображению, если таковое имеется. Смотрите справку по цветовым картам для получения дополнительной информации

matplotlib.pyplot.box(on=None)

Включает или отключает рамку осей. on может быть булевым значением или строкой ‘on’ или ‘off’.

Если on имеет значение None, то состояние будет переключено.

matplotlib.pyplot.boxplot(x, notch=None, sym=None, vert=None, whis=None, positions=None, widths=None, patch_artist=None, bootstrap=None, usermedians=None, conf_intervals=None, meanline=None, showmeans=None, showcaps=None, showbox=None, showfliers=None, boxprops=None, labels=None, flierprops=None, medianprops=None, meanprops=None, capprops=None, whiskerprops=None, manage_xticks=True, hold=None, data=None)

Построение диаграммы размаха.

Вызов:

boxplot(self, x, notch=None, sym=None, vert=None, whis=None,
        positions=None, widths=None, patch_artist=False,
        bootstrap=None, usermedians=None, conf_intervals=None,
        meanline=False, showmeans=False, showcaps=True,
        showbox=True, showfliers=True, boxprops=None,
        labels=None, flierprops=None, medianprops=None,
        meanprops=None, capprops=None, whiskerprops=None,
        manage_xticks=True, autorange=False):

Построение диаграммы размаха для каждого столбца x или каждого вектора в последовательности x. Прямоугольник диаграммы размаха охватывает значения от нижнего до верхнего квартиля данных, с линией, указывающей медиану. Усы диаграммы размаха охватывают диапазон данных. Точки-выбросы - это значения, выходящие за пределы усов.

Параметры:	x : Массив или последовательность векторов. Входные данные. notch : bool, необязательно (False) Если True, будет построена диаграмма размаха с выемкой. В противном случае строится прямоугольная диаграмма размаха. sym : str, необязательно Символ по умолчанию для точек-выбросов. Введите пустую строку (‘’) если не хотите отображать точки-выбросы. Если None, то точки-выбросы будут по умолчанию ‘b+’. Для большего контроля используйте параметр flierprops. vert : bool, необязательно (True) Если True (по умолчанию), ящики строятся вертикально. Если False, все элементы строятся горизонтально. whis : float, последовательность или строка (по умолчанию = 1.5) В качестве числа определяет расстояние усов за пределами первого и третьего квартилей (например, Q3 + whis*IQR, IQR = межквартильный размах, Q3-Q1). Значения данных за пределами усов считаются выбросами и отображаются как отдельные точки. Установите это значение в нереально большое значение, чтобы принудительно показать усы от минимального до максимального значения. Также можно установить последовательность процентилей (например, [5, 95]) для установки усов в определенных процентилях данных. Наконец, whis может быть строкой 'range' для принудительного отображения усов от минимального до максимального значения данных. bootstrap : int, необязательно Указывает, следует ли использовать бутстрап для вычисления доверительных интервалов вокруг медианы для диаграмм размаха с выемкой. Если bootstrap равно None, бутстрап не используется, и выемки вычисляются с помощью асимптотического приближения, основанного на нормальном распределении (см. McGill, R., Tukey, J.W., and Larsen, W.A., 1978, и Kendall и Stuart, 1967). В противном случае bootstrap указывает количество повторений бутстрапа для определения 95%-ного доверительного интервала медианы. Рекомендуются значения от 1000 до 10000. usermedians : массив, необязательно Массив или последовательность, первая размерность (или длина) которой совместима с x. Это переопределяет медианы, вычисленные matplotlib для каждого элемента usermedians, который не None. Если элемент usermedians равен None, медиана будет вычислена matplotlib стандартным способом. conf_intervals : массив, необязательно Массив или последовательность, первая размерность (или длина) которой совместима с x и вторая размерность которой равна 2. Если элемент conf_intervals не равен None, позиции выемок, вычисленные matplotlib, будут переопределены (при условии, что notch равно True). Если элемент conf_intervals равен None, выемки вычисляются методом, указанным другими параметрами (например, bootstrap). positions : массив, необязательно Устанавливает положение ящиков. Деления и пределы автоматически настраиваются для соответствия положению. По умолчанию range(1, N+1) где N - количество диаграмм размаха. widths : число или массив Устанавливает ширину каждого ящика, используя число или последовательность. По умолчанию 0,5 или 0.15*(distance between extreme positions), если это значение меньше. patch_artist : bool, необязательно (False) Если False строит ящики с помощью объекта Line2D. В противном случае ящики строятся с помощью объектов Patch. labels : последовательность, необязательно Метки для каждого набора данных. Длина должна соответствовать размерности x. manage_xticks : bool, необязательно (True) Если функция должна настраивать xlim и xtick-положения. autorange : bool, необязательно (False) Когда True и данные распределены так, что 25-й и 75-й процентили равны, whis устанавливается в 'range', чтобы концы усов были равны минимальному и максимальному значениям данных. meanline : bool, необязательно (False) Если True (и showmeans равно True), будет пытаться отобразить среднее значение как линию, охватывающую всю ширину ящика в соответствии с meanprops (см. ниже). Не рекомендуется, если shownotches также равно True. В противном случае средние значения будут отображаться как точки.
Возвращает:	result : словарь Словарь, сопоставляющий каждый компонент диаграммы размаха с списком созданных matplotlib.lines.Line2D экземпляров. Этот словарь имеет следующие ключи (при вертикальном построении диаграмм размаха): boxes: основная часть диаграммы размаха, показывающая квартили и доверительные интервалы медианы, если включены. medians: горизонтальные линии в медиане каждого ящика. whiskers: вертикальные линии, простирающиеся до наиболее экстремальных, не являющихся выбросами точек данных. caps: горизонтальные линии в конце усов. fliers: точки, представляющие данные, выходящие за пределы усов (выбросы). means: точки или линии, представляющие средние значения.
Другие параметры:
	Следующие булевы параметры переключают отображение отдельных компонентов диаграмм размаха: showcaps: концы усов (по умолчанию True) showbox: центральный ящик (по умолчанию True) showfliers: точки-выбросы за пределами усов (по умолчанию True) showmeans: средние арифметические значения (по умолчанию False) Остальные параметры могут принимать словари, которые задают стиль отдельных графических элементов: capprops boxprops whiskerprops flierprops medianprops meanprops

Примечания

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

• Все позиционные и все ключевые аргументы.

Дополнительные параметры: hold = [True|False] переопределяет состояние hold по умолчанию

Примеры

(Исходный код, png, hires.png, pdf)

(png, hires.png, pdf)

matplotlib.pyplot.broken_barh(xranges, yrange, hold=None, data=None, **kwargs)

Строить горизонтальные столбцы.

Вызов:

broken_barh(self, xranges, yrange, **kwargs)

Коллекция горизонтальных столбцов, охватывающих yrange с последовательностью xranges.

Обязательные аргументы:

Аргумент	Описание
xranges	последовательность (xmin, xwidth)
yrange	последовательность (ymin, ywidth)

параметры kwargs являются свойствами matplotlib.collections.BrokenBarHCollection:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой или None
animated	[True | False]
antialiased или antialiaseds	Булево значение или последовательность булевых значений
array	неизвестно
axes	экземпляр Axes
clim	последовательность длиной 2 из чисел с плавающей точкой
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
cmap	карта цветов или зарегистрированное имя карты цветов
color	аргумент цвета matplotlib или последовательность кортежей rgba
contains	вызываемая функция
edgecolor или edgecolors	спецификация цвета matplotlib или последовательность спецификаций
facecolor или facecolors	спецификация цвета matplotlib или последовательность спецификаций
figure	экземпляр matplotlib.figure.Figure
gid	строка идентификатора
hatch	[ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]
label	строка или любой печатаемый объект с преобразованием «%s»
linestyle или linestyles или dashes	[‘сплошная’ | ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ | (смещение, последовательность включений/выключений) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	неизвестно
offset_position	неизвестно
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	неизвестно
picker	[None|число с плавающей точкой|булево значение|вызываемая функция]
pickradius	неизвестно
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка url
urls	неизвестно
visible	[True | False]
zorder	любое число

эти значения могут быть либо одним аргументом, например:

facecolors = 'black'

или последовательностью аргументов для различных столбцов, например:

facecolors = ('black', 'red', 'green')

Пример:

(Исходный код, png, hires.png, pdf)

Примечания

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

• Все позиционные и все ключевые аргументы.

Дополнительные параметры kwargs: hold = [True|False] переопределяет состояние удержания по умолчанию

matplotlib.pyplot.cla()

Очистить текущую ось.

matplotlib.pyplot.clabel(CS, *args, **kwargs)

Подписать контурный график.

Вызов:

clabel(cs, **kwargs)

Добавляет подписи к линиям контура в cs, где cs — объект ContourSet, возвращённый методом contour.

clabel(cs, v, **kwargs)

отображаются только контуры, указанные в v.

Дополнительные ключевые аргументы:

fontsize:

размер в пунктах или относительный размер, например, ‘smaller’, ‘x-large’

colors:

• если None, цвет каждой подписи соответствует цвету соответствующего контура
• если строка цвета, например, colors = ‘r’ или colors = ‘red’, все подписи будут отображаться в этом цвете
• если кортеж аргументов цвета matplotlib (строка, число с плавающей запятой, rgb и т. д.), разные подписи будут отображаться в разных цветах в указанном порядке

inline:

управляет удалением или сохранением подлежащего контура. По умолчанию True.

inline_spacing:

расстояние в пикселях с каждой стороны подписи при размещении в строку. По умолчанию 5. Это расстояние будет точным для подписей в местах, где контур прямой, меньше для подписей на криволинейных контурах.

fmt:

строковый формат для подписи. По умолчанию ‘%1.3f’. Также может быть словарем, сопоставляющим уровни контура произвольным строкам для каждого уровня контура (т. е., fmt[уровень]=строка), или любым вызываемым объектом, таким как экземпляр Formatter, который возвращает строку при вызове с числовым уровнем контура.

manual:

если True, подписи контура будут размещаться вручную с помощью щелчков мыши. Нажмите первую кнопку рядом с контуром, чтобы добавить подпись, нажмите вторую кнопку (или потенциально обе кнопки мыши одновременно), чтобы закончить добавление подписей. Третья кнопка может использоваться для удаления последней добавленной подписи, но только если подписи не встроены. Кроме того, для выбора местоположения подписи можно использовать клавиатуру (ввод для завершения размещения подписи, удаление или клавиша Backspace действуют как третья кнопка мыши, а любая другая клавиша выберет местоположение подписи).

manual может быть итерируемым объектом кортежей x,y. Подписи контура будут создаваться так, как если бы мышь нажималась в каждой позиции x,y.

rightside_up:

если True (по умолчанию), повороты подписей всегда будут плюс или минус 90 градусов от уровня.

use_clabeltext:

если True (по умолчанию False), используется класс ClabelText (вместо matplotlib.Text) для создания подписей. ClabelText пересчитывает углы поворота текста во время рисования, поэтому это может быть использовано, если аспект осей изменяется.

(Исходный код)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

Дополнительные аргументы: hold = [True|False] переопределяет состояние удержания по умолчанию

matplotlib.pyplot.clf()

Очистить текущую фигуру.

matplotlib.pyplot.clim(vmin=None, vmax=None)

Установить пределы цветов текущего изображения.

Чтобы применить clim ко всем изображениям осей:

clim(0, 0.5)

Если vmin или vmax равно None, соответственно, используются минимальное и максимальное значения изображения для масштабирования цвета.

Если необходимо установить clim для нескольких изображений, используйте, например:

for im in gca().get_images():
    im.set_clim(0, 0.05)

matplotlib.pyplot.close(*args)

Закрыть окно фигуры.

close() само по себе закрывает текущую фигуру

close(h) где h — экземпляр Figure, закрывает эту фигуру

close(num) закрывает фигуру с номером num

close(name) где name — строка, закрывает фигуру с этим именем

close('all') закрывает все окна фигур

matplotlib.pyplot.cohere(x, y, NFFT=256, Fs=2, Fc=0, detrend=, window=, noverlap=0, pad_to=None, sides='default', scale_by_freq=None, hold=None, data=None, **kwargs)

Построить когерентность между x и y.

Вызов:

cohere(x, y, NFFT=256, Fs=2, Fc=0, detrend = mlab.detrend_none,
       window = mlab.window_hanning, noverlap=0, pad_to=None,
       sides='default', scale_by_freq=None, **kwargs)

Построить когерентность между x и y. Когерентность — это нормированная взаимная спектральная плотность:

Ключевые аргументы:

Fs: скаляр

Частота дискретизации (образцов в единицу времени). Она используется для расчёта частот Фурье, freqs, в циклах за единицу времени. Значение по умолчанию — 2.

window: вызываемый объект или массив

Функция или вектор длиной NFFT. Для создания векторов окон см. window_hanning(), window_none(), numpy.blackman(), numpy.hamming(), numpy.bartlett(), scipy.signal(), scipy.signal.get_window(), и т. д. По умолчанию — window_hanning(). Если в качестве аргумента передана функция, она должна принимать сегмент данных в качестве аргумента и возвращать оконную версию сегмента.

sides: [ ‘default’ | ‘onesided’ | ‘twosided’ ]

Указывает, какие стороны спектра возвращать. Значение по умолчанию соответствует стандартному поведению, которое возвращает односторонний спектр для вещественных данных и двусторонний для комплексных данных. ‘onesided’ принудительно возвращает односторонний спектр, а ‘twosided’ — двусторонний.

pad_to: целое число

Количество точек, до которого дополняется сегмент данных при выполнении БПФ. Это может отличаться от NFFT, которое определяет количество точек данных, используемых. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешаемыми пиками), это может дать больше точек на графике, позволяя получить больше деталей. Это соответствует параметру n в вызове fft(). По умолчанию None, что устанавливает pad_to равным NFFT

NFFT: целое число

Количество точек данных, используемых в каждом блоке для БПФ. Мощность 2 наиболее эффективна. Значение по умолчанию — 256. Не следует использовать для получения нулевого заполнения, иначе масштабирование результата будет неправильным. Используйте pad_to для этого вместо этого.

detrend: [ ‘default’ | ‘constant’ | ‘mean’ | ‘linear’ | ‘none’] или

вызываемый объект

Функция, применяемая к каждому сегменту перед выполнением БПФ, предназначенная для удаления среднего значения или линейной тенденции. В отличие от MATLAB, где параметр detrend — вектор, в matplotlib он — функция. Модуль pylab определяет detrend_none(), detrend_mean(), и detrend_linear(), но вы можете использовать и пользовательскую функцию. Вы также можете использовать строку для выбора одной из функций. ‘default’, ‘constant’, и ‘mean’ вызывают detrend_mean(). ‘linear’ вызывает detrend_linear(). ‘none’ вызывает detrend_none().

scale_by_freq: булево значение

Указывает, следует ли масштабировать возвращаемые значения плотности с помощью масштабирующей частоты, что даёт плотность в единицах Hz^-1. Это позволяет интегрировать по возвращаемым значениям частоты. По умолчанию True для совместимости с MATLAB.

noverlap: целое число

Количество перекрывающихся точек между блоками. По умолчанию 0 (нет перекрытия).

Fc: целое число

Центральная частота x (по умолчанию 0), которая смещает x-пределы графика, чтобы отразить диапазон частот, используемый при получении сигнала, а затем его фильтрации и дискретизации до базовой полосы.

Результат — кортеж (Cxy, f), где f — частоты вектора когерентности.

Дополнительные ключевые параметры применяются к линиям.

Ссылки:

• Bendat & Piersol – Random Data: Analysis and Measurement Procedures, John Wiley & Sons (1986)

Дополнительные ключевые параметры управляют свойствами Line2D графика когерентности:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated	[True | False]
antialiased или aa	[True | False]
axes	экземпляр Axes
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	любое число

Пример:

(Исходный код, png, hires.png, pdf)

Примечания

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

• Все аргументы с именами: ‘y’, ‘x’.

Дополнительные ключевые аргументы: hold = [True|False] переопределяет состояние hold по умолчанию

matplotlib.pyplot.colorbar(mappable=None, cax=None, ax=None, **kw)

Добавление полосы цвета к графику.

Подписи функций для интерфейса pyplot; все, кроме первой, также являются подписями методов для метода colorbar():

colorbar(**kwargs)
colorbar(mappable, **kwargs)
colorbar(mappable, cax=cax, **kwargs)
colorbar(mappable, ax=ax, **kwargs)

аргументы:

mappable

отображаемый объект, Image, ContourSet, и т.д., к которому применяется полоса цвета; этот аргумент является обязательным для метода colorbar(), но необязательным для функции colorbar(), которая устанавливает значение по умолчанию на текущий рисунок.

ключевые аргументы:

cax

None | объект осей, на котором будет нарисован цветовой бар

ax

None | родительский объект осей (множественного числа), из которого будет украдена область для новых осей цветовой шкалы. Если задан список осей, все они будут изменены, чтобы освободить место для осей цветовой шкалы.

use_gridspec

False | Если cax равен None, новый cax создается как экземпляр Axes. Если ax является экземпляром Subplot и use_gridspec равен True, cax создается как экземпляр Subplot с использованием модуля grid_spec.

Дополнительные ключевые аргументы бывают двух типов:

свойства осей:

Свойство	Описание
orientation	вертикальное или горизонтальное
fraction	0.15; доля исходных осей для использования полосы цвета
pad	0.05 при вертикальной, 0.15 при горизонтальной ориентации; доля исходных осей между полосой цвета и новыми осями изображения
shrink	1.0; доля уменьшения полосы цвета
aspect	20; отношение длин к коротким сторонам
anchor	(0.0, 0.5) при вертикальной ориентации; (0.5, 1.0) при горизонтальной; точка привязки осей полосы цвета
panchor	(1.0, 0.5) при вертикальной ориентации; (0.5, 0.0) при горизонтальной; точка привязки родительских осей полосы цвета. Если False, точка привязки родительских осей не изменится

свойства полосы цвета:

Свойство	Описание
extend	[ ‘neither’ | ‘both’ | ‘min’ | ‘max’ ] Если не ‘neither’, добавить стреловидные концы для значений вне диапазона. Они устанавливаются для заданной цветовой карты с помощью методов colormap set_under и set_over.
extendfrac	[ None | ‘auto’ | длина | длины ] Если None, как минимальное, так и максимальное треугольные расширения полосы цвета имеют длину 5% от внутренней длины полосы цвета (это значение по умолчанию). Если ‘auto’, задает треугольные расширения полосы цвета той же длины, что и внутренние прямоугольники (когда spacing равен ‘uniform’) или той же длины, что и соответствующие соседние внутренние прямоугольники (когда spacing равен ‘proportional’). Если скаляр, задает длину как минимального, так и максимального треугольных расширений полосы цвета как долю от внутренней длины полосы цвета. Также может быть задана двухелементная последовательность дробей, указывающая длины минимального и максимального расширений полосы цвета соответственно как долю от внутренней длины полосы цвета.
extendrect	[ False | True ] Если False, минимальные и максимальные расширения полосы цвета будут треугольными (по умолчанию). Если True, расширения будут прямоугольными.
spacing	[ ‘uniform’ | ‘proportional’ ] Равномерное распределение задает одинаковое пространство для каждого дискретного цвета; пропорциональное распределение задает пространство, пропорциональное интервалу данных.
ticks	[ None | список меток | объект Locator ] Если None, метки определяются автоматически из ввода.
format	[ None | строка формата | объект Formatter ] Если None, используется ScalarFormatter. Если задана строка формата, например, ‘%.3f’, она используется. Вместо нее может быть задан альтернативный объект Formatter.
drawedges	[ False | True ] Если True, нарисовать линии на границах цветов.

Следующие параметры, вероятно, будут полезны только в контексте индексированных цветов (то есть, когда mappable имеет norm=NoNorm()) или других необычных ситуациях.

Свойство	Описание
boundaries	None или последовательность
values	None или последовательность, длина которой на 1 меньше, чем последовательность boundaries. Для каждого интервала, ограниченного смежными элементами в boundaries, используется цвет, сопоставленный с соответствующим значением в values.

Если mappable является ContourSet, его ключевой аргумент extend включается автоматически.

Обратите внимание, что ключевой аргумент shrink предоставляет простой способ предотвращения, например, того, чтобы вертикальная полоса цвета была выше осей отображаемого объекта, к которому она прикреплена; но это ручное задание, требующее некоторых проб и ошибок. Если полоса цвета слишком большая (или горизонтальная полоса цвета слишком широкая), используйте меньшее значение shrink.

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

Известно, что некоторые просмотрщики векторной графики (svg и pdf) отображают белые пробелы между сегментами полосы цвета. Это связано с ошибками в просмотрщиках, а не в matplotlib. В качестве обходного решения полоса цвета может быть отображена с перекрывающимися сегментами:

cbar = colorbar()
cbar.solids.set_edgecolor("face")
draw()

Однако это имеет негативные последствия в других обстоятельствах. В частности, с полупрозрачными изображениями (alpha < 1) и расширениями полосы цвета, и по умолчанию это не включено (см. вопрос №1188).

возвращает:

Colorbar экземпляр; также см. его базовый класс ColorbarBase. Вызовите метод set_label(), чтобы пометить полосу цвета.

matplotlib.pyplot.colors()

Это функция, которая ничего не делает, чтобы помочь вам понять, как matplotlib обрабатывает цвета.

Команды, которые принимают аргументы цвета, могут использовать несколько форматов для задания цвета. Для основных встроенных цветов можно использовать одну букву

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

Для большего диапазона цветов у вас есть два варианта. Вы можете указать цвет с помощью html шестнадцатеричного кода, как в:

color = '#eeefff'

или вы можете передать кортеж R,G,B, где каждый из R,G,B находится в диапазоне [0,1].

Вы также можете использовать любое допустимое html имя цвета, например:

color = 'red'
color = 'burlywood'
color = 'chartreuse'

В следующем примере создается подграфик с серым фоном темно-серого цвета:

subplot(111, axisbg=(0.1843, 0.3098, 0.3098))

Вот пример создания заголовка бледно-бирюзового цвета:

title('Is this the best color?', color='#afeeee')

matplotlib.pyplot.connect(s, func)

Подключение события со строкой s к func. Подпись func:

def func(event)

где событие является matplotlib.backend_bases.Event. Следующие события распознаются:

• ‘button_press_event’
• ‘button_release_event’
• ‘draw_event’
• ‘key_press_event’
• ‘key_release_event’
• ‘motion_notify_event’
• ‘pick_event’
• ‘resize_event’
• ‘scroll_event’
• ‘figure_enter_event’,
• ‘figure_leave_event’,
• ‘axes_enter_event’,
• ‘axes_leave_event’
• ‘close_event’

Для событий местоположения (нажатие и отпускание кнопки и клавиши), если указатель находится над осями, переменная event.inaxes будет установлена в Axes, над которым произошло событие, и, дополнительно, будут определены переменные event.xdata и event.ydata. Это местоположение указателя в координатах данных. См. KeyEvent и MouseEvent для получения дополнительной информации.

Значение возврата — идентификатор соединения, который можно использовать с mpl_disconnect().

Пример использования:

def on_press(event):
    print('you pressed', event.button, event.xdata, event.ydata)

cid = canvas.mpl_connect('button_press_event', on_press)

matplotlib.pyplot.contour(*args, **kwargs)

Построение контуров.

contour() и contourf() соответственно строят линии контура и заполненные контуры. За исключением отмеченных случаев, сигнатуры функций и возвращаемые значения одинаковы для обеих версий.

contourf() отличается от версии MATLAB тем, что не рисует рёбра многоугольников. Чтобы нарисовать рёбра, добавьте линии контура с вызовами contour().

Вызовы функций:

contour(Z)

построение контурного графика массива Z. Значения уровней выбираются автоматически.

contour(X,Y,Z)

X, Y задают (x, y) координаты поверхности

contour(Z,N)
contour(X,Y,Z,N)

контур до N автоматически выбранных уровней.

contour(Z,V)
contour(X,Y,Z,V)

рисование линий контура в значениях, указанных в последовательности V, которая должна быть в возрастающем порядке.

contourf(..., V)

заполнение len(V)-1 областей между значениями в V, которые должны быть в возрастающем порядке.

contour(Z, **kwargs)

Используйте ключевые аргументы для управления цветами, шириной линий, началом координат, cmap... см. ниже для получения более подробной информации.

X и Y должны быть оба 2-мерными с такой же формой, как Z, или они оба должны быть 1-мерными, так что len(X) является количеством столбцов в Z и len(Y) является количеством строк в Z.

C = contour(...) возвращает QuadContourSet объект.

Необязательные ключевые аргументы:

corner_mask: [ True | False | ‘legacy’ ]

Включить/выключить маскирование углов, которое влияет только в том случае, если Z является массивом с пропускаемыми значениями. Если False, любая четырёхугольная область, касающаяся пропущенной точки, пропускается. Если True, только треугольные углы четырёхугольников, ближайшие к этим точкам, всегда маскируются, другие треугольные углы, состоящие из трёх не пропущенных точек, контурируются как обычно. Если ‘legacy’, используется старый алгоритм контуров, который эквивалентен False и устарел, остаётся только пока новый алгоритм не протестирован полностью.

Если не указано, используется значение по умолчанию из rcParams[‘contour.corner_mask’], которое равно True, если оно не было изменено.

colors: [ None | строка | (mpl_colors) ]

Если None, используется цветовая карта, заданная cmap.

Если строка, например ‘r’ или ‘red’, все уровни будут отображаться в этом цвете.

Если кортеж аргументов цвета matplotlib (строка, число с плавающей точкой, rgb и т.д.), разные уровни будут отображаться в разных цветах в указанном порядке.

alpha: float

Значение смешивания альфа-канала

cmap: [ None | Colormap ]

Экземпляр cm Colormap или None. Если cmap равно None и colors равно None, используется цветовая карта по умолчанию.

norm: [ None | Normalize ]

Экземпляр matplotlib.colors.Normalize для масштабирования значений данных до цветов. Если norm равно None и colors равно None, используется линейное масштабирование по умолчанию.

vmin, vmax: [ None | скаляр ]

Если не None, то эти значения будут переданы экземпляру matplotlib.colors.Normalize, переопределяя масштабирование цветов по умолчанию на основе levels.

levels: [level0, level1, ..., leveln]

Список чисел с плавающей точкой, указывающий линии контура для рисования в возрастающем порядке; например, чтобы нарисовать только нулевой контур, передайте levels=[0]

origin: [ None | ‘upper’ | ‘lower’ | ‘image’ ]

Если None, первое значение Z будет соответствовать нижнему левому углу, координатам (0,0). Если ‘image’, будет использоваться значение rc для image.origin.

Этот ключевой аргумент неактивен, если X и Y указаны в вызове contour.

extent: [ None | (x0,x1,y0,y1) ]

Если origin не None, то extent интерпретируется как в matplotlib.pyplot.imshow(): он задаёт внешние границы пикселей. В этом случае положение Z[0,0] является центром пикселя, а не углом. Если origin равно None, то (x0, y0) — положение Z[0,0], а (x1, y1) — положение Z[-1,-1].

Этот ключевой аргумент неактивен, если X и Y указаны в вызове contour.

locator: [ None | ticker.Locator subclass ]

Если locator равно None, используется значение по умолчанию MaxNLocator. Locator используется для определения уровней контура, если они не заданы явно через аргумент V.

extend: [ ‘neither’ | ‘both’ | ‘min’ | ‘max’ ]

Если это не ‘neither’, уровни контура автоматически добавляются к одному или обоим концам диапазона, чтобы охватить все данные. Эти добавленные диапазоны затем отображаются на специальные значения цветовой карты, которые по умолчанию соответствуют концам диапазона цветовой карты, но могут быть установлены с помощью методов matplotlib.colors.Colormap.set_under() и matplotlib.colors.Colormap.set_over().

xunits, yunits: [ None | registered units ]

Переопределить единицы осей, указав экземпляр matplotlib.units.ConversionInterface.

antialiased: [ True | False ]

включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию равно True. Для линий контура оно взято из rcParams[‘lines.antialiased’].

nchunk: [ 0 | целое число ]

Если 0, домен не разбивается. Укажите положительное целое число, чтобы разделить домен на поддомены размером nchunk на nchunk четырёхугольников. Разбиение уменьшает максимальную длину многоугольников, генерируемых алгоритмом контуров, что уменьшает рабочую нагрузку на бэкенд и требуется меньше оперативной памяти. Однако в зависимости от бэкенда, флага antialiased и значения alpha это может привести к артефактам рендеринга на границах блоков.

Только ключевые аргументы для contour:

linewidths: [ None | число | кортеж чисел ]

Если linewidths равно None, используется ширина по умолчанию в lines.linewidth в matplotlibrc.

Если число, все уровни будут отображаться с этой шириной.

Если кортеж, разные уровни будут отображаться с разной шириной в указанном порядке.

linestyles: [ None | ‘solid’ | ‘dashed’ | ‘dashdot’ | ‘dotted’ ]

Если linestyles равно None, по умолчанию используется ‘solid’, если линии не монохромные. В этом случае отрицательные контуры будут принимать стиль линии из matplotlibrc contour.negative_linestyle.

linestyles также может быть итерируемым объектом вышеперечисленных строк, задающим набор стилей линий, который будет использоваться. Если этот итерируемый объект короче, чем количество уровней контура, он будет повторяться по мере необходимости.

Только ключевые аргументы для contourf:

hatches:

Список штрихов для использования на заполненных областях. Если None, штриховка к контуру не добавлена. Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

Примечание: contourf заполняет интервалы, которые закрыты сверху; то есть, для границ z1 и z2, заполненная область:

z1 < z <= z2

Есть одно исключение: если самая низкая граница совпадает с минимальным значением массива z, то это минимальное значение будет включено в самый низкий интервал.

Примеры:

(Исходный код)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(Исходный код)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(Исходный код, png, hires.png, pdf)

Дополнительные параметры: hold = [True|False] переопределяет состояние hold по умолчанию

matplotlib.pyplot.contourf(*args, **kwargs)

Построение заполненных контуров.

contour() и contourf() соответственно строят контурные линии и заполненные контурные области. За исключением отмеченных случаев, сигнатуры функций и возвращаемые значения одинаковы для обеих версий.

contourf() отличается от версии MATLAB тем, что не рисует границы многоугольников. Чтобы нарисовать границы, добавьте контурные линии с вызовами contour().

Подписи вызовов функций:

contour(Z)

строит контурный график массива Z. Значения уровней выбираются автоматически.

contour(X,Y,Z)

X, Y задают (x, y) координаты поверхности

contour(Z,N)
contour(X,Y,Z,N)

строит контур до N автоматически выбранных уровней.

contour(Z,V)
contour(X,Y,Z,V)

строит контурные линии по значениям, указанным в последовательности V, которая должна быть отсортирована по возрастанию.

contourf(..., V)

заполняет len(V)-1 области между значениями в V, которые должны быть отсортированы по возрастанию.

contour(Z, **kwargs)

Используйте ключевые аргументы для управления цветами, толщиной линий, началом отсчёта, cmap и т.д. – см. более подробные сведения ниже.

X и Y должны быть 2-мерными с такой же формой, что и Z, или они должны быть 1-мерными, так что len(X) является количеством столбцов в Z, а len(Y) — количеством строк в Z.

C = contour(...) возвращает объект QuadContourSet.

Дополнительные ключевые аргументы:

corner_mask: [ True | False | ‘legacy’ ]

Включить/выключить маскировку углов, которая влияет только если Z является массив с пропусками. Если False, любой четырёхугольник, касающийся пропущенной точки, маскируется. Если True, только треугольные углы четырёхугольников, ближайшие к пропущенным точкам, всегда маскируются, а другие треугольные углы, состоящие из трёх не пропущенных точек, контурируются как обычно. Если ‘legacy’, используется старый алгоритм контурирования, что эквивалентно False и устарело, оставлено для полного тестирования нового алгоритма.

Если не указано, используется значение по умолчанию из rcParams[‘contour.corner_mask’], которое равно True, если оно не было изменено.

colors: [ None | строка | (mpl_цвета) ]

Если None, используется цветовая карта, заданная cmap.

Если строка, например, ‘r’ или ‘red’, все уровни будут нарисованы в этом цвете.

Если кортеж аргументов цвета matplotlib (строка, число с плавающей запятой, rgb и т.д.), разные уровни будут нарисованы в разных цветах в указанном порядке.

alpha: число с плавающей запятой

Значение смешения альфы

cmap: [ None | Colormap ]

Экземпляр cm Colormap или None. Если cmap равно None и colors равно None, используется цветовая карта по умолчанию.

norm: [ None | Normalize ]

Экземпляр matplotlib.colors.Normalize для масштабирования значений данных до цветов. Если norm равно None и colors равно None, используется линейное масштабирование по умолчанию.

vmin, vmax: [ None | скаляр ]

Если не None, эти значения будут переданы экземпляру matplotlib.colors.Normalize, переопределяя масштабирование цвета по умолчанию, основанное на levels.

levels: [level0, level1, ..., leveln]

Список чисел с плавающей точкой, указывающих контурные линии для рисования в порядке возрастания; например, чтобы нарисовать только нулевой контур, используйте levels=[0]

origin: [ None | ‘верх’ | ‘низ’ | ‘изображение’ ]

Если None, первое значение Z соответствует нижнему левому углу, позиции (0,0). Если ‘изображение’, используется значение rc для image.origin.

Этот ключевой аргумент неактивен, если X и Y указаны в вызове функции contour.

extent: [ None | (x0,x1,y0,y1) ]

Если origin не None, то extent интерпретируется так же, как в matplotlib.pyplot.imshow(): он задаёт границы внешних пикселей. В этом случае положение Z[0,0] является центром пикселя, а не углом. Если origin равно None, то (x0, y0) — положение Z[0,0], а (x1, y1) — положение Z[-1,-1].

Этот ключевой аргумент неактивен, если X и Y указаны в вызове функции contour.

locator: [ None | подкласс ticker.Locator ]

Если locator равно None, используется по умолчанию MaxNLocator. Локатор используется для определения контурных уровней, если они не заданы явно с помощью аргумента V.

extend: [ ‘ничего’ | ‘всё’ | ‘минимум’ | ‘максимум’ ]

Если это не ‘ничего’, контурные уровни автоматически добавляются к одному или двум концам диапазона, чтобы все данные были включены. Эти добавленные диапазоны отображаются на специальные значения цветовой карты, которые по умолчанию соответствуют концам диапазона цветовой карты, но могут быть установлены с помощью matplotlib.colors.Colormap.set_under() и matplotlib.colors.Colormap.set_over() методов.

xunits, yunits: [ None | зарегистрированные единицы ]

Переопределить единицы осей, указав экземпляр matplotlib.units.ConversionInterface.

antialiased: [ True | False ]

Включить сглаживание, переопределяя значения по умолчанию. Для заполненных контуров значение по умолчанию равно True. Для контурных линий оно берется из rcParams[‘lines.antialiased’].

nchunk: [ 0 | целое число ]

Если 0, подразделение области не выполняется. Укажите положительное целое число, чтобы разделить область на поддомены размером nchunk на nchunk четырёхугольников. Разбиение уменьшает максимальную длину полигонов, генерируемых алгоритмом контурирования, что снижает нагрузку на рендеринг, передаваемую бэкенду, и требует немного меньше оперативной памяти. Однако в зависимости от бэкенда, флага antialiased и значения alpha оно может вводить артефакты рендеринга на границах разбиения.

Ключевые аргументы только для контуров:

linewidths: [ None | число | кортеж чисел ]

Если linewidths равно None, используется значение по умолчанию для толщины линий в lines.linewidth в matplotlibrc.

Если число, все уровни будут нарисованы с этой толщиной.

Если кортеж, разные уровни будут нарисованы с разной толщиной в указанном порядке.

linestyles: [ None | ‘сплошная’ | ‘штриховая’ | ‘штрихпунктирная’ | ‘пунктирная’ ]

Если linestyles равно None, значение по умолчанию равно ‘сплошная’, если линии не монохромные. В этом случае отрицательные контуры получат стиль линии из matplotlibrc contour.negative_linestyle настройки.

linestyles также может быть итерируемым объектом из указанных выше строк, задающим набор стилей линий для использования. Если этот итерируемый объект короче, чем количество контурных уровней, он будет повторяться по мере необходимости.

Ключевые аргументы только для contourf:

hatches:

Список штрихов для использования в заполненных областях. Если None, штриховка не будет добавлена к контуру. Штриховка поддерживается только в бэкендах PostScript, PDF, SVG и Agg.

Примечание: contourf заполняет интервалы, которые закрыты сверху; то есть, для границ z1 и z2 заполненная область равна:

z1 < z <= z2

Есть одно исключение: если нижняя граница совпадает с минимальным значением массива z, то это минимальное значение будет включено в нижний интервал.

Примеры:

(Исходный код)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(Исходный код)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

(Исходный код, png, hires.png, pdf)

Дополнительные ключевые параметры: hold = [True|False] переопределяет состояние удержания по умолчанию

matplotlib.pyplot.cool()

Устанавливает цветовую карту по умолчанию на cool и применяет её к текущему изображению, если таковое имеется. Для получения дополнительной информации см. справку по цветовым картам

matplotlib.pyplot.copper()

Устанавливает цветовую карту по умолчанию на copper и применяет её к текущему изображению, если таковое имеется. Для получения дополнительной информации см. справку по цветовым картам

matplotlib.pyplot.csd(x, y, NFFT=None, Fs=None, Fc=None, detrend=None, window=None, noverlap=None, pad_to=None, sides=None, scale_by_freq=None, return_line=None, hold=None, data=None, **kwargs)

Построение кросс-спектральной плотности.

Вызов функции:

csd(x, y, NFFT=256, Fs=2, Fc=0, detrend=mlab.detrend_none,
    window=mlab.window_hanning, noverlap=0, pad_to=None,
    sides='default', scale_by_freq=None, return_line=None, **kwargs)

Кросс-спектральная плотность вычисляется с помощью метода усреднённого периодограммы Вельча. Вектора x и y разбиваются на сегменты длиной NFFT. Каждый сегмент обрабатывается функцией detrend и окончен функцией window. noverlap задаёт длину перекрытия между сегментами. Произведение прямых преобразований Фурье от x и y усредняется по каждому сегменту для вычисления , с масштабированием для компенсации потерь мощности из-за окон.

Если len(x) < NFFT или len(y) < NFFT, они будут дополнены нулями до NFFT.

x, y: одномерные массивы или последовательности

Массивы или последовательности, содержащие данные

Ключевые параметры:

Fs: скаляр

Частота дискретизации (образцов в единицу времени). Она используется для вычисления частот Фурье, freqs, в циклах за единицу времени. Значение по умолчанию равно 2.

window: вызываемая функция или массив

Функция или вектор длины NFFT. Для создания векторов окон см. window_hanning(), window_none(), numpy.blackman(), numpy.hamming(), numpy.bartlett(), scipy.signal(), scipy.signal.get_window(), и т.д. Значение по умолчанию - window_hanning(). Если в качестве аргумента передаётся функция, она должна принимать сегмент данных в качестве аргумента и возвращать оконченную версию сегмента.

sides: [ ‘default’ | ‘onesided’ | ‘twosided’ ]

Указывает, какие стороны спектра возвращать. Значение по умолчанию даёт стандартное поведение, возвращает односторонний спектр для вещественных данных и двусторонний для комплексных данных. ‘onesided’ принудительно возвращает односторонний спектр, а ‘twosided’ - двусторонний.

pad_to: целое число

Количество точек, до которых дополняются данные сегмента при выполнении БПФ. Это может отличаться от NFFT, который указывает количество точек данных, используемых. Хотя это не увеличивает фактическое разрешение спектра (минимальное расстояние между разрешимыми пиками), это может дать больше точек на графике, позволяя получить больше деталей. Соответствует параметру n в вызове fft(). Значение по умолчанию - None, которое устанавливает pad_to равным NFFT

NFFT: целое число

Количество точек данных, используемых в каждом блоке для БПФ. Мощность 2 является наиболее эффективной. Значение по умолчанию равно 256. Не следует использовать для получения нулевого заполнения, иначе масштабирование результата будет неверным. Для этого используйте pad_to.

detrend: [ ‘default’ | ‘constant’ | ‘mean’ | ‘linear’ | ‘none’] или

вызываемая функция

Функция, применяемая к каждому сегменту перед БПФ, предназначенная для удаления среднего или линейной тенденции. В отличие от MATLAB, где параметр detrend является вектором, в matplotlib он является функцией. Модуль pylab определяет detrend_none(), detrend_mean(), и detrend_linear(), но вы можете использовать и пользовательскую функцию. Вы также можете использовать строку для выбора одной из функций. ‘default’, ‘constant’, и ‘mean’ вызывают detrend_mean(). ‘linear’ вызывает detrend_linear(). ‘none’ вызывает detrend_none().

scale_by_freq: boolean

Указывает, следует ли масштабировать значения плотности результата с масштабирующей частотой, что даёт плотность в единицах Hz^-1. Это позволяет для интегрирования по возвращаемым частотным значениям. Значение по умолчанию - True для совместимости с MATLAB.

noverlap: целое число

Количество перекрывающихся точек между сегментами. Значение по умолчанию - 0 (нет перекрытия).

Fc: целое число

Центральная частота x (по умолчанию 0), которая смещает диапазон x на графике, чтобы отразить частотный диапазон, используемый при получении сигнала, а затем его фильтрации и дискретизации до полосы частот.

return_line: bool

Включать ли объект линии, нарисованный на графике, в возвращаемые значения. Значение по умолчанию - False.

Если return_line False, возвращает кортеж (Pxy, freqs). Если return_line True, возвращает кортеж (Pxy, freqs. line):

Pxy: одномерный массив

Значения для кросс-спектра P_{xy} до масштабирования (комплексные значения)

freqs: одномерный массив

Частоты, соответствующие элементам в Pxy

line: a Line2D instance

Линия, созданная этой функцией. Возвращается только если return_line True.

Для построения графиков мощность выводится как для децибелов, хотя P_{xy} возвращается само по себе.

Ссылки:

Bendat & Piersol – Random Data: Analysis and Measurement Procedures, John Wiley & Sons (1986)

Ключевые параметры kwargs управляют свойствами Line2D:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated	[True | False]
antialiased или aa	[True | False]
axes	экземпляр Axes
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 | срез | список/массив целых чисел | число с плавающей точкой | кортеж из 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	любое число

Пример:

(Исходный код, png, hires.png, pdf)

См. также

psd()

psd() эквивалентно установлению y=x.

Примечания

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

• Все аргументы с именами: ‘y’, ‘x’.

Дополнительные ключевые аргументы: hold = [True|False] переопределяет состояние hold по умолчанию

matplotlib.pyplot.delaxes(*args)

Удалить ось из текущей фигуры. Если ax не существует, будет выброшено исключение.

delaxes(): удалить текущую ось

matplotlib.pyplot.disconnect(cid)

Отключить обработчик событий с идентификатором cid

Пример использования:

cid = canvas.mpl_connect('button_press_event', on_press)
#...later
canvas.mpl_disconnect(cid)

matplotlib.pyplot.draw()

Перерисовать текущую фигуру.

Используется в интерактивном режиме для обновления фигуры, которая была изменена, но не перерисована автоматически. Это нужно только в редких случаях, но могут быть способы изменения состояния фигуры без маркировки её как stale. Пожалуйста, сообщайте о таких случаях как ошибки.

Более объектно-ориентированный вариант, используя любой экземпляр Figure, fig, созданный с помощью функции pyplot, это:

fig.canvas.draw_idle()

matplotlib.pyplot.errorbar(x, y, yerr=None, xerr=None, fmt='', ecolor=None, elinewidth=None, capsize=None, barsabove=False, lolims=False, uplims=False, xlolims=False, xuplims=False, errorevery=1, capthick=None, hold=None, data=None, **kwargs)

Построение графика с погрешностями.

Вызов функции:

errorbar(x, y, yerr=None, xerr=None,
         fmt='', ecolor=None, elinewidth=None, capsize=None,
         barsabove=False, lolims=False, uplims=False,
         xlolims=False, xuplims=False, errorevery=1,
         capthick=None)

Построить график x против y с погрешностями в yerr и xerr. Вертикальные погрешности строятся, если yerr не None. Горизонтальные погрешности строятся, если xerr не None.

x, y, xerr и yerr могут быть скалярами, что строит одну погрешность в точке x, y.

Необязательные ключевые аргументы:

xerr/yerr: [ скаляр | N, Nx1 или 2xN массив-подобный объект ]

Если скалярное число, массив-подобный объект длины N или Nx1 массив-подобный объект, погрешности строятся на +/- значение относительно данных.

Если последовательность размера 2xN, погрешности строятся на -строка1 и +строка2 относительно данных.

fmt: [ ‘’ | ‘none’ | строка формата графика ]

Символ формата графика. Если fmt равен ‘none’ (регистронезависимо), строятся только погрешности. Это используется для добавления погрешностей к столбчатой диаграмме, например. По умолчанию ‘’ — пустая строка формата графика; свойства идентичны значениям по умолчанию для plot().

ecolor: [ None | цвет matplotlib ]

Аргумент цвета matplotlib, определяющий цвет линий погрешностей; если None, используется цвет линии, соединяющей маркеры.

elinewidth: скаляр

Ширина линии погрешности. Если None, используется значение из linewidth.

capsize: скаляр

Длина наконечников погрешности в пунктах; если None, используется значение из errorbar.capsize rcParam.

capthick: скаляр

Псевдоним ключевого аргумента для markeredgewidth (также mew). Это более осмысленное название свойства, определяющего толщину наконечников погрешности в пунктах. Для обратной совместимости, если заданы mew или markeredgewidth, они будут переопределять capthick. Это может измениться в будущих версиях.

barsabove: [ True | False ]

Если True, погрешности строятся над символами графика. По умолчанию под ними.

lolims / uplims / xlolims / xuplims: [ False | True ]

Эти аргументы могут использоваться для указания того, что значение задает только верхние/нижние пределы. В этом случае используется символ каретки для обозначения этого. Аргументы lims могут иметь тот же тип, что и xerr и yerr. Для использования пределов с инвертированными осями необходимо вызвать set_xlim() или set_ylim() перед errorbar().

errorevery: положительное целое число

подвыборка погрешностей. Например, если errorevery=5, погрешности для каждого 5-го значения будут построены. Сам график данных по-прежнему показывает все точки данных.

Все остальные ключевые аргументы передаются в команду plot для маркеров. Например, этот код создаёт большие красные квадраты с толстыми зелёными краями:

x,y,yerr = rand(3,10)
errorbar(x, y, yerr, marker='s',
         mfc='red', mec='green', ms=20, mew=4)

где mfc, mec, ms и mew являются псевдонимами для более длинных имён свойств, markerfacecolor, markeredgecolor, markersize и markeredgewidth.

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

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated	[True | False]
antialiased или aa	[True | False]
axes	экземпляр Axes
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 | целое число | пара из двух целых чисел | срез | список/массив целых чисел | число с плавающей точкой | пара из двух чисел с плавающей точкой]
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	любое число

Возвращает (plotline, caplines, barlinecols):

plotline: Line2D instance

x, y метки и/или линии графика

caplines: список концов ошибочных столбцов

Line2D экземпляры

barlinecols: список

LineCollection экземпляров для горизонтальных и вертикальных диапазонов ошибок.

Пример:

(Исходный код, png, hires.png, pdf)

Примечания

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

• Все аргументы с именами: ‘xerr’, ‘y’, ‘yerr’, ‘x’.

Дополнительные ключевые аргументы: hold = [True|False] переопределяет состояние hold по умолчанию

matplotlib.pyplot.eventplot(positions, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, linestyles='solid', hold=None, data=None, **kwargs)

Отображение идентичных параллельных линий в определенных позициях.

Вызов функции:

eventplot(positions, orientation='horizontal', lineoffsets=0,
          linelengths=1, linewidths=None, color =None,
          linestyles='solid'

Отображаются параллельные линии в заданных позициях. positions должен быть объектом 1D или 2D типа array-like, где каждая строка соответствует строке или столбцу линий.

Этот тип графика обычно используется в нейробиологии для представления нейронных событий, где он обычно называется графиком импульсов, точечным графиком или графиком событий.

Однако он полезен в любой ситуации, когда вы хотите показать временные или позиционные параметры нескольких наборов дискретных событий, таких как время прибытия людей в бизнес каждый день месяца или дата ураганов каждый год прошлого столетия.

orientation

: [ ‘горизонтальное’ | ‘вертикальное’ ]

‘горизонтальное’ : линии будут вертикальными и расположены в строках “вертикальное’ : линии будут горизонтальными и расположены в столбцах

lineoffsets :

Вещественное число или массив, содержащий вещественные числа.

linelengths :

Вещественное число или массив, содержащий вещественные числа.

linewidths :

Вещественное число или массив, содержащий вещественные числа.

colors

должен быть последовательностью кортежей RGBA (например, произвольными строками цвета и т. д., не допускаются)

linestyles :

[ ‘сплошная’ | ‘пунктирная’ | ‘штрихпунктирная’ | ‘точечная’ ] или массив этих значений

Для linelengths, linewidths, colors и linestyles, если задано только одно значение, это значение применяется ко всем линиям. Если задан массив, он должен иметь ту же длину, что и positions, и каждое значение будет применено к соответствующей строке или столбцу в positions.

Возвращает список объектов matplotlib.collections.EventCollection, которые были добавлены.

Ключевые аргументы являются свойствами LineCollection:

Свойство	Описание
agg_filter	неизвестно
alpha	float или None
animated	[True | False]
antialiased или antialiaseds	Булево значение или последовательность булевых значений
array	неизвестно
axes	экземпляр Axes
clim	последовательность из двух чисел с плавающей точкой
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
cmap	палитра цветов или зарегистрированное имя палитры
color	аргумент цвета matplotlib или последовательность кортежей rgba
contains	вызываемая функция
edgecolor или edgecolors	спецификация цвета matplotlib или последовательность спецификаций
facecolor или facecolors	спецификация цвета matplotlib или последовательность спецификаций
figure	экземпляр matplotlib.figure.Figure
gid	строка идентификатора
hatch	[ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]
label	строка или любой печатаемый объект с преобразованием ‘%s’
linestyle или linestyles или dashes	[‘сплошная’ | ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ | (смещение, последовательность включения-выключения штрихов) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	неизвестно
offset_position	неизвестно
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	неизвестно
paths	неизвестно
picker	[None|число с плавающей точкой|логическое значение|вызываемая функция]
pickradius	неизвестно
rasterized	[True | False | None]
segments	неизвестно
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка URL
urls	неизвестно
verts	неизвестно
visible	[True | False]
zorder	любое число

Пример:

(Исходный код, png, hires.png, pdf)

Примечания

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

• Все аргументы с следующими именами: ‘linewidths’, ‘linelengths’, ‘lineoffsets’, ‘colors’, ‘positions’, ‘linestyles’.

Дополнительные ключевые слова: hold = [True|False] переопределяет состояние hold по умолчанию

matplotlib.pyplot.figimage(*args, **kwargs)

Добавляет нересемплированное изображение на фигуру.

Вызовы:

figimage(X, **kwargs)

Добавляет нересемплированный массив X на фигуру.

figimage(X, xo, yo)

с пиксельными смещениями xo, yo,

X должен быть массивом с плавающей точкой:

• Если X имеет размер MxN, предполагается яркость (оттенки серого)
• Если X имеет размер MxNx3, предполагается RGB
• Если X имеет размер MxNx4, предполагается RGBA

Необязательные ключевые аргументы:

Ключевое слово	Описание
resize	булево значение, True или False. Если “True”, то размер фигуры изменяется для соответствия размеру изображения.
xo или yo	Целое число, смещение изображения по x и y в пикселях
cmap	экземпляр matplotlib.colors.Colormap, например, cm.jet. Если None, используется значение по умолчанию из rc image.cmap
norm	экземпляр matplotlib.colors.Normalize. По умолчанию используется normalization(). Это масштабирует яркость в диапазон 0-1
vmin|vmax	используются для масштабирования изображения яркости в диапазон 0-1. Если любой из них равен None, будут использованы минимальное и максимальное значения яркости. Обратите внимание, что если вы передаете экземпляр norm, настройки vmin и vmax будут проигнорированы.
alpha	значение альфа-смешивания, по умолчанию None
origin	[ ‘верхний’ | ‘нижний’ ] Указывает, где индекс [0,0] массива находится в верхнем левом или нижнем левом углу осей. По умолчанию используется значение rc image.origin

figimage дополняет изображение на осях (imshow()), которое будет ресемплировано для соответствия текущим осям. Если вы хотите, чтобы ресемплированное изображение заполнило всю фигуру, вы можете определить Axes с размером [0,1,0,1].

Возвращается экземпляр matplotlib.image.FigureImage.

(Исходный код, png, hires.png, pdf)

Дополнительные ключевые аргументы передаются как аргументы Artist в FigureImage. Дополнительные ключевые аргументы: hold = [True|False] переопределяет состояние hold по умолчанию

matplotlib.pyplot.figlegend(handles, labels, loc, **kwargs)

Размещает легенду на фигуре.

labels

последовательность строк

handles

последовательность экземпляров Line2D или Patch

loc

может быть строкой или целым числом, определяющим расположение легенды

Возвращается экземпляр matplotlib.legend.Legend.

Пример:

figlegend( (line1, line2, line3),
           ('label1', 'label2', 'label3'),
           'upper right' )

См. также

legend()

matplotlib.pyplot.fignum_exists(num)

matplotlib.pyplot.figtext(*args, **kwargs)

Добавить текст к рисунку.

Вызов функции:

text(x, y, s, fontdict=None, **kwargs)

Добавить текст к рисунку в позиции x, y (относительные координаты от 0 до 1). См. text() для значения других аргументов.

Аргументы kwargs управляют свойствами Text:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated	[True | False]
axes	экземпляр Axes
backgroundcolor	любой цвет matplotlib
bbox	словарь свойств FancyBboxPatch
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
color	любой цвет matplotlib
contains	функция-обработчик
family или fontname или fontfamily или name	[НАЗВАНИЕ ШРИФТА | ‘serif’ | ‘sans-serif’ | ‘cursive’ | ‘fantasy’ | ‘monospace’ ]
figure	экземпляр matplotlib.figure.Figure
fontproperties или font_properties	экземпляр matplotlib.font_manager.FontProperties
gid	строка-идентификатор
horizontalalignment или ha	[ ‘center’ | ‘right’ | ‘left’ ]
label	строка или любой вывод при преобразовании с помощью ‘%s’
linespacing	число с плавающей точкой (кратное размеру шрифта)
multialignment	[‘left’ | ‘right’ | ‘center’ ]
path_effects	неизвестно
picker	[None|число с плавающей точкой|логическое значение|функция-обработчик]
position	(x,y)
rasterized	[True | False | None]
rotation	[ угол в градусах | ‘vertical’ | ‘horizontal’ ]
rotation_mode	неизвестно
size или fontsize	[размер в пунктах | ‘xx-small’ | ‘x-small’ | ‘small’ | ‘medium’ | ‘large’ | ‘x-large’ | ‘xx-large’ ]
sketch_params	неизвестно
snap	неизвестно
stretch или fontstretch	[ числовое значение в диапазоне 0-1000 | ‘ultra-condensed’ | ‘extra-condensed’ | ‘condensed’ | ‘semi-condensed’ | ‘normal’ | ‘semi-expanded’ | ‘expanded’ | ‘extra-expanded’ | ‘ultra-expanded’ ]
style или fontstyle	[ ‘normal’ | ‘italic’ | ‘oblique’]
text	строка или любой вывод при преобразовании с помощью ‘%s’
transform	экземпляр Transform
url	строка url
usetex	неизвестно
variant или fontvariant	[ ‘normal’ | ‘small-caps’ ]
verticalalignment или ma или va	[ ‘center’ | ‘top’ | ‘bottom’ | ‘baseline’ ]
visible	[True | False]
weight или fontweight	[ числовое значение в диапазоне 0-1000 | ‘ultralight’ | ‘light’ | ‘normal’ | ‘regular’ | ‘book’ | ‘medium’ | ‘roman’ | ‘semibold’ | ‘demibold’ | ‘demi’ | ‘bold’ | ‘heavy’ | ‘extra bold’ | ‘black’ ]
wrap	неизвестно
x	число с плавающей точкой
y	число с плавающей точкой
zorder	любое число

matplotlib.pyplot.figure(num=None, figsize=None, dpi=None, facecolor=None, edgecolor=None, frameon=True, FigureClass=, **kwargs)

Создает новую фигуру.

Параметры:

num : целое число или строка, необязательно, по умолчанию: нет Если не указано, будет создана новая фигура, а номер фигуры будет инкрементирован. Объект фигуры хранит этот номер в number атрибуте. Если num указано, и фигура с этим идентификатором уже существует, она будет активирована, и будет возвращена ссылка на нее. Если такой фигуры нет, она будет создана и возвращена. Если num является строкой, заголовок окна будет установлен на num этой фигуры. figsize : кортеж целых чисел, необязательно, по умолчанию: None ширина и высота в дюймах. Если не указано, по умолчанию используется rc figure.figsize. dpi : целое число, необязательно, по умолчанию: None разрешение фигуры. Если не указано, по умолчанию используется rc figure.dpi. facecolor : цвет фона. Если не указано, по умолчанию используется rc figure.facecolor edgecolor : цвет границы. Если не указано, по умолчанию используется rc figure.edgecolor

Возвращаемое значение:

figure : Figure Экземпляр Figure, возвращаемый в ответ, также будет передан в new_figure_manager в бэкендах, что позволяет подключить пользовательские классы Figure к интерфейсу pylab. Дополнительные ключевые слова будут переданы в функцию инициализации фигуры.

Примечания

Если вы создаете много фигур, убедитесь, что вы явно вызываете «close» для тех фигур, которые не используете, так как это позволит pylab правильно освободить память.

rcParams определяет значения по умолчанию, которые можно изменить в файле matplotlibrc

matplotlib.pyplot.fill(*args, **kwargs)

Построение заполненных многоугольников.

Вызов:

fill(*args, **kwargs)

args — аргумент переменной длины, позволяющий указать несколько пар x, y с необязательной строкой формата цвета; см. plot() для получения подробностей о разборе аргументов. Например, чтобы нарисовать многоугольник с вершинами в точках x, y синим цветом:

ax.fill(x,y, 'b' )

Можно указать любое количество групп x, y, цвет:

ax.fill(x1, y1, 'g', x2, y2, 'r')

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

Поддерживаются те же строки цветов, что и plot().

Если нужно заполнить область под кривой, например, заштриховать область между 0 и y по оси x, используйте fill_between().

Аргумент closed установит закрытие многоугольника в значение True (по умолчанию).

Параметры kwargs управляют свойствами Polygon:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой или None
animated	[True | False]
antialiased или aa	[True | False] или None для значения по умолчанию
axes	экземпляр Axes
capstyle	[‘butt’ | ‘round’ | ‘projecting’]
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[(Path, Transform) | Patch | None]
color	спецификация цвета matplotlib
contains	функция вызова
edgecolor или ec	спецификация цвета mpl, или None для значения по умолчанию, или ‘none’ для отсутствия цвета
facecolor или fc	спецификация цвета mpl, или None для значения по умолчанию, или ‘none’ для отсутствия цвета
figure	экземпляр matplotlib.figure.Figure
fill	[True | False]
gid	строка id
hatch	[‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
label	строка или любой печатаемый объект с преобразованием ‘%s’
linestyle или ls	[‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (смещение, последовательность вкл/выкл) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	число с плавающей точкой или None для значения по умолчанию
path_effects	неизвестно
picker	[None|число с плавающей точкой|логическое значение|функция]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка url
visible	[True | False]
zorder	любое число

Пример:

(Исходный код, png, hires.png, pdf)

Примечания

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

• Все аргументы с именами ‘y’, ‘x’.

Дополнительные параметры: hold = [True|False] перезаписывает состояние hold по умолчанию

matplotlib.pyplot.fill_between(x, y1, y2=0, where=None, interpolate=False, step=None, hold=None, data=None, **kwargs)

Заполнение полигонов между двумя кривыми.

Создаёт PolyCollection для заполнения областей между y1 и y2, где where==True

Параметры:

x : массив Массив x данных длины N y1 : массив Массив (или скаляр) y данных длины N y2 : массив Массив (или скаляр) y данных длины N where : массив, необязательно Если None, заполняется между всеми точками. Если не None, это булевый массив NumPy длины N, и заполнение происходит только в областях, где where==True. interpolate : bool, необязательно Если True, выполняется интерполяция между двумя линиями для определения точной точки пересечения. В противном случае, начальные и конечные точки заполненной области будут только на явных значениях в массиве x. step : {‘pre’, ‘post’, ‘mid’}, необязательно Если не равно None, выполняется заполнение по шагам.

Примечания

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

• Все аргументы с именами: ‘y1’, ‘x’, ‘where’, ‘y2’.

Дополнительные ключевые слова: hold = [True|False] переопределяет состояние hold по умолчанию

Примеры

(Исходный код)

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

matplotlib.pyplot.fill_betweenx(y, x1, x2=0, where=None, step=None, hold=None, data=None, **kwargs)

Заполнение полигонов между двумя горизонтальными кривыми.

Вызов:

fill_betweenx(y, x1, x2=0, where=None, **kwargs)

Создаёт PolyCollection для заполнения областей между x1 и x2, где where==True

Параметры:	y : массив Массив y данных длины N x1 : массив Массив x данных длины N x2 : массив, необязательно Массив x данных длины N where : массив, необязательно Если None, заполняется между всеми точками. Если не None, это булевый массив NumPy длины N, и заполнение происходит только в областях, где where==True step : {‘pre’, ‘post’, ‘mid’}, необязательно Если не None, выполняется заполнение по шагам.

Примечания

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

• Все аргументы с именами: ‘x2’, ‘y’, ‘where’, ‘x1’.

Дополнительные ключевые слова: hold = [True|False] переопределяет состояние hold по умолчанию

Примеры

(Исходный код)

(png, hires.png, pdf)

(png, hires.png, pdf)

matplotlib.pyplot.findobj(o=None, match=None, include_self=True)

Поиск объектов графических элементов.

Рекурсивно находит все экземпляры Artist, содержащиеся в self.

match может быть

• None: возвращает все объекты, содержащиеся в графическом элементе.
• функция с сигнатурой boolean = match(artist) для фильтрации совпадений
• экземпляр класса: например, Line2D. Возвращает только графические элементы класса.

Если include_self равно True (по умолчанию), само self включается в список для проверки совпадения.

matplotlib.pyplot.flag()

Устанавливает цветовое отображение по умолчанию на flag и применяет его к текущему изображению, если оно есть. См. справку help(colormaps) для получения дополнительной информации.

matplotlib.pyplot.gca(**kwargs)

Получить текущий экземпляр Axes на текущей фигуре, соответствующий заданным ключевым словам, или создать его.

См. также

matplotlib.figure.Figure.gca

Метод gca фигуры.

Примеры

Для получения текущих полярных осей на текущей фигуре:

plt.gca(projection='polar')

Если текущие оси не существуют или не являются полярными, соответствующие оси будут созданы и возвращены.

matplotlib.pyplot.gcf()

Получить ссылку на текущую фигуру.

matplotlib.pyplot.gci()

Получить текущий графический элемент. В частности, возвращает текущий экземпляр ScalarMappable (изображение или коллекцию элементов), или None, если изображения или коллекции элементов не определены. Команды imshow() и figimage() создают экземпляры Image, а команды pcolor() и scatter() создают экземпляры Collection. Текущее изображение является атрибутом текущих осей или ближайших предыдущих осей в текущей фигуре, содержащих изображение.

matplotlib.pyplot.get_current_fig_manager()

matplotlib.pyplot.get_figlabels()

Возвращает список существующих меток фигур.

matplotlib.pyplot.get_fignums()

Возвращает список существующих номеров фигур.

matplotlib.pyplot.get_plot_commands()

Получает отсортированный список всех команд построения графиков.

matplotlib.pyplot.ginput(*args, **kwargs)

Подпись вызова:

ginput(self, n=1, timeout=30, show_clicks=True,
       mouse_add=1, mouse_pop=3, mouse_stop=2)

Блокирующий вызов для взаимодействия с фигурой.

Ожидает n щелчков от пользователя и возвращает список координат каждого щелчка.

Если timeout равен нулю или отрицательному значению, таймаут не используется.

Если n равно нулю или отрицательному значению, накапливаются щелчки до тех пор, пока не будет выполнен щелчок средней кнопкой мыши (или, потенциально, одновременно обе кнопки мыши) для прекращения ввода.

Щелкая правой кнопкой мыши, отменяется последний ввод.

Кнопки, используемые для различных действий (добавление точек, удаление точек, завершение ввода), могут быть переопределены с помощью аргументов mouse_add, mouse_pop и mouse_stop, указывающих на соответствующую кнопку мыши: 1 для левой, 2 для средней, 3 для правой.

Клавиатура также может использоваться для выбора точек в случае отсутствия одной или нескольких кнопок на мыши. Кнопки Delete и Backspace работают как щелчок правой кнопкой мыши (т. е. удаление последней точки), клавиша Enter завершает ввод, а любая другая клавиша (не используемая менеджером окон) выбирает точку.

matplotlib.pyplot.gray()

установить стандартную цветовую карту на серую и применить к текущему изображению, если таковое имеется. Для получения дополнительной информации см. help(colormaps)

matplotlib.pyplot.grid(b=None, which='major', axis='both', **kwargs)

Включить или выключить сетку осей.

Вызов функции:

grid(self, b=None, which='major', axis='both', **kwargs)

Включить или выключить сетку осей; b — булево значение. (Для совместимости с MATLAB, b также может быть строкой, 'вкл' или 'выкл').

Если b равно None и len(kwargs)==0, переключить состояние сетки. Если переданы kwargs, предполагается, что вы хотите сетку, и поэтому b устанавливается в True.

which может быть 'major' (по умолчанию), 'minor' или 'both', чтобы контролировать, будут ли затронуты основные сетки делений, второстепенные сетки делений или оба типа.

axis может быть 'both' (по умолчанию), 'x' или 'y', чтобы контролировать, какие линии сетки будут нарисованы.

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

ax.grid(color='r', linestyle='-', linewidth=2)

Допустимые Line2D kwargs

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated	[True | False]
antialiased или aa	[True | False]
axes	экземпляр Axes
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’ | (смещение, последовательность on-off-dash) | '-' | '--' | '-.' | ':' | '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	любое число

matplotlib.pyplot.hexbin(x, y, C=None, gridsize=100, bins=None, xscale='linear', yscale='linear', extent=None, cmap=None, norm=None, vmin=None, vmax=None, alpha=None, linewidths=None, edgecolors='none', reduce_C_function=, mincnt=None, marginals=False, hold=None, data=None, **kwargs)

Создать диаграмму с гексагональными ячейками.

Вызов функции:

hexbin(x, y, C = None, gridsize = 100, bins = None,
       xscale = 'linear', yscale = 'linear',
       cmap=None, norm=None, vmin=None, vmax=None,
       alpha=None, linewidths=None, edgecolors='none'
       reduce_C_function = np.mean, mincnt=None, marginals=True
       **kwargs)

Создаёт диаграмму с гексагональными ячейками для x по y, где x, y — одномерные последовательности одинаковой длины, N. Если C равно None (по умолчанию), это гистограмма количества наблюдений в точках (x[i],y[i]).

Если C задано, оно определяет значения в координатах (x[i],y[i]). Эти значения накапливаются для каждой гексагональной ячейки, а затем обрабатываются в соответствии с функцией reduce_C_function, которая по умолчанию — функция среднего numpy (np.mean). (Если C задано, оно также должно быть одномерной последовательностью той же длины, что и x и y.)

x, y и/или C могут быть массивными, в этом случае будут нанесены только точки без маски.

Дополнительные ключевые аргументы:

gridsize: [ 100 | целое число ]

Количество гексагонов по оси x, по умолчанию 100. Соответствующее количество гексагонов по оси y выбирается таким образом, чтобы гексагоны были приблизительно правильными. Кроме того, gridsize может быть кортежем из двух элементов, определяющих количество гексагонов по осям x и y.

bins: [ None | ‘log’ | целое число | последовательность ]

Если None, никакой группировки по ячейкам не применяется; цвет каждого гексагона напрямую соответствует его счётчику.

Если ‘log’, используется логарифмическая шкала для цветовой карты. Внутренне, используется для определения цвета гексагона.

Если целое число, количество ячеек делится на указанное количество ячеек, и гексагоны окрашиваются соответственно.

Если последовательность значений, значения нижних границ ячеек для использования.

xscale: [ ‘linear’ | ‘log’ ]

Использование линейной или логарифмической шкалы по оси абсцисс.

scale: [ ‘linear’ | ‘log’ ]

Использование линейной или логарифмической шкалы по оси ординат.

mincnt: [ None | положительное целое число ]

Если не None, отображаются только ячейки с количеством точек более mincnt.

marginals: [ True | False ]

Если marginals равно True, отображается краевая плотность в виде прямоугольников с цветовой шкалой внизу по оси x и слева по оси y.

extent: [ None | числа (левая, правая, нижняя, верхняя) ]

Пределы ячеек. По умолчанию пределы определяются на основе gridsize, x, y, xscale и yscale.

Другие ключевые аргументы, управляющие отображением цвета и аргументами нормализации:

cmap: [ None | Colormap ]

экземпляр matplotlib.colors.Colormap. Если None, по умолчанию используется rc image.cmap.

norm: [ None | Normalize ]

matplotlib.colors.Normalize экземпляр используется для масштабирования данных яркости до 0,1.

vmin / vmax: число

vmin и vmax используются совместно с norm для нормализации данных яркости. Если оба равны None, используются минимум и максимум массива цвета C. Обратите внимание, что если вы передаёте экземпляр norm, ваши настройки vmin и vmax будут игнорироваться.

alpha: число от 0 до 1 или None

значение альфа для области.

linewidths: [ None | число ]

Если None, по умолчанию используется rc lines.linewidth. Обратите внимание, что это кортеж, и если вы задаёте аргумент linewidths, вы должны задавать его как последовательность чисел с плавающей точкой, как требуется RegularPolyCollection.

Другие ключевые аргументы, управляющие свойствами коллекции:

edgecolors: [ None | 'none' | mpl color | color sequence ]

Если 'none', рисует грани в том же цвете, что и цвет заливки. Это значение по умолчанию, так как это предотвращает некрасивые неокрашенные пиксели между гексагонами.

Если None, рисует контуры в стандартном цвете.

Если аргумент matplotlib для цвета или последовательность кортежей rgba, рисует контуры в указанном цвете.

Вот стандартные описания всех Collection аргументов:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой или None
animated	[True | False]
antialiased или antialiaseds	Булево значение или последовательность булевых значений
array	неизвестно
axes	экземпляр Axes
clim	последовательность из двух чисел с плавающей точкой
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
cmap	цветовая карта или зарегистрированное имя цветовой карты
color	аргумент цвета matplotlib или последовательность кортежей rgba
contains	вызываемая функция
edgecolor или edgecolors	спецификация цвета matplotlib или последовательность спецификаций
facecolor или facecolors	спецификация цвета matplotlib или последовательность спецификаций
figure	экземпляр matplotlib.figure.Figure
gid	строка-идентификатор
hatch	[ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]
label	строка или что-либо, что можно напечатать с помощью преобразования ‘%s’.
linestyle или linestyles или dashes	[‘сплошная’ | ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ | (смещение, последовательность включений-выключений) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	неизвестно
offset_position	неизвестно
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	неизвестно
picker	[None|число с плавающей точкой|булево|вызываемая функция]
pickradius	неизвестно
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка url
urls	неизвестно
visible	[True | False]
zorder	любое число

Результат — экземпляр PolyCollection; используйте get_array() для получения количества в каждом шестиугольнике. Если marginals равно True, горизонтальная и вертикальная полосы (оба PolyCollections) будут добавлены к возвращаемому набору как атрибуты hbar и vbar.

Пример:

(Исходный код, png, hires.png, pdf)

Примечания

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

• Все аргументы с именами: ‘y’, ‘x’.

Дополнительные ключевые аргументы: hold = [True|False] переопределяет состояние удержания по умолчанию

matplotlib.pyplot.hist(x, bins=10, range=None, normed=False, weights=None, cumulative=False, bottom=None, histtype='bar', align='mid', orientation='vertical', rwidth=None, log=False, color=None, label=None, stacked=False, hold=None, data=None, **kwargs)

Построение гистограммы.

Вычисление и построение гистограммы для x. Возвращаемое значение — кортеж (n, bins, patches) или ([n0, n1, ...], bins, [patches0, patches1,...]) если входные данные содержат несколько наборов данных.

Несколько наборов данных могут быть предоставлены через x в виде списка наборов данных потенциально различной длины ([x0, x1, ...]), или как 2-мерный массив NumPy, где каждый столбец представляет набор данных. Обратите внимание, что форма массива NumPy транспонирована относительно формы списка.

В настоящее время не поддерживаются массивы с масками.

Параметры:	x : (n,) массив или последовательность (n,) массивов Вводные значения, это может быть как один массив, так и последовательность массивов, которые не обязаны иметь одинаковую длину bins : целое число или массив_подобный объект, необязательный Если задано целое число, bins + 1 границ интервалов возвращаются согласованно с numpy.histogram() для версии numpy >= 1.3. Поддерживаются интервалы с неравномерным шагом, если bins является последовательностью. По умолчанию значение 10 range : кортеж или None, необязательный Диапазон значений по осям x. Значения вне диапазона игнорируются. Если не задан, range равен (x.min(), x.max()). Параметр range не имеет эффекта, если bins является последовательностью. Если bins является последовательностью или range задан, автоматическое масштабирование основано на указанном диапазоне интервалов, а не на диапазоне x. Значение по умолчанию None normed : логическое значение, необязательный Если True, первый элемент возвращаемого кортежа будет представлять количество, нормализованное для получения плотности вероятности, т.е., n/(len(x)`dbin), т.е., интеграл гистограммы будет равен 1. Если также stacked = True, сумма гистограмм будет нормализована к 1. Значение по умолчанию False weights : (n, ) массив_подобный объект или None, необязательный Массив весов, имеющий ту же форму, что и x. Каждое значение в x вносит свой связанный вес в подсчет количества интервалов (вместо 1). Если normed равно True, веса нормализуются таким образом, что интеграл плотности в пределах диапазона остается равным 1. Значение по умолчанию None cumulative : логическое значение, необязательный Если True, вычисляется гистограмма, где каждый интервал содержит количество элементов в этом интервале и во всех предыдущих интервалах. Последний интервал содержит общее количество точек данных. Если normed также True, то гистограмма нормализуется так, что последний интервал равен 1. Если cumulative меньше 0 (например, -1), направление накопления меняется. В этом случае, если normed также True, гистограмма нормализуется так, что первый интервал равен 1. Значение по умолчанию False bottom : массив_подобный объект, скаляр или None Положение нижней базовой линии каждого интервала. Если скаляр, база линии каждого интервала смещается на одинаковое значение. Если массив, каждый интервал смещается независимо, и длина bottom должна соответствовать количеству интервалов. Если None, по умолчанию 0. Значение по умолчанию None histtype : {‘bar’, ‘barstacked’, ‘step’, ‘stepfilled’}, необязательный Тип гистограммы для построения. ‘bar’ — традиционная гистограмма в виде столбцов. Если задано несколько наборов данных, столбцы расположены рядом. ‘barstacked’ — гистограмма в виде столбцов, где несколько наборов данных накладываются друг на друга. ‘step’ создает диаграмму в виде линий, по умолчанию без заливки. ‘stepfilled’ создает диаграмму в виде линий, по умолчанию залитые. По умолчанию ‘bar’ align : {‘left’, ‘mid’, ‘right’}, необязательный Управляет тем, как строится гистограмма. ‘left’: столбцы центрированы на левой границе интервала. ‘mid’: столбцы центрированы между границами интервала. ‘right’: столбцы центрированы на правой границе интервала. По умолчанию ‘mid’ orientation : {‘horizontal’, ‘vertical’}, необязательный Если ‘horizontal’, barh будет использоваться для гистограмм в виде столбцов, а параметр bottom будет представлять левые границы. rwidth : скаляр или None, необязательный Относительная ширина столбцов как доля ширины интервала. Если None, ширина вычисляется автоматически. Игнорируется, если histtype равно ‘step’ или ‘stepfilled’. Значение по умолчанию None log : логическое значение, необязательный Если True, ось гистограммы будет задана в логарифмическом масштабе. Если log равно True и x является одномерным массивом, пустые интервалы будут отфильтрованы и возвращены только ненулевые (n, bins, patches). Значение по умолчанию False color : цвет или массив_подобный объект цветов или None, необязательный Спецификация цвета или последовательность спецификаций цвета, по одной на каждый набор данных. По умолчанию (None) используется стандартная последовательность цветов линий. Значение по умолчанию None label : строка или None, необязательный Строка или последовательность строк для соответствия нескольким наборам данных. Диаграммы в виде столбцов имеют несколько блоков данных на набор данных, но метка присваивается только первому, чтобы команда легенды работала как ожидается. Значение по умолчанию None stacked : логическое значение, необязательный Если True, несколько наборов данных накладываются друг на друга. Если False несколько наборов данных расположены рядом, если histtype = ‘bar’, или друг над другом, если histtype = ‘step’ Значение по умолчанию False
Возвращает:	n : массив или список массивов Значения интервалов гистограммы. См. normed и weights для описания возможной семантики. Если входной x является массивом, то это массив длиной nbins. Если входные данные — последовательность массивов [data1, data2,..], то это список массивов со значениями гистограмм для каждого массива в том же порядке. bins : массив Границы интервалов. Длина nbins + 1 (nbins левых границ и правая граница последнего интервала). Всегда единственный массив, даже при передаче нескольких наборов данных. patches : список или список списков Список отдельных блоков, используемых для создания гистограммы, или список таких списков, если переданы несколько наборов входных данных.
Другие параметры:
	kwargs : Patch свойства

См. также

hist2d

2D гистограммы

Примечания

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

• Все аргументы с следующими именами: ‘weights’, ‘x’.

Дополнительные ключевые слова: hold = [True|False] переопределяет состояние удержания по умолчанию

Примеры

(Исходный код, png, hires.png, pdf)

matplotlib.pyplot.hist2d(x, y, bins=10, range=None, normed=False, weights=None, cmin=None, cmax=None, hold=None, data=None, **kwargs)

Построение двумерной гистограммы.

Параметры:	x, y: массив_подобный, форма (n, ) Входные значения bins: [None | int | [int, int] | массив_подобный | [массив, массив]] Спецификация бинов: Если int, количество бинов для двух измерений (nx=ny=bins). Если [int, int], количество бинов в каждом измерении (nx, ny = bins). Если массив_подобный, границы бинов для двух измерений (x_edges=y_edges=bins). Если [массив, массив], границы бинов в каждом измерении (x_edges, y_edges = bins). Значение по умолчанию равно 10. range : массив_подобный shape(2, 2), необязательный, по умолчанию: None Левые и правые границы бинов вдоль каждого измерения (если не указаны явно в параметрах bins): [[xmin, xmax], [ymin, ymax]]. Все значения вне этого диапазона будут считаться выбросами и не будут учтены в гистограмме. normed : boolean, необязательный, по умолчанию: False Нормализовать гистограмму. weights : массив_подобный, форма (n, ), необязательный, по умолчанию: None Массив значений w_i, взвешивающих каждую выборку (x_i, y_i). cmin : скаляр, необязательный, по умолчанию: None Все бины, у которых количество меньше cmin, не будут отображаться, а эти значения количества в возвращаемой гистограмме также будут установлены в nan при возвращении. cmax : скаляр, необязательный, по умолчанию: None Все бины, у которых количество больше cmax, не будут отображаться (установятся в none перед передачей в imshow), и эти значения количества в возвращаемой гистограмме также будут установлены в nan при возвращении.
Возвращаемые значения:	Возвращаемое значение равно (counts, xedges, yedges, Image).
Другие параметры:
	kwargs : pcolorfast() свойства.

См. также

hist

Одномерная гистограмма

Примечания

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

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

Дополнительные kwargs: hold = [True|False] переопределяет состояние hold по умолчанию

Примеры

(Исходный код, png, hires.png, pdf)

matplotlib.pyplot.hlines(y, xmin, xmax, colors='k', linestyles='solid', label='', hold=None, data=None, **kwargs)

Построение горизонтальных линий в каждой y от xmin до xmax.

Параметры:	y : скаляр или последовательность скаляров y-индексы, где нужно построить линии. xmin, xmax : скаляр или 1D массив_подобный Соответствующие начало и конец каждой линии. Если указаны скаляры, все линии будут иметь одинаковую длину. colors : массив_подобный цветов, необязательный, по умолчанию: ‘k’ linestyles : [‘solid’ | ‘dashed’ | ‘dashdot’ | ‘dotted’], необязательный label : строка, необязательный, по умолчанию: ‘’
Возвращаемые значения:	lines : LineCollection
Другие параметры:
	kwargs : LineCollection свойства.

См. также

vlines

вертикальные линии

Примечания

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

• Все аргументы со следующими именами: ‘xmax’, ‘y’, ‘xmin’.

Дополнительные kwargs: hold = [True|False] переопределяет состояние hold по умолчанию

Примеры

(Исходный код, png, hires.png, pdf)

matplotlib.pyplot.hold(b=None)

Установить состояние hold. Если b равно None (по умолчанию), переключает состояние hold, иначе устанавливает состояние hold в булево значение b:

hold()      # toggle hold
hold(True)  # hold is on
hold(False) # hold is off

Когда hold равно True, последующие команды plot будут добавлены к текущим осям. Когда hold равно False, текущие оси и фигура будут очищены при следующей команде plot.

matplotlib.pyplot.hot()

устанавливает цветовую карту по умолчанию на hot и применяет ее к текущему изображению, если таковое имеется. Для получения дополнительной информации см. справку по цветовым картам

matplotlib.pyplot.hsv()

устанавливает цветовую карту по умолчанию на hsv и применяет ее к текущему изображению, если таковое имеется. Для получения дополнительной информации см. справку по цветовым картам

matplotlib.pyplot.imread(*args, **kwargs)

Чтение изображения из файла в массив.

fname может быть строковым путем, допустимым URL или объектом Python-подобным файлу. При использовании объекта файла, он должен быть открыт в двоичном режиме.

Если format задан, попытается прочитать файл этого типа, в противном случае формат определяется из имени файла. Если ничего нельзя определить, используется PNG.

Возвращаемое значение — numpy.array. Для черно-белых изображений возвращаемый массив — MxN. Для RGB изображений возвращаемое значение — MxNx3. Для RGBA изображений возвращаемое значение — MxNx4.

matplotlib может только изначально читать PNG, но если установлена PIL, она будет использовать ее для загрузки изображения и возвращения массива (если это возможно), который может быть использован с imshow(). Обратите внимание, что URL-строки могут быть несовместимы с PIL. Для получения дополнительной информации см. документацию PIL.

matplotlib.pyplot.imsave(*args, **kwargs)

Сохранение массива в виде файла изображения.

Доступные форматы вывода зависят от используемого бэкэнда.

Аргументы:

fname:

Строка, содержащая путь к имени файла, или объект Python, подобный файлу. Если format равно None, а fname — строка, формат вывода определяется из расширения имени файла.

arr:

Массив MxN (яркость), MxNx3 (RGB) или MxNx4 (RGBA).

Ключевые аргументы:

vmin/vmax: [ None | скаляр ]

vmin и vmax устанавливают масштабирование цвета для изображения, фиксируя значения, которые отображаются в пределы цветов цветовой карты. Если vmin или vmax равно None, этот предел определяется по минимальному/максимальному значению в arr.

cmap:

cmap — экземпляр colors.Colormap, например, cm.jet. Если None, по умолчанию используется значение rc image.cmap.

format:

Одно из расширений файлов, поддерживаемых активным бэкэндом. Большинство бэкэндов поддерживают png, pdf, ps, eps и svg.

origin

[ ‘верхний’ | ‘нижний’ ] Указывает, где индекс [0,0] массива находится в левом верхнем или левом нижнем углу осей. По умолчанию используется значение rc image.origin.

dpi

DPI для сохранения в метаданных файла. Это не влияет на разрешение выходного изображения.

matplotlib.pyplot.imshow(X, cmap=None, norm=None, aspect=None, interpolation=None, alpha=None, vmin=None, vmax=None, origin=None, extent=None, shape=None, filternorm=1, filterrad=4.0, imlim=None, resample=None, url=None, hold=None, data=None, **kwargs)

Отображение изображения на осях.

Параметры:	X : массив, форма (n, m) или (n, m, 3) или (n, m, 4) Отображение изображения в X на текущих осях. X может быть массивом с плавающей точкой, массивом uint8 или изображением PIL. Если X является массивом, его форма может быть следующей: MxN – яркость (оттенки серого, только массив с плавающей точкой) MxNx3 – RGB (массив с плавающей точкой или массив uint8) MxNx4 – RGBA (массив с плавающей точкой или массив uint8) Значение каждого компонента массивов MxNx3 и MxNx4 с плавающей точкой должно быть в диапазоне от 0,0 до 1,0; массивы MxN с плавающей точкой могут быть нормализованы. cmap : Colormap, необязательный параметр, значение по умолчанию: None Если None, используется значение по умолчанию из rc image.cmap. cmap игнорируется, когда X содержит информацию RGB(A) aspect : [‘auto’ | ‘equal’ | скаляр], необязательный параметр, значение по умолчанию: None Если ‘auto’, меняет соотношение сторон изображения, чтобы соответствовать соотношению сторон осей. Если ‘equal’, и extent равно None, меняет соотношение сторон осей, чтобы соответствовать соотношению сторон изображения. Если extent не None, соотношение сторон осей меняется, чтобы соответствовать масштабу. Если None, используется значение по умолчанию из rc image.aspect. interpolation : строка, необязательный параметр, значение по умолчанию: None Допустимые значения: ‘none’, ‘nearest’, ‘bilinear’, ‘bicubic’, ‘spline16’, ‘spline36’, ‘hanning’, ‘hamming’, ‘hermite’, ‘kaiser’, ‘quadric’, ‘catrom’, ‘gaussian’, ‘bessel’, ‘mitchell’, ‘sinc’, ‘lanczos’ Если interpolation равно None, используется значение по умолчанию из rc image.interpolation. См. также параметры filternorm и filterrad. Если interpolation равно ‘none’, интерполяция не выполняется на бэкендах Agg, ps и pdf. Другие бэкенды будут использовать ‘nearest’. norm : Normalize, необязательный параметр, значение по умолчанию: None Объект Normalize используется для масштабирования данных яркости до 0, 1. Если None, используется функция по умолчанию: normalize. norm используется только если X является массивом с плавающей точкой. vmin, vmax : скаляр, необязательный параметр, значение по умолчанию: None vmin и vmax используются совместно с norm для нормализации данных яркости. Обратите внимание, если вы передаёте экземпляр norm, ваши настройки для vmin и vmax будут проигнорированы. alpha : скаляр, необязательный параметр, значение по умолчанию: None Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный) origin : [‘upper’ | ‘lower’], необязательный параметр, значение по умолчанию: None Размещение индекса [0,0] массива в верхнем левом или нижнем левом углу осей. Если None, используется значение по умолчанию из rc image.origin. extent : скаляры (левый, правый, нижний, верхний), необязательный параметр, значение по умолчанию: None Положение, в координатах данных, нижне-левого и верхне-правого углов. Если None, изображение позиционируется таким образом, что центры пикселей попадают на индексы (строка, столбец) с нулевым началом. shape : скаляры (столбцы, строки), необязательный параметр, значение по умолчанию: None Для изображений с сырыми буферами filternorm : скаляр, необязательный параметр, значение по умолчанию: 1 Параметр для фильтра масштабирования изображений Antigrain. Из документации Antigrain, если filternorm = 1, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он ничего не делает со значениями исходных чисел с плавающей точкой, он исправляет только целые числа в соответствии с правилом 1,0, что означает, что любая сумма весов пикселей должна быть равна 1,0. Таким образом, функция фильтра должна производить график нужной формы. filterrad : скаляр, необязательный параметр, значение по умолчанию: 4,0 Радиус фильтра для фильтров, имеющих параметр радиуса, т. е. когда интерполяция является одной из: ‘sinc’, ‘lanczos’ или ‘blackman’
Возвращает:	image : AxesImage
Другие параметры:
	kwargs : свойства Artist.

См. также

matshow

Отображение матрицы или массива как изображения.

Примечания

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

• Все позиционные и все ключевые аргументы.

Дополнительные параметры: hold = [True|False] переопределяет состояние hold по умолчанию

Примеры

(Исходный код, png, hires.png, pdf)

matplotlib.pyplot.inferno()

Установить значение по умолчанию для цветовой карты inferno и применить её к текущему изображению, если таковое имеется. Смотрите справку по цветовым картам для получения дополнительной информации.

matplotlib.pyplot.install_repl_displayhook()

Установить обработчик отображения repl, чтобы все устаревшие фигуры автоматически перерисовывались при возвращении управления в repl.

Это работает с терминалами и ядрами IPython, а также с обычными оболочками Python.

matplotlib.pyplot.ioff()

Выключить интерактивный режим.

matplotlib.pyplot.ion()

Включить интерактивный режим.

matplotlib.pyplot.ishold()

Возвращает состояние удержания текущих осей.

matplotlib.pyplot.isinteractive()

Возвращает статус интерактивного режима.

matplotlib.pyplot.jet()

Установить значение по умолчанию для цветовой карты jet и применить её к текущему изображению, если таковое имеется. Смотрите справку по цветовым картам для получения дополнительной информации.

matplotlib.pyplot.legend(*args, **kwargs)

Размещает легенду на оси.

Чтобы создать легенду для линий, которые уже существуют на оси (например, с помощью plot), просто вызовите эту функцию с итерируемым объектом строк, по одной строке для каждого элемента легенды. Например:

ax.plot([1, 2, 3])
ax.legend(['A simple line'])

Однако, чтобы сохранить связь между «меткой» и элементом легенды, предпочтительнее указать метку при создании объекта или используя метод set_label() объекта.

line, = ax.plot([1, 2, 3], label='Inline label')
# Overwrite the label by calling the method.
line.set_label('Label via method')
ax.legend()

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

Для полного управления элементами, которые имеют запись в легенде, можно передать итерируемый объект элементов легенды, за которым следует итерируемый объект меток легенды соответственно:

legend((line1, line2, line3), ('label1', 'label2', 'label3'))

Параметры:

loc : int или строка или пара чисел с плавающей точкой, по умолчанию: ‘верхний правый’ Расположение легенды. Возможные значения: Строковое обозначение расположения Код расположения ‘лучшее’ 0 ‘верхний правый’ 1 ‘верхний левый’ 2 ‘нижний левый’ 3 ‘нижний правый’ 4 ‘правый’ 5 ‘центр слева’ 6 ‘центр справа’ 7 ‘нижний центр’ 8 ‘верхний центр’ 9 ‘центр’ 10 В качестве альтернативы можно указать 2-х элементный кортеж, задающий x, y левого нижнего угла легенды в координатах оси (в этом случае bbox_to_anchor будет проигнорировано). bbox_to_anchor : экземпляр matplotlib.transforms.BboxBase или кортеж чисел с плавающей точкой Указывает произвольное расположение легенды в координатах bbox_transform (по умолчанию - координаты оси). Например, чтобы разместить верхний правый угол легенды в центре оси, можно использовать следующие ключевые слова: loc='upper right', bbox_to_anchor=(0.5, 0.5) ncol : целое число Количество столбцов легенды. По умолчанию 1. prop : None или matplotlib.font_manager.FontProperties или словарь Свойства шрифта легенды. Если None (по умолчанию), будут использоваться текущие значения matplotlib.rcParams. fontsize : целое число или число с плавающей точкой или {‘xx-small’, ‘x-small’, ‘small’, ‘medium’, ‘large’, ‘x-large’, ‘xx-large’} Управляет размером шрифта легенды. Если значение числовое, размер будет абсолютным размером шрифта в пунктах. Строковые значения относительны к текущему размеру шрифта по умолчанию. Этот аргумент используется только если prop не указан. numpoints : None или целое число Количество маркеров в легенде при создании записи легенды для линии/matplotlib.lines.Line2D. По умолчанию None, которое будет взято из legend.numpoints rcParam. scatterpoints : None или целое число Количество маркеров в легенде при создании записи легенды для диаграммы рассеяния/ matplotlib.collections.PathCollection. По умолчанию None, которое будет взято из legend.scatterpoints rcParam. scatteryoffsets : итерируемый объект чисел с плавающей точкой Вертикальное смещение (относительно размера шрифта) для маркеров, созданных для записи легенды диаграммы рассеяния. 0.0 соответствует основанию текста легенды, а 1.0 - верху. Чтобы отобразить все маркеры на одной высоте, установите значение в [0.5]. По умолчанию [0.375, 0.5, 0.3125]. markerscale : None или целое число или число с плавающей точкой Относительный размер маркеров легенды по сравнению с первоначально нарисованными. По умолчанию None, которое будет взято из legend.markerscale rcParam. *markerfirst*: [ *True* | *False* ] если *True*, маркер легенды размещается слева от метки легенды; если *False*, маркер легенды размещается справа от метки легенды frameon : None или bool Определяет, должен ли быть нарисован фрейм вокруг легенды. По умолчанию None, которое будет взято из legend.frameon rcParam. fancybox : None или bool Определяет, должны ли быть включены закругленные углы вокруг FancyBboxPatch, образующей фон легенды. По умолчанию None, которое будет взято из legend.fancybox rcParam. shadow : None или bool Определяет, следует ли рисовать тень за легендой. По умолчанию None, которое будет взято из legend.shadow rcParam. framealpha : None или число с плавающей точкой Управляет прозрачностью фона легенды. По умолчанию None, которое будет взято из legend.framealpha rcParam. mode : {“expand”, None} Если mode установлено в "expand", легенда будет горизонтально расширена для заполнения области оси (или bbox_to_anchor если определяет размер легенды). bbox_transform : None или matplotlib.transforms.Transform Преобразование для области (bbox_to_anchor). Для значения None (по умолчанию) будет использоваться преобразование оси transAxes. title : строка или None Заголовок легенды. По умолчанию нет заголовка (None). borderpad : число с плавающей точкой или None Пробел внутри рамки легенды. Измеряется в единицах размера шрифта. По умолчанию None, которое будет взято из legend.borderpad rcParam. labelspacing : число с плавающей точкой или None Вертикальное расстояние между записями легенды. Измеряется в единицах размера шрифта. По умолчанию None, которое будет взято из legend.labelspacing rcParam. handlelength : число с плавающей точкой или None Длина элементов управления легенды. Измеряется в единицах размера шрифта. По умолчанию None, которое будет взято из legend.handlelength rcParam. handletextpad : число с плавающей точкой или None Отступ между элементом управления легенды и текстом. Измеряется в единицах размера шрифта. По умолчанию None, которое будет взято из legend.handletextpad rcParam. borderaxespad : число с плавающей точкой или None Отступ между осями и рамкой легенды. Измеряется в единицах размера шрифта. По умолчанию None, которое будет взято из legend.borderaxespad rcParam. columnspacing : число с плавающей точкой или None Расстояние между столбцами. Измеряется в единицах размера шрифта. По умолчанию None, которое будет взято из legend.columnspacing rcParam. handler_map : словарь или None Пользовательский словарь, сопоставляющий экземпляры или типы с обработчиком легенды. Это handler_map обновляет обработчик по умолчанию, который находится в matplotlib.legend.Legend.get_legend_handler_map().

Примечания

Не все типы объектов поддерживаются командой legend. Подробности см. в Руководстве по легендам.

Примеры

(Исходный код, png, hires.png, pdf)

matplotlib.pyplot.locator_params(axis='both', tight=None, **kwargs)

Управление поведением локейторов делений.

Ключевые аргументы:

axis

[‘x’ | ‘y’ | ‘both’] Ось, на которой нужно выполнить операцию; по умолчанию — ‘both’.

tight

[True | False | None] Параметр, передаваемый в autoscale_view(). По умолчанию — None, никаких изменений.

Остальные ключевые аргументы передаются непосредственно методу set_params().

Обычно, при построении небольших подграфиков, необходимо уменьшить максимальное число делений и использовать жёсткие границы, например:

ax.locator_params(tight=True, nbins=4)

Поскольку локейтор участвует в автомасштабировании, autoscale_view() вызывается автоматически после изменения параметров.

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

matplotlib.pyplot.loglog(*args, **kwargs)

Построение графика с логарифмической шкалой по обеим осям x и y.

Вызов функции:

loglog(*args, **kwargs)

loglog() поддерживает все ключевые аргументы plot() и matplotlib.axes.Axes.set_xscale() / matplotlib.axes.Axes.set_yscale().

Заметные ключевые аргументы:

basex/basey: скаляр > 1

Основание логарифма по оси x/y

subsx/subsy: [ None | последовательность ]

Положение вспомогательных делений по оси x/y; None по умолчанию использует автоматическое подбор, зависящий от числа десятичных разрядов в графике; см. matplotlib.axes.Axes.set_xscale() / matplotlib.axes.Axes.set_yscale() для подробностей

nonposx/nonposy: [‘mask’ | ‘clip’ ]

Отрицательные или нулевые значения по оси x или y могут быть отфильтрованы как недопустимые или обрезаны до очень малого положительного числа

Остальные допустимые ключевые аргументы являются свойствами Line2D:

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой (от 0,0 — прозрачный до 1,0 — непрозрачный)
animated	[Истина | Ложь]
antialiased или aa	[Истина | Ложь]
axes	экземпляр Axes
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[Истина | Ложь]
clip_path	[ ( Path, Transform) | Patch | Нет ]
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	[Нет | целое число | пара целых чисел длиной 2 | срез | список/массив целых чисел | число с плавающей точкой | пара чисел с плавающей точкой длиной 2]
path_effects	неизвестно
picker	расстояние в пунктах или вызываемая функция выбора fn(artist, event)
pickradius	расстояние в пунктах
rasterized	[Истина | Ложь | Нет]
sketch_params	неизвестно
snap	неизвестно
solid_capstyle	[‘butt’ | ‘round’ | ‘projecting’]
solid_joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
transform	экземпляр matplotlib.transforms.Transform
url	строка url
visible	[Истина | Ложь]
xdata	одномерный массив
ydata	одномерный массив
zorder	любое число

Пример:

(Исходный код, png, hires.png, pdf)