matplotlib.patches.FancyArrowPatch

class matplotlib.patches.FancyArrowPatch(posA=None, posB=None, path=None, arrowstyle='simple', arrow_transmuter=None, connectionstyle='arc3', connector=None, patchA=None, patchB=None, shrinkA=2, shrinkB=2, mutation_scale=1, mutation_aspect=None, dpi_cor=1, **kwargs) [source]

Условная фигура-стрелка. Она рисует стрелку, используя ArrowStyle.

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

Если заданы posA и posB, то создаётся путь, соединяющий две точки, согласно connectionstyle. Путь будет обрезаться с помощью patchA и patchB и дополнительно сжат с помощью shrinkA и shrinkB. Стрелка наносится вдоль этого результата пути с помощью параметра arrowstyle.

В качестве альтернативы, если предоставлен path, стрелка рисуется вдоль этого пути, и patchA, patchB, shrinkA и shrinkB игнорируются.

Параметры:

posA, posB : None, tuple, optional (default: None) Координаты (x, y) хвоста и головки стрелки соответственно. path : None, Path (default: None) matplotlib.path.Path экземпляр. Если предоставлен, то стрелка рисуется вдоль этого пути, и patchA, patchB, shrinkA и shrinkB игнорируются. arrowstyle : str or ArrowStyle, optional (default: 'simple') Описывает, как будет нарисована условная стрелка. Это может быть строка с именами доступных стилей стрелок с необязательными параметрами, разделёнными запятыми, или экземпляр ArrowStyle. Необязательные атрибуты предназначены для масштабирования с помощью mutation_scale. Доступны следующие стили стрелок: Класс Имя Атрибуты Curve - None CurveB -> head_length=0.4,head_width=0.2 BracketB -[ widthB=1.0,lengthB=0.2,angleB=None CurveFilledB -|> head_length=0.4,head_width=0.2 CurveA <- head_length=0.4,head_width=0.2 CurveAB <-> head_length=0.4,head_width=0.2 CurveFilledA <|- head_length=0.4,head_width=0.2 CurveFilledAB <|-|> head_length=0.4,head_width=0.2 BracketA ]- widthA=1.0,lengthA=0.2,angleA=None BracketAB ]-[ widthA=1.0,lengthA=0.2,angleA=None,widthB=1.0,lengthB=0.2,angleB=None Fancy fancy head_length=0.4,head_width=0.4,tail_width=0.4 Simple simple head_length=0.5,head_width=0.5,tail_width=0.2 Wedge wedge tail_width=0.3,shrink_factor=0.5 BarAB |-| widthA=1.0,angleA=None,widthB=1.0,angleB=None arrow_transmuter : Игнорируется connectionstyle : str, ConnectionStyle, or None, optional (по умолчанию: 'arc3') Описывает, как posA и posB соединяются. Может быть экземпляром класса ConnectionStyle или строкой с именем стиля соединения с необязательными параметрами, разделёнными запятыми. Доступны следующие стили соединения: Класс Имя Атрибуты Angle angle angleA=90,angleB=0,rad=0.0 Angle3 angle3 angleA=90,angleB=0 Arc arc angleA=0,angleB=0,armA=None,armB=None,rad=0.0 Arc3 arc3 rad=0.0 Bar bar armA=0.0,armB=0.0,fraction=0.3,angle=None connector : Игнорируется patchA, patchB : None, Patch, optional (default: None) Соответствующие фигуры хвоста и головки стрелки. matplotlib.patch.Patch экземпляр. shrinkA, shrinkB : scalar, optional (default: 2) Коэффициент сжатия хвоста и головки стрелки соответственно mutation_scale : scalar, optional (default: 1) Значение, с которым масштабируются атрибуты arrowstyle (например, head_length). mutation_aspect : None, scalar, optional (default: None) Высота прямоугольника будет сжата на это значение перед мутацией, а изменённая область будет растянута на обратное значение. dpi_cor : scalar, optional (default: 1) dpi_cor в настоящее время используется для параметров, связанных с шириной линии, и коэффициента сжатия. Масштаб мутации зависит от этого.

Примечания

Допустимые параметры kwargs:

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

draw(renderer) [source]

Отрисовка Patch на заданном renderer.

get_arrowstyle() [source]

Возвращает объект arrowstyle.

get_connectionstyle() [source]

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

get_dpi_cor() [source]

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

Возвращает:	dpi_cor : scalar

get_mutation_aspect() [source]

Возвращает коэффициент пропорциональности для мутации bbox.

get_mutation_scale() [source]

Возвращает масштаб мутации.

Возвращает:	scale : scalar

get_path() [source]

Возвращает путь стрелки в координатах данных. Используйте метод get_path_in_displaycoord() для получения пути стрелки в координатах отображения.

get_path_in_displaycoord() [source]

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

set_arrowstyle(arrowstyle=None, **kw) [source]

Устанавливает стиль стрелки. Старые атрибуты забываются. Без аргументов (или с arrowstyle=None) возвращает доступные стили стрелок в виде списка строк.

Параметры:	arrowstyle : None, ArrowStyle, str, optional (default: None) Может быть строкой с именем стиля стрелки с необязательными атрибутами, разделёнными запятыми, например: set_arrowstyle("Fancy,head_length=0.2") В качестве альтернативы атрибуты могут быть заданы в качестве ключевых слов, например: set_arrowstyle("fancy", head_length=0.2)

set_connectionstyle(connectionstyle, **kw) [source]

Устанавливает стиль соединения. Старые атрибуты забываются.

Параметры:

connectionstyle : None, ConnectionStyle instance, or string Может быть строкой с именем стиля соединения с необязательными атрибутами, разделёнными запятыми, например: set_connectionstyle("arc,angleA=0,armA=30,rad=10") В качестве альтернативы атрибуты могут быть заданы в качестве ключевых слов, например: set_connectionstyle("arc", angleA=0,armA=30,rad=10) Без каких-либо аргументов (или с connectionstyle=None) возвращает доступные стили в виде списка строк.

set_dpi_cor(dpi_cor) [source]

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

Параметры:	dpi_cor : scalar

set_mutation_aspect(aspect) [source]

Устанавливает коэффициент пропорциональности мутации ограничивающей рамки.

Параметры:	aspect : scalar

set_mutation_scale(scale) [source]

Устанавливает масштаб мутации.

Параметры:	scale : scalar

set_patchA(patchA) [source]

Устанавливает хвостовую область.

Параметры:	patchA : Patch matplotlib.patch.Patch экземпляр.

set_patchB(patchB) [source]

Устанавливает область головы.

Параметры:	patchB : Patch matplotlib.patch.Patch экземпляр.

set_positions(posA, posB) [source]

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

Параметры:	posA, posB : None, tuple Координаты (x,y) хвоста стрелки и головки стрелки соответственно. Если None используется текущее значение.