matplotlib.patches.ConnectionPatch

classmatplotlib.patches.ConnectionPatch(xyA, xyB, coordsA, coordsB=None, axesA=None, axesB=None, arrowstyle='-', connectionstyle='arc3', patchA=None, patchB=None, shrinkA=0.0, shrinkB=0.0, mutation_scale=10.0, mutation_aspect=None, clip_on=False, dpi_cor=<deprecated parameter>, **kwargs)[source]

Bases: matplotlib.patches.FancyArrowPatch

Объект, соединяющий две точки (возможно, в разных осях).

Соединяет точку xyA в системе координат coordsA с точкой xyB в системе координат coordsB.

Допустимые ключи:

Ключ	Описание
arrowstyle	стиль стрелки
connectionstyle	стиль соединения
relpos	по умолчанию (0.5, 0.5)
patchA	по умолчанию рамка текстового объекта
patchB	по умолчанию None
shrinkA	по умолчанию 2 точки
shrinkB	по умолчанию 2 точки
mutation_scale	по умолчанию размер шрифта (в пунктах)
mutation_aspect	по умолчанию 1.
?	любой ключ для matplotlib.patches.PathPatch

coordsA и coordsB — строки, указывающие координаты xyA и xyB.

Свойство	Описание
'figure points'	точки от левого нижнего угла фигуры
'figure pixels'	пиксели от левого нижнего угла фигуры
'figure fraction'	0, 0 — лев. низ. угол фигуры, 1, 1 — прав. верх.
'subfigure points'	точки от левого нижнего угла подрисунка
'subfigure pixels'	пиксели от левого нижнего угла подрисунка
'subfigure fraction'	доля подрисунка, 0, 0 — лев. низ.
'axes points'	точки от левого нижнего угла осей
'axes pixels'	пиксели от левого нижнего угла осей
'axes fraction'	0, 0 — лев. низ. угол осей, 1, 1 — прав. верх.
'data'	используется система координат объекта, к которому относится аннотация (по умолчанию)
'offset points'	смещение (в пунктах) от значения xy
'polar'	можно указать theta, r для аннотации, даже в декартовых графиках. Обратите внимание, что если вы используете полярные оси, вам не нужно указывать полярную систему координат, так как это родная система координат "data".

В качестве альтернативы они могут быть установлены в любом допустимом Transform.

Обратите внимание, что 'subfigure pixels' и 'figure pixels' одинаковы для родительской фигуры, поэтому пользователи, которые хотят использовать код, пригодный для подрисунка, могут использовать 'subfigure pixels'.

Примечание

Использование ConnectionPatch между двумя объектами Axes несовместимо с установкой ограничений на макет. Добавьте элемент непосредственно в Figure, а не в конкретные оси, или исключите его из макета, используя con.set_in_layout(False).

fig, ax = plt.subplots(1, 2, constrained_layout=True)
con = ConnectionPatch(..., axesA=ax[0], axesB=ax[1])
fig.add_artist(con)

draw(renderer)[source]

Отрисовка элемента (и его дочерних элементов) с помощью заданного рендерера.

Это не имеет эффекта, если элемент не отображается (Artist.get_visible возвращает False).

Parameters

rendererRendererBase подкласс.

Примечания

Этот метод переопределён в подклассах элемента.

get_annotation_clip()[source]

Возвращает поведение обрезки.

См. set_annotation_clip для значения возвращаемого результата.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, annotation_clip=<UNSET>, antialiased=<UNSET>, arrowstyle=<UNSET>, capstyle=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, connectionstyle=<UNSET>, dpi_cor=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, fill=<UNSET>, gid=<UNSET>, hatch=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mutation_aspect=<UNSET>, mutation_scale=<UNSET>, patchA=<UNSET>, patchB=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, positions=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[source]

Установить несколько свойств сразу.

Поддерживаемые свойства:

Свойство	Описание
agg_filter	функция фильтра, которая принимает (m, n, 3) массив с плавающей точкой и значение dpi, и возвращает массив (m, n, 3)
alpha	скаляр или None
animated	bool
annotation_clip	bool или None
antialiased или aa	bool или None
arrowstyle	None или ArrowStyle или str, по умолчанию: None
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clip_box	Bbox
clip_on	bool
clip_path	Patch или (Path, Transform) или None
color	цвет
connectionstyle	строка или ConnectionStyle или None, необязательно
dpi_cor	неизвестно
edgecolor или ec	цвет или None
facecolor или fc	цвет или None
figure	Figure
fill	bool
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
linewidth или lw	число с плавающей точкой или None
mutation_aspect	число с плавающей точкой
mutation_scale	число с плавающей точкой
patchA	patches.Patch
patchB	patches.Patch
path_effects	AbstractPathEffect
picker	None или bool или число с плавающей точкой или вызываемая функция
positions	неизвестно
rasterized	bool
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	bool или None
transform	Transform
url	строка
visible	bool
zorder	число с плавающей точкой

set_annotation_clip(b)[source]

Установить поведение обрезки.

Параметры

bbool или None

• False: Комментарий всегда будет отрисован независимо от его положения.
• True: Комментарий будет отрисован только если self.xy находится внутри области осей.
• None: Комментарий будет отрисован только если self.xy находится внутри области осей и self.xycoords == "data".

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