axes

matplotlib.axes

class matplotlib.axes.Axes(fig, rect, axisbg=None, frameon=True, sharex=None, sharey=None, label='', xscale=None, yscale=None, **kwargs)

Объект Axes содержит большинство элементов фигуры: Axis, Tick, Line2D, Text, Polygon и др., и задаёт систему координат.

Экземпляр Axes поддерживает обратные вызовы через атрибут callbacks, который является экземпляром CallbackRegistry. События, к которым можно подключиться, — это ‘xlim_changed’ и ‘ylim_changed’, и обратный вызов будет вызван с func(ax), где ax — экземпляр Axes.

acorr(x, **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’.

Примеры

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

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

add_artist(a)

Добавление любого Artist к оси.

Используйте add_artist только для объектов, для которых нет специального метода «add»; и при необходимости используйте метод, такой как update_datalim или update_datalim_numerix для ручного обновления dataLim, если объект должен быть включён в автоматическое масштабирование.

Возвращает добавленный объект.

add_callback(func)

Добавление функции обратного вызова, которая будет вызываться всякий раз, когда меняется одно из свойств Artist.

Возвращает идентификатор, который полезен для удаления обратного вызова с помощью remove_callback() позднее.

add_collection(collection, autolim=True)

Добавление экземпляра Collection к оси.

Возвращает коллекцию.

add_container(container)

Добавление экземпляра Container к оси.

Возвращает коллекцию.

add_image(image)

Добавление AxesImage к оси.

Возвращает изображение.

add_line(line)

Добавление Line2D в список линий графика

Возвращает линию.

add_patch(p)

Добавление Patch p в список областей оси; область обрезки будет установлена в область обрезки оси. Если преобразование не задано, оно будет установлено в transData.

Возвращает область.

add_table(tab)

Добавление экземпляра Table в список таблиц оси.

Возвращает таблицу.

aname = 'Artist'

angle_spectrum(x, Fs=None, Fc=None, window=None, pad_to=None, sides=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	[Истина | Ложь]
antialiased или aa	[Истина | Ложь]
axes	экземпляр Axes
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[Истина | Ложь]
clip_path	[ ( Path, Transform) | Patch | None ]
color или c	любой цвет matplotlib
contains	вызываемая функция
dash_capstyle	[‘butt’ | ‘round’ | ‘projecting’]
dash_joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
dashes	последовательность включения/выключения чернил в точках
drawstyle	[‘default’ | ‘steps’ | ‘steps-pre’ | ‘steps-mid’ | ‘steps-post’]
figure	экземпляр 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	[Истина | Ложь | None]
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)

См. также

magnitude_spectrum()

angle_spectrum() строит графики величин соответствующих частот.

phase_spectrum()

phase_spectrum() строит графики значения функции в развёрнутом виде.

specgram()

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

Примечания

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

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

annotate(*args, **kwargs)

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

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

Параметры:

s : str Текст аннотации xy : iterable Последовательность длиной 2, определяющая точку (x, y) для аннотации xytext : iterable, optional Последовательность длиной 2, определяющая координаты (x, y) для размещения текста. Если None, по умолчанию используется xy. xycoords : str, Artist, Transform, callable or tuple, optional Система координат, в которой задана 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, callable or tuple, optional Система координат, в которой заданы xytext, которая может отличаться от системы координат, используемой для xy. Все xycoords значения допустимы, а также следующие строки: Свойство Описание ‘offset points’ смещение (в пунктах) от значения xy ‘offset pixels’ смещение (в пикселях) от значения xy по умолчанию используется вход xycoords arrowprops : dict, optional Если не None, свойства для рисования стрелки FancyArrowPatch между xy и xytext. Если arrowprops не содержит ключа 'arrowstyle', допустимые ключи: Ключ Описание width ширина стрелки в пунктах headwidth ширина основания стрелки в пунктах headlength длина стрелки в пунктах shrink доля общей длины, на которую уменьшается с обоих концов ? любой ключ matplotlib.patches.FancyArrowPatch Если arrowprops содержит ключ 'arrowstyle', вышеперечисленные ключи запрещены. Допустимые значения 'arrowstyle': Имя Атрибуты '-' None '->' head_length=0.4,head_width=0.2 '-[' widthB=1.0,lengthB=0.2,angleB=None '|-|' widthA=1.0,widthB=1.0 '-|>' head_length=0.4,head_width=0.2 '<-' head_length=0.4,head_width=0.2 '<->' head_length=0.4,head_width=0.2 '<|-' head_length=0.4,head_width=0.2 '<|-|>' head_length=0.4,head_width=0.2 'fancy' head_length=0.4,head_width=0.4,tail_width=0.4 'simple' head_length=0.5,head_width=0.5,tail_width=0.2 'wedge' tail_width=0.3,shrink_factor=0.5 Допустимые ключи для FancyArrowPatch: Ключ Описание arrowstyle стиль стрелки connectionstyle стиль соединения relpos значение по умолчанию (0.5, 0.5) patchA значение по умолчанию — граница текстового поля patchB значение по умолчанию — None shrinkA значение по умолчанию — 2 пункта shrinkB значение по умолчанию — 2 пункта mutation_scale значение по умолчанию — размер текста (в пунктах) mutation_aspect значение по умолчанию — 1. ? любой ключ matplotlib.patches.PathPatch По умолчанию None annotation_clip : bool, optional Управляет отображением аннотации, когда она выходит за пределы области графика. Если True, аннотация будет отображаться только тогда, когда xy находится внутри области графика. Если False, аннотация всегда будет отображаться независимо от её положения. Значение по умолчанию None, которое ведет себя как True только если xycoords — “data”.

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

Аннотация

apply_aspect(position=None)

Используйте _aspect() и _adjustable() для изменения области графика или пределов просмотра.

arrow(x, y, dx, dy, **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’ | (offset, on-off-dash-seq) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	число с плавающей точкой или None для значения по умолчанию
path_effects	неизвестно
picker	[None|число с плавающей точкой|boolean|функция]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка URL
visible	[True | False]
zorder	любое число

Пример:

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

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.

autoscale_view(tight=None, scalex=True, scaley=True)

Автомасштабировать пределы просмотра, используя пределы данных. Можно выборочно выполнить автомасштабирование только одной оси, например, оси x, установив scaley в False. Автомасштабирование сохраняет любое обратное направление оси, которое уже было выполнено.

Пределы данных не обновляются автоматически при изменении данных объекта-графического элемента после добавления его в экземпляр оси. В этом случае используйте matplotlib.axes.Axes.relim() перед вызовом autoscale_view.

axes

Экземпляр Axes, в котором находится графический элемент, или None.

axhline(y=0, xmin=0, xmax=1, **kwargs)

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

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

См. также

axhspan

например, plot и исходный код

Примечания

Аргументы 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	[Истина | Ложь]
antialiased или aa	[Истина | Ложь]
axes	экземпляр Axes
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[Истина | Ложь]
clip_path	[ (Path, Transform) | Patch | None ]
color или c	любой цвет matplotlib
contains	вызываемая функция
dash_capstyle	[‘butt’ | ‘round’ | ‘projecting’]
dash_joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
dashes	последовательность включения/выключения чернил в точках
drawstyle	[‘default’ | ‘steps’ | ‘steps-pre’ | ‘steps-mid’ | ‘steps-post’]
figure	экземпляр 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	[Истина | Ложь | Нет]
sketch_params	неизвестно
snap	неизвестно
solid_capstyle	[‘butt’ | ‘round’ | ‘projecting’]
solid_joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
transform	экземпляр matplotlib.transforms.Transform
url	строка url
visible	[Истина | Ложь]
xdata	одномерный массив
ydata	одномерный массив
zorder	любое число

axhspan(ymin, ymax, xmin=0, xmax=1, **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’ | (смещение, последовательность включений-выключений) | '-' | '--' | '-.' | ':' | '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)

axis(*v, **kwargs)

Установить свойства осей.

Допустимые подписи:

xmin, xmax, ymin, ymax = axis()
xmin, xmax, ymin, ymax = axis(list_arg)
xmin, xmax, ymin, ymax = axis(string_arg)
xmin, xmax, ymin, ymax = axis(**kwargs)

Параметры:

v : список чисел с плавающей точкой или {‘on’, ‘off’, ‘equal’, ‘tight’, ‘scaled’, ‘normal’, ‘auto’, ‘image’, ‘square’} Необязательный позиционный аргумент Пределы данных осей задаются списком; или команда, относящаяся к осям: Значение Описание ‘on’ Включить линии и метки осей ‘off’ Выключить линии и метки осей ‘equal’ Равномерное масштабирование путём изменения пределов ‘scaled’ Равномерное масштабирование путём изменения размеров рамки ‘tight’ Пределы устанавливаются таким образом, чтобы было видно все данные ‘auto’ Автоматическое масштабирование, заполнение прямоугольника данными ‘normal’ То же, что и ‘auto’; устаревшее ‘image’ ‘scaled’ с пределами осей, равными пределам данных ‘square’ Квадратный график; аналогично ‘scaled’, но изначально принудительно устанавливается xmax-xmin = ymax-ymin emit : bool, необязательно Передаётся функциям set_{x,y}lim, если наблюдатели уведомляются об изменении пределов осей xmin, ymin, xmax, ymax : float, необязательно Пределы осей, которые нужно установить

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

xmin, xmax, ymin, ymax : float Пределы осей

axvline(x=0, ymin=0, ymax=1, **kwargs)

Добавить вертикальную линию через оси.

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

См. также

axhspan

например, plot и исходный код

Примеры

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

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

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

  >>> axvline(x=1)
  

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

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

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

Свойство	Описание
agg_filter	неизвестно
alpha	вещественное число (от 0.0 — прозрачный до 1.0 — непрозрачный)
animated	[Истина | Ложь]
antialiased или aa	[Истина | Ложь]
axes	экземпляр Axes
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[Истина | Ложь]
clip_path	[(Path, Transform) | Patch | None]
color или c	любой цвет matplotlib
contains	функция-обработчик
dash_capstyle	[‘butt’ | ‘round’ | ‘projecting’]
dash_joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
dashes	последовательность включения/выключения чернил в точках
drawstyle	[‘default’ | ‘steps’ | ‘steps-pre’ | ‘steps-mid’ | ‘steps-post’]
figure	экземпляр 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	[Истина | Ложь | None]
sketch_params	неизвестно
snap	неизвестно
solid_capstyle	[‘butt’ | ‘round’ | ‘projecting’]
solid_joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
transform	экземпляр matplotlib.transforms.Transform
url	строка URL
visible	[Истина | Ложь]
xdata	одномерный массив
ydata	одномерный массив
zorder	любое число

axvspan(xmin, xmax, ymin=0, ymax=1, **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)
  

Допустимые ключевые аргументы — свойства 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’ | (смещение, последовательность вкл.-выкл. тире) | '-' | '--' | '-.' | ':' | '--' | '']
linewidth или lw	число с плавающей точкой или None по умолчанию
path_effects	неизвестно
picker	[None|число с плавающей точкой|логическое значение|функция]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка-ссылка
visible	[True | False]
zorder	любое число

См. также

axhspan()

например, plot и исходный код

bar(left, height, width=0.8, bottom=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’.

Примеры

Пример: Стек столбчатая диаграмма.

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

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:

Необязательный массив, используемый для сопоставления цветов со стрелками-флагами

Все аргументы могут быть одномерными или двумерными массивами или последовательностями. Если X и Y отсутствуют, они будут сгенерированы как равномерная сетка. Если U и V являются двумерными массивами, а X и Y - одномерными, и если 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:

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

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

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

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

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

Свойство	Описание
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	[‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (смещение, последовательность вкл/выкл штрихов) | '-' | '--' | '-.' | ':' | '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>]:

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

barh(bottom, width, height=0.8, left=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, будет использоваться для генерации ошибки(ошибок) на столбчатой диаграмме yerr : скаляр или массив-подобный, необязательно, по умолчанию: None если не None, будет использоваться для генерации ошибки(ошибок) на столбчатой диаграмме 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

Постройте вертикальную столбчатую диаграмму.

Примечания

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

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

Свойство	Описание
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	любое число

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, autorange=False)

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

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

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., и 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>]:

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

Примеры

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

(png, hires.png, pdf)

broken_barh(xranges, yrange, **kwargs)

Построение горизонтальных столбцов с разрывами.

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

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

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

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

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

Ключевые аргументы — это свойства matplotlib.collections.BrokenBarHCollection:

Свойство	Описание
agg_filter	неизвестно
alpha	float или 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>]:

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

bxp(bxpstats, positions=None, widths=None, vert=True, patch_artist=False, shownotches=False, showmeans=False, showcaps=True, showbox=True, showfliers=True, boxprops=None, whiskerprops=None, flierprops=None, medianprops=None, capprops=None, meanprops=None, meanline=False, manage_xticks=True)

Функция рисования диаграмм размаха.

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

bxp(self, bxpstats, positions=None, widths=None, vert=True,
    patch_artist=False, shownotches=False, showmeans=False,
    showcaps=True, showbox=True, showfliers=True,
    boxprops=None, whiskerprops=None, flierprops=None,
    medianprops=None, capprops=None, meanprops=None,
    meanline=False, manage_xticks=True):

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

Параметры:

bxpstats : список словарей Список словарей, содержащих статистику для каждого ящика. Необходимые ключи: med: Медиана (скалярное число с плавающей точкой). q1: Первый квартиль (25-й процентиль) (скалярное число с плавающей точкой). q3: Третий квартиль (75-й процентиль) (скалярное число с плавающей точкой). whislo: Нижняя граница нижнего уса (скалярное число с плавающей точкой). whishi: Верхняя граница верхнего уса (скалярное число с плавающей точкой). Необязательные ключи: mean: Среднее значение (скалярное число с плавающей точкой). Требуется, если showmeans=True. fliers: Данные за пределами усов (последовательность чисел с плавающей точкой). Требуется, если showfliers=True. cilo и cihi: Нижние и верхние доверительные интервалы относительно медианы. Требуются, если shownotches=True. label: Название набора данных (строка). Если доступно, используется в качестве метки для ящика. positions : массив, по умолчанию = [1, 2, ..., n] Устанавливает позиции ящиков. Отметки и пределы автоматически устанавливаются в соответствии с позициями. widths : массив, по умолчанию = 0.5 Скалярное или векторное значение, определяющее ширину каждого ящика. По умолчанию 0.5 или 0.15*(distance between extreme positions), если это значение меньше. vert : bool, по умолчанию = False Если True (по умолчанию), создаёт вертикальные ящики. Если False, создаёт горизонтальные ящики. patch_artist : bool, по умолчанию = False Если False создаёт ящики с использованием объекта Line2D. Если True создаёт ящики с использованием объекта Patch. shownotches : bool, по умолчанию = False Если False (по умолчанию), создаёт прямоугольный ящик. Если True, создаёт ящик с выемками. showmeans : bool, по умолчанию = False Если True, включает отображение средних значений. showcaps : bool, по умолчанию = True Если True, включает отображение крышек. showbox : bool, по умолчанию = True Если True, включает отображение ящика. showfliers : bool, по умолчанию = True Если True, включает отображение выбросов. boxprops : dict или None (по умолчанию) Если задано, устанавливает стиль отображения ящиков. whiskerprops : dict или None (по умолчанию) Если задано, устанавливает стиль отображения усов. capprops : dict или None (по умолчанию) Если задано, устанавливает стиль отображения крышек. flierprops : dict или None (по умолчанию) Если задано, устанавливает стиль отображения выбросов. medianprops : dict или None (по умолчанию) Если задано, устанавливает стиль отображения медианы. meanprops : dict или None (по умолчанию) Если задано, устанавливает стиль отображения средних значений. meanline : bool, по умолчанию = False Если True (и showmeans равно True), отображает среднее значение в виде линии, занимающей всю ширину ящика, согласно meanprops. Не рекомендуется, если shownotches также True. В противном случае средние значения отображаются как точки. manage_xticks : bool, по умолчанию = True Если функция должна корректировать xlim и xtick.

Возвращает:

result : словарь Словарь, сопоставляющий каждый компонент диаграммы размаха списку созданных объектов matplotlib.lines.Line2D. Этот словарь имеет следующие ключи (при вертикальных диаграммах размаха): boxes: основная часть диаграммы размаха, отображающая квартили и доверительные интервалы медианы, если они включены. medians: горизонтальные линии на медиане каждого ящика. whiskers: вертикальные линии, простирающиеся до наиболее крайних, не являющихся выбросами, точек данных. caps: горизонтальные линии в конце усов. fliers: точки, представляющие данные, выходящие за пределы усов (выбросы). means: точки или линии, представляющие средние значения.

Примеры

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

(png, hires.png, pdf)

can_pan()

Возвращает True, если этот объект оси поддерживает функцию перемещения/приближения.

can_zoom()

Возвращает True, если этот объект оси поддерживает функцию масштабирования.

cla()

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

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:

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

fmt:

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

manual:

если True, подписи контуров будут размещаться вручную с помощью щелчков мышью. Щелкните левой кнопкой мыши возле контура, чтобы добавить подпись, щелкните правой кнопкой мыши (или, возможно, обеими кнопками мыши одновременно), чтобы закончить добавление подписей. Третья кнопка может использоваться для удаления последней добавленной подписи, но только если подписи не inline. В качестве альтернативы можно использовать клавиатуру для выбора расположения подписей (ввод для завершения размещения подписей, удаление или 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)

clear()

очистить оси

cohere(x, y, NFFT=256, Fs=2, Fc=0, detrend=, window=, noverlap=0, pad_to=None, sides='default', scale_by_freq=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: целое число

Количество точек данных, используемых в каждом блоке для БПФ. Степень двойки наиболее эффективна. Значение по умолчанию — 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 — частоты вектора когерентности.

kwargs применяются к линиям.

Ссылки:

• 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]
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’.

contains(mouseevent)

Проверка, произошла ли нажатие мыши в области осей.

Возвращает True / False, {}

contains_point(point)

Возвращает True, если точка (кортеж из x,y) находится внутри области осей (область, определённая её плашкой). Требуются координаты в пикселях.

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 должны быть двумерными массивами с той же формой, что и Z, или оба должны быть одномерными массивами, такими, что 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: число с плавающей точкой

Значение прозрачности.

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: [уровень0, уровень1, ..., уровеньn]

Список чисел с плавающей точкой, указывающий контурные линии для рисования, в порядке возрастания; например, чтобы нарисовать только нулевой контур, передайте 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 ]

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

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

Если это не ‘neither’, к диапазону контурных уровней автоматически добавляются значения в начале или конце, чтобы охватить все данные. Эти добавленные диапазоны отображаются в специальные цвета цветовой карты, по умолчанию в начале и конце цветовой карты, но могут быть установлены через методы 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 оно может привести к артефактам отрисовки на границах разделения.

Только ключевые аргументы для 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)

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)

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

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: число с плавающей точкой

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

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: [уровень0, уровень1, ..., уровеньn]

Список чисел с плавающей точкой, указывающий на контурные линии для отрисовки в порядке возрастания; например, чтобы нарисовать только нулевой контур, передайте 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. Locator используется для определения контурных уровней, если они не заданы явно с помощью аргумента 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)

convert_xunits(x)

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

convert_yunits(y)

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

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, **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: целое число

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

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

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

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

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

Функция, применяемая к каждому сегменту перед fft, предназначенная для удаления среднего значения или линейной тенденции. В отличие от 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 из вещественных чисел]
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’.

drag_pan(button, key, x, y)

Вызывается при перемещении мыши во время операции панорамирования.

button — номер кнопки мыши:

• 1: ЛЕВАЯ
• 2: СРЕДНЯЯ
• 3: ПРАВАЯ

key — клавиша «Shift»

x, y — координаты мыши в координатах отображения.

Примечание

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

draw(artist, renderer, *args, **kwargs)

Отрисовка всего (линии графика, оси, метки)

draw_artist(a)

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

end_pan()

Вызывается при завершении операции панорамирования (когда кнопка мыши отпущена.)

Примечание

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

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, **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 | цвет mpl ]

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

elinewidth: скаляр

Толщина линий ошибок. Если None, используется толщина линии.

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 и markeredgewith.

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

Свойство	Описание
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	любое число

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

plotline: Line2D instance

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

caplines: список концов (колпачков) отрезков погрешностей

Line2D экземпляры

barlinecols: список

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

Пример:

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

Примечания

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

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

eventplot(positions, orientation='horizontal', lineoffsets=1, linelengths=1, linewidths=None, colors=None, linestyles='solid', **kwargs)

Строит идентичные параллельные линии в заданных позициях.

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

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

Строит параллельные линии в заданных позициях. Массив positions должен быть одномерным или двумерным объектом, где каждая строка соответствует ряду или столбцу линий.

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

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

orientation

: [ ‘horizonal’ | ‘vertical’ ]

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

lineoffsets :

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

linelengths :

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

linewidths :

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

colors

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

linestyles :

[ ‘solid’ | ‘dashed’ | ‘dashdot’ | ‘dotted’ ] или массив этих значений

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

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

Аргументы kwargs — это свойства 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’.

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	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)

Примечания

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

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

fill_between(x, y1, y2=0, where=None, interpolate=False, step=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’.

Примеры

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

(png, hires.png, pdf)

(png, hires.png, pdf)

(png, hires.png, pdf)

fill_betweenx(y, x1, x2=0, where=None, step=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’.

Примеры

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

(png, hires.png, pdf)

(png, hires.png, pdf)

findobj(match=None, include_self=True)

Поиск объектов-артистов.

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

match может быть

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

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

format_coord(x, y)

Возвратить строку форматирования координат x, y

format_cursor_data(data)

Возвратить отформатированную строку данных курсора.

format_xdata(x)

Возвратить отформатированную строку x. Эта функция будет использовать свойство self.fmt_xdata, если оно вызываемое, в противном случае вернётся к формататору основных меток оси x.

format_ydata(y)

Возвратить отформатированную строку y. Эта функция будет использовать свойство fmt_ydata , если оно вызываемое, в противном случае вернётся к формататору основных меток оси y.

get_adjustable()

get_agg_filter()

возвратить функцию фильтра для использования в фильтре agg

get_alpha()

Возвратить значение alpha, используемое для смешивания - не поддерживается на всех бэкендах

get_anchor()

get_animated()

Возвратить состояние анимации артиста

get_aspect()

get_autoscale_on()

Получить, применяется ли автоматическое масштабирование для обеих осей при командах plot

get_autoscalex_on()

Получить, применяется ли автоматическое масштабирование для оси x при командах plot

get_autoscaley_on()

Получить, применяется ли автоматическое масштабирование для оси y при командах plot

get_axes()

Возвратить экземпляр Axes, в котором находится артефакт, или None.

Это устарело в mpl 1.5, пожалуйста, используйте свойство axes. Будет удалено в 1.7 или 2.0.

get_axes_locator()

возвратить axes_locator

get_axis_bgcolor()

Возвратить цвет фона оси

get_axisbelow()

Получить, true или не true для axis below

get_children()

вернуть список дочерних артистов

get_clip_box()

Возвратить clipbox артиста

get_clip_on()

Возвратить, использует ли артефакт обрезку

get_clip_path()

Возвратить clip path артиста

get_contains()

Возвратить тест _contains, используемый артистом, или None для значения по умолчанию.

get_cursor_data(event)

Получить данные курсора для данного события.

get_cursor_props()

Возвратить свойства курсора как (linewidth, color) кортеж, где linewidth — число с плавающей запятой, а color — кортеж RGBA

get_data_ratio()

Возвращает коэффициент масштаба исходных данных.

Этот метод предназначен для переопределения в новых типах проекций.

get_data_ratio_log()

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

get_default_bbox_extra_artists()

get_figure()

Возвращает экземпляр Figure, к которому принадлежит элемент.

get_frame_on()

Получить, отображается ли прямоугольник осей.

get_gid()

Возвращает идентификатор группы.

get_images()

Возвращает список изображений Axes, содержащихся в Axes.

get_label()

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

get_legend()

Возвращает экземпляр Legend, или None, если легенда не определена.

get_legend_handles_labels(legend_handler_map=None)

Возвращает маркеры и метки для легенды.

ax.legend() эквивалентно

h, l = ax.get_legend_handles_labels()
ax.legend(h, l)

get_lines()

Возвращает список линий, содержащихся в Axes.

get_navigate()

Получить, отвечает ли ось на команды навигации.

get_navigate_mode()

Получить состояние кнопки навигационной панели: ‘PAN’, ‘ZOOM’ или None.

get_path_effects()

get_picker()

Возвращает объект пикера, используемый этим элементом.

get_position(original=False)

Возвращает копию прямоугольника осей в виде Bbox.

get_rasterization_zorder()

Получить значение zorder, ниже которого элементы будут растрированы.

get_rasterized()

Возвращает True, если элемент должен быть растрирован.

get_renderer_cache()

get_shared_x_axes()

Возвращает копию объекта группировщика общих осей по оси X.

get_shared_y_axes()

Возвращает копию объекта группировщика общих осей по оси Y.

get_sketch_params()

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

Возвращает:	sketch_params : кортеж или None Кортеж из 3 элементов: scale: Амплитуда колебания перпендикулярно исходной линии. length: Длина колебания вдоль линии. randomness: Коэффициент масштаба, с которым длина сжимается или растягивается. Может вернуть None если параметры наброска не были установлены.

get_snap()

Возвращает настройки привязки, которые могут быть:

• True: привязывать вершины к ближайшему центру пикселя
• False: оставить вершины как есть
• None: (автоматически) Если путь содержит только прямолинейные отрезки, округлять до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

get_tightbbox(renderer, call_axes_locator=True)

Возвращает плотное ограничивающее прямоугольник осей. Размер Bbox в координатах холста.

Если call_axes_locator равен False, он не вызывает атрибут _axes_locator, что необходимо для получения правильного ограничивающего прямоугольника. call_axes_locator==False может быть использован, если вызывающая сторона заинтересована только в относительном размере tightbbox по сравнению с bbox осей.

get_title(loc='center')

Получить заголовок осей.

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

Параметры:	loc : {‘center’, ‘left’, ‘right’}, str, необязательно Какой заголовок получить, по умолчанию ‘center’
Возвращает:	title: str Строка текста заголовка.

get_transform()

Возвращает экземпляр Transform, используемый этим элементом.

get_transformed_clip_path_and_affine()

Возвращает обрезной путь с примененной неаффинной частью его преобразования и оставшейся аффинной частью его преобразования.

get_url()

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

get_visible()

Возвращает видимость элемента.

get_window_extent(*args, **kwargs)

Получить ограничивающий прямоугольник осей в пространстве отображения; args и kwargs пусты.

get_xaxis()

Возвращает экземпляр XAxis.

get_xaxis_text1_transform(pad_points)

Получить преобразование, используемое для отрисовки меток оси X, которое добавит указанное количество отступа (в пунктах) между осью и меткой. Направление X задается в координатах данных, а направление Y — в координатах оси. Возвращает кортеж из 3 элементов:

(transform, valign, halign)

где valign и halign — запрошенные выравнивания текста.

Примечание

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

get_xaxis_text2_transform(pad_points)

Получить преобразование, используемое для отрисовки меток вторичной оси X, которое добавит указанное количество отступа (в пунктах) между осью и меткой. Направление X задается в координатах данных, а направление Y — в координатах оси. Возвращает кортеж из 3 элементов:

(transform, valign, halign)

где valign и halign — запрошенные выравнивания текста.

Примечание

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

get_xaxis_transform(which='grid')

Получить преобразование, используемое для отрисовки меток, делений и линий сетки оси X. Направление X задается в координатах данных, а направление Y — в координатах оси.

Примечание

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

get_xbound()

Возвращает числовые границы оси X, где:

lowerBound < upperBound

get_xgridlines()

Получить линии сетки оси X в виде списка экземпляров Line2D.

get_xlabel()

Получить строку текста метки оси X.

get_xlim()

Получить диапазон оси X [левый, правый].

get_xmajorticklabels()

Получить метки делений оси X в виде списка экземпляров Text.

get_xminorticklabels()

Получить метки мелких делений оси X в виде списка экземпляров matplotlib.text.Text.

get_xscale()

Возвращает строку масштаба оси X: linear, log, logit, symlog.

get_xticklabels(minor=False, which=None)

Получить метки шкал по оси X в виде списка экземпляров Text.

Параметры:	minor : bool Если True, возвращаются метки для вспомогательных делений, иначе - для основных. which : None, (‘minor’, ‘major’, ‘both’) Переопределяет minor. Выбирает, метки каких делений возвращать
Возвращает:	ret : список Список экземпляров Text.

get_xticklines()

Получить линии делений по оси X в виде списка экземпляров Line2D.

get_xticks(minor=False)

Возвратить деления по оси X в виде списка значений.

get_yaxis()

Возвратить экземпляр YAxis.

get_yaxis_text1_transform(pad_points)

Получить преобразование, используемое для отрисовки меток левой оси Y, которое добавит указанное количество отступа (в пунктах) между осью и меткой. Направление X в координатах осей, а направление Y — в координатах данных. Возвращает кортеж из 3 элементов вида:

(transform, valign, halign)

где valign и halign — запрошенные выравнивания текста.

Примечание

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

get_yaxis_text2_transform(pad_points)

Получить преобразование, используемое для отрисовки меток правой оси Y, которое добавит указанное количество отступа (в пунктах) между осью и меткой. Направление X в координатах осей, а направление Y — в координатах данных. Возвращает кортеж из 3 элементов вида:

(transform, valign, halign)

где valign и halign — запрошенные выравнивания текста.

Примечание

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

get_yaxis_transform(which='grid')

Получить преобразование, используемое для отрисовки меток, делений и линий сетки оси Y. Направление X в координатах осей, а направление Y — в координатах данных.

Примечание

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

get_ybound()

Возвратить числовые границы оси Y в формате lowerBound < upperBound.

get_ygridlines()

Получить линии сетки по оси Y в виде списка экземпляров Line2D.

get_ylabel()

Получить строку текста метки оси Y.

get_ylim()

Получить диапазон значений оси Y [bottom, top]

get_ymajorticklabels()

Получить метки основных делений по оси Y в виде списка экземпляров Text.

get_yminorticklabels()

Получить метки вспомогательных делений по оси Y в виде списка экземпляров Text.

get_yscale()

Возвратить строковое представление масштаба оси Y: linear, log, logit, symlog.

get_yticklabels(minor=False, which=None)

Получить метки делений по оси Y в виде списка экземпляров Text.

Параметры:	minor : bool Если True, возвращаются метки для вспомогательных делений, иначе - для основных. which : None, (‘minor’, ‘major’, ‘both’) Переопределяет minor. Выбирает, метки каких делений возвращать
Возвращает:	ret : список Список экземпляров Text.

get_yticklines()

Получить линии делений по оси Y в виде списка экземпляров Line2D.

get_yticks(minor=False)

Возвратить деления по оси Y в виде списка значений.

get_zorder()

Возвратить значение zorder элемента.

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

Включить или выключить отображение сетки на осях.

Вызов:

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

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

Если 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 являются

Свойство	Описание
agg_filter	неизвестно
alpha	число с плавающей точкой (от 0,0 — прозрачный до 1,0 — непрозрачный)
animated	[Истина | Ложь]
antialiased или aa	[Истина | Ложь]
axes	экземпляр Axes
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[Истина | Ложь]
clip_path	[ (Path, Transform) | Patch | None ]
color или c	любой цвет matplotlib
contains	функция-вызов
dash_capstyle	[‘butt’ | ‘round’ | ‘projecting’]
dash_joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
dashes	последовательность включения/выключения чернил в пунктах
drawstyle	[‘default’ | ‘steps’ | ‘steps-pre’ | ‘steps-mid’ | ‘steps-post’]
figure	экземпляр 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	[Истина | Ложь | None]
sketch_params	неизвестно
snap	неизвестно
solid_capstyle	[‘butt’ | ‘round’ | ‘projecting’]
solid_joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
transform	экземпляр matplotlib.transforms.Transform
url	строка url
visible	[Истина | Ложь]
xdata	одномерный массив
ydata	одномерный массив
zorder	любое число

has_data()

Возвращает Истина, если в оси добавлены какие-либо элементы.

Это не должно использоваться для определения необходимости обновления dataLim, и, возможно, оно вообще бесполезно.

have_units()

Возвращает Истина, если единицы измерения установлены для осей x или y

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, **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’ ]

Используйте линейную или логарифмическую (по основанию 10) шкалу на горизонтальной оси.

scale: [ ‘linear’ | ‘log’ ]

Используйте линейную или логарифмическую (по основанию 10) шкалу на вертикальной оси.

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

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

marginals: [ True | False ]

если marginals равно True, строятся маргинальные плотности в виде цветных прямоугольников внизу оси x и слева от оси y

extent: [ None | числовые значения (left, right, bottom, top) ]

Пределы ячеек. По умолчанию пределы задаются на основе 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’.

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, **kwargs)

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

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

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

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

Параметры:	x : массив (n,) или последовательность массивов (n,) Входные значения, это может быть либо один массив, либо последовательность массивов, которые не обязаны иметь одинаковую длину bins : целое число или массив_подобный объект, необязательно Если передано целое число, bins + 1 возвращаются границы интервалов, согласуясь с numpy.histogram() для версии NumPy >= 1.3. Поддерживаются интервалы с неравномерным шагом, если bins является последовательностью. По умолчанию 10 range : кортеж или None, необязательно Диапазон значений, ограничивающий интервалы. Значения вне диапазона игнорируются. Если не указан, range — это (x.min(), x.max()). Диапазон не имеет эффекта, если 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’.

Примеры

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

hist2d(x, y, bins=10, range=None, normed=False, weights=None, cmin=None, cmax=None, **kwargs)

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

Параметры:	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 : массив, форма (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

1D гистограмма

Примечания

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

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

Примеры

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

hitlist(event)

Список дочерних элементов художника, которые содержат событие мыши event.

hlines(y, xmin, xmax, colors='k', linestyles='solid', label='', **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’.

Примеры

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

hold(b=None)

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

hold(b=None)

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

Примеры:

# toggle hold
hold()

# turn hold on
hold(True)

# turn hold off
hold(False)

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

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, **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 Параметр для фильтра масштабирования изображений антиграйн. Согласно документации антиграйн, если filternorm = 1, фильтр нормирует целочисленные значения и исправляет ошибки округления. Он не выполняет никаких операций с исходными значениями с плавающей точкой, он исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна генерировать график правильной формы. filterrad : скаляр, необязательно, по умолчанию: 4.0 Радиус фильтра для фильтров, имеющих параметр радиуса, т. е. когда интерполяция равна ‘sinc’, ‘lanczos’ или ‘blackman’
Возвращает:	image : AxesImage
Другие параметры:
	kwargs : свойства Artist.

См. также

matshow

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

Замечания

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

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

Примеры

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

in_axes(mouseevent)

Возвращает True, если заданное событие мыши (в координатах отображения) находится в области Axes.

invert_xaxis()

Инвертировать ось X.

invert_yaxis()

Инвертировать ось Y.

is_figure_set()

Возвращает True, если элемент привязан к Figure.

is_transform_set()

Возвращает True, если у Artist явно задан преобразователь.

ishold()

Возвращает состояние HOLD оси.

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 В качестве альтернативы может быть кортежем из двух чисел с плавающей точкой, задающих 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 или float Управление альфа-прозрачностью рамки легенды. По умолчанию 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 : float или None Пробел внутри рамки легенды. Измеряется в единицах размера шрифта. По умолчанию None , которое будет принимать значение из legend.borderpad rcParam. labelspacing : float или None Вертикальное расстояние между записями легенды. Измеряется в единицах размера шрифта. По умолчанию None , которое будет принимать значение из legend.labelspacing rcParam. handlelength : float или None Длина элементов легенды. Измеряется в единицах размера шрифта. По умолчанию None , которое будет принимать значение из legend.handlelength rcParam. handletextpad : float или None Отступ между элементом легенды и текстом. Измеряется в единицах размера шрифта. По умолчанию None , которое будет принимать значение из legend.handletextpad rcParam. borderaxespad : float или None Отступ между осями и рамкой легенды. Измеряется в единицах размера шрифта. По умолчанию None , которое будет принимать значение из legend.borderaxespad rcParam. columnspacing : float или None Расстояние между столбцами. Измеряется в единицах размера шрифта. По умолчанию None , которое будет принимать значение из legend.columnspacing rcParam. handler_map : словарь или None Пользовательский словарь, сопоставляющий экземпляры или типы с обработчиками легенды. Это handler_map обновляет словарь обработчиков по умолчанию, который можно найти в matplotlib.legend.Legend.get_legend_handler_map().

Примечания

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

Примеры

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

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, используемого по умолчанию на линейных осях, но это может быть обобщено.

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: