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)[исходный код]

Базовые классы: FancyArrowPatch

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

Соединяет точку 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
'axes pixels'	пиксели относительно нижнего левого угла объекта Axes
'axes fraction'	0, 0 — нижний левый угол объекта Axes, а 1, 1 — верхний правый
'data'	используется система координат аннотируемого объекта (по умолчанию)
'offset points'	смещение (в пунктах) относительно значения xy
'polar'	для аннотации можно задать theta, r, даже на декартовых графиках. Обратите внимание: если используется полярный объект Axes, указывать polar для системы координат не нужно, поскольку «data» является его собственной системой координат.

Кроме того, им можно задать любое допустимое преобразование Transform.

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

Примечание

Использование ConnectionPatch для соединения двух экземпляров Axes несовместимо напрямую с компоновкой с ограничениями. Добавьте художника непосредственно в Figure, а не в конкретный объект Axes, либо исключите его из компоновки с помощью 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)[исходный код]

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

Ничего не делает, если художник невидим (метод Artist.get_visible возвращает False).

Параметры:

rendererподкласс RendererBase.

Примечания

Этот метод переопределяется в подклассах Artist.

get_annotation_clip()[исходный код]

Возвращает поведение отсечения аннотации.

Описание возвращаемого значения см. в 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>, hatch_linewidth=<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>)[исходный код]

Задаёт сразу несколько свойств.

Поддерживаются следующие свойства:

Свойство	Описание
agg_filter	функция фильтрации, принимающая массив float размером (m, n, 3) и значение dpi и возвращающая массив размером (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	float или None
animated	bool
annotation_clip	bool или None
antialiased или aa	bool или None
arrowstyle	[ '-' | '<-' | '->' | '<->' | '<|-' | '-|>' | '<|-|>' | ']-' | '-[' | ']-[' | '|-|' | ']->' | '<-[' | 'simple' | 'fancy' | 'wedge' ]
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
color	цвет
connectionstyle	[ 'arc3' | 'angle3' | 'angle' | 'arc' | 'bar' ]
edgecolor или ec	цвет или None
facecolor или fc	цвет или None
figure	Figure или SubFigure
fill	bool
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	неизвестно
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	object
linestyle или ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth или lw	float или None
mouseover	bool
mutation_aspect	float
mutation_scale	float
patchA	patches.Patch
patchB	patches.Patch
path_effects	список объектов AbstractPathEffect
picker	None, bool, float или вызываемый объект
positions	неизвестно
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	str
visible	bool
zorder	float

set_annotation_clip(b)[исходный код]

Задаёт поведение отсечения аннотации.

Параметры:

bbool или None

• True: аннотация будет отсечена, если self.xy находится за пределами объекта Axes.
• False: аннотация будет отрисовываться всегда.
• None: аннотация будет отсечена, если self.xy находится за пределами объекта Axes и self.xycoords == "data".

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

Анимация нескольких объектов Axes

Анимация нескольких объектов Axes

Столбец из секторов

Столбец из секторов

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

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

Аннотации

Аннотации