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	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	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
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	(масштаб: float, длина: float, случайность: float)
snap	bool или None
transform	Transform
url	строка
visible	bool
zorder	число с плавающей точкой

set_annotation_clip(b)[source]

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

Параметры:

bbool или None

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

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

Диаграмма «столбец-сектор»

Диаграмма «столбец-сектор»

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

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

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

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

Аннотации

Аннотации