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]

Bases: 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	строка или 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

Аннотации

Аннотации