matplotlib.patches.ConnectionPatch

класс matplotlib.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, dpi_cor=<устаревший параметр>, **kwargs)[source]

Bases: matplotlib.patches.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)

__init__(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, dpi_cor=<deprecated parameter>, **kwargs)[source]

Соединяет точку 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)

__module__ = 'matplotlib.patches'

__str__()[source]

Возвращает строковое представление объекта.

draw(renderer)[source]

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

Это не повлияет, если элемент не отображается (Artist.get_visible возвращает False).

Параметры:	rendererRendererBase подкласс.

Примечания

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

get_annotation_clip()[source]

Возвращает поведение обрезки.

См. set_annotation_clip для значения возвращаемого значения.

get_path_in_displaycoord()[source]

Возвращает измененный путь стрелки в координатах отображения.

set_annotation_clip(b)[source]

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

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

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

Столбец из круговой диаграммы

Подключить Simple01

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