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

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

Или они могут быть установлены на любое допустимое значение 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>, edgecolor=<UNSET>, facecolor=<UNSET>, fill=<UNSET>, gid=<UNSET>, hatch=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<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	Функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
animated	логическое значение
annotation_clip	логическое значение или None
antialiased или aa	логическое значение или None
arrowstyle	строка или matplotlib.patches.ArrowStyle
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clip_box	Bbox
clip_on	логическое значение
clip_path	Объект Patch или (Path, Transform) или None
color	цвет
connectionstyle	[ 'arc3' | 'angle3' | 'angle' | 'arc' | 'bar' ]
edgecolor или ec	цвет или None
facecolor или fc	цвет или None
figure	Figure
fill	логическое значение
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	логическое значение
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или ls	{'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...}
linewidth или lw	вещественное число или None
mouseover	логическое значение
mutation_aspect	вещественное число
mutation_scale	вещественное число
patchA	patches.Patch
patchB	patches.Patch
path_effects	AbstractPathEffect
picker	None или логическое значение или вещественное число или вызываемая функция
positions	неизвестно
rasterized	логическое значение
sketch_params	(масштаб: вещественное число, длина: вещественное число, случайность: вещественное число)
snap	логическое значение или None
transform	Transform
url	строка
visible	логическое значение
zorder	вещественное число

set_annotation_clip(b)[source]

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

Параметры:

bbool или None

• True: Аннотация будет обрезана, когда self.xy находится вне области осей.
• False: Аннотация всегда будет отрисована.
• None: Аннотация будет обрезана, когда self.xy находится вне области осей и self.xycoords == "data".

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

Диаграмма "столбец-пирог"

Диаграмма "столбец-пирог"

Подключить Simple01

Подключить Simple01

Руководство по ограниченному макету

Руководство по ограниченному макету