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

Параметры:

rendererRendererBase подкласс.

Примечания

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

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	bool
annotation_clip	bool или None
antialiased или aa	bool или None
arrowstyle	строка или ArrowStyle
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
fill	bool
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или ls	{'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...}
linewidth или lw	число с плавающей точкой или None
mouseover	bool
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

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

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

Диаграмма "бар-круга"

Диаграмма "бар-круга"

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

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

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

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

Аннотации

Аннотации