matplotlib.patches.ArrowStyle

classmatplotlib.patches.ArrowStyle(stylename, **kwargs)[source]

Bases: _Style

ArrowStyle — это контейнерный класс, который определяет несколько классов arrowstyle, используемых для создания стрелки по заданному пути. Они в основном используются с FancyArrowPatch.

Объект arrowstyle можно создать следующим образом:

ArrowStyle.Fancy(head_length=.4, head_width=.4, tail_width=.4)

или:

ArrowStyle("Fancy", head_length=.4, head_width=.4, tail_width=.4)

или:

ArrowStyle("Fancy, head_length=.4, head_width=.4, tail_width=.4")

Определены следующие классы

Класс	Имя	Атрибуты
Кривая	-	None
CurveA	<-	head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None
CurveB	->	head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None
CurveAB	<->	head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None
CurveFilledA	<|-	head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None
CurveFilledB	-|>	head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None
CurveFilledAB	<|-|>	head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None
BracketA	]-	widthA=1.0, lengthA=0.2, angleA=0
BracketB	-[	widthB=1.0, lengthB=0.2, angleB=0
BracketAB	]-[	widthA=1.0, lengthA=0.2, angleA=0, widthB=1.0, lengthB=0.2, angleB=0
BarAB	|-|	widthA=1.0, angleA=0, widthB=1.0, angleB=0
BracketCurve	]->	widthA=1.0, lengthA=0.2, angleA=None
CurveBracket	<-[	widthB=1.0, lengthB=0.2, angleB=None
Simple	simple	head_length=0.5, head_width=0.5, tail_width=0.2
Fancy	fancy	head_length=0.4, head_width=0.4, tail_width=0.4
Wedge	wedge	tail_width=0.3, shrink_factor=0.5

Для обзора визуального вида см. Справочник по стилю стрелок аннотаций.

Любой экземпляр класса arrow style — это вызываемый объект, у которого сигнатура вызова:

__call__(self, path, mutation_size, linewidth, aspect_ratio=1.)

и он возвращает кортеж из экземпляра Path и булевого значения. path — это экземпляр Path, по которому будет нарисована стрелка. mutation_size и aspect_ratio имеют то же значение, что и в BoxStyle. linewidth — это ширина линии, которая будет закрашена. Это предназначено для корректировки положения головки, чтобы она не пересекала точку назначения, но не все классы поддерживают эту функцию.

Примечания

angleA и angleB определяют ориентацию скобки как по часовой стрелке, так и против часовой стрелки в зависимости от типа стрелки. 0 градусов означает перпендикуляр к линии, соединяющей головку и хвост стрелки.

(Source code, 2x.png, png)

Возвращает экземпляр подкласса с заданным именем стиля.

classBarAB(widthA=1.0, angleA=0, widthB=1.0, angleB=0)[source]

Bases: _Curve

Стрелка с вертикальными полосками | на обоих концах.

Parameters:

widthA, widthBfloat, default: 1.0

Ширина скобки.

angleA, angleBfloat, default: 0 градусов

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикуляр к линии.

arrow='|-|'

classBracketA(widthA=1.0, lengthA=0.2, angleA=0)[source]

Bases: _Curve

Стрелка с выходящей квадратной скобкой в начале.

Parameters:

widthAfloat, default: 1.0

Ширина скобки.

lengthAfloat, default: 0.2

Длина скобки.

angleAfloat, default: 0 градусов

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикуляр к линии.

arrow=']-'

classBracketAB(widthA=1.0, lengthA=0.2, angleA=0, widthB=1.0, lengthB=0.2, angleB=0)[source]

Bases: _Curve

Стрелка с выходящими квадратными скобками на обоих концах.

Parameters:

widthA, widthBfloat, default: 1.0

Ширина скобки.

lengthA, lengthBfloat, default: 0.2

Длина скобки.

angleA, angleBfloat, default: 0 градусов

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикуляр к линии.

arrow=']-['

классBracketB(widthB=1.0, lengthB=0.2, angleB=0)[source]

Базы: _Curve

Стрелка с наружной квадратной скобкой в конце.

Параметры:

widthBвещественное число, по умолчанию: 1.0

Ширина скобки.

lengthBвещественное число, по умолчанию: 0.2

Длина скобки.

angleBвещественное число, по умолчанию: 0 градусов

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикулярно линии.

arrow='-['

классBracketCurve(widthA=1.0, lengthA=0.2, angleA=None)[source]

Базы: _Curve

Стрелка с наружной квадратной скобкой в начале и головкой в конце.

Параметры:

widthAвещественное число, по умолчанию: 1.0

Ширина скобки.

lengthAвещественное число, по умолчанию: 0.2

Длина скобки.

angleAвещественное число, по умолчанию: 0 градусов

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикулярно линии.

arrow=']->'

классCurve[source]

Базы: _Curve

Простая кривая без наконечника стрелки.

Параметры:

head_lengthвещественное число, по умолчанию: 0.4

Длина наконечника стрелки, относительно mutation_size.

head_widthвещественное число, по умолчанию: 0.2

Ширина наконечника стрелки, относительно mutation_size.

widthA, widthBвещественное число, по умолчанию: 1.0

Ширина скобки.

lengthA, lengthBвещественное число, по умолчанию: 0.2

Длина скобки.

angleA, angleBвещественное число, по умолчанию: 0

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикулярно линии.

scaleA, scaleBвещественное число, по умолчанию: mutation_size

Масштаб скобок.

классCurveA(head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None)[source]

Базы: _Curve

Стрелка с головкой в начальной точке.

Параметры:

head_lengthвещественное число, по умолчанию: 0.4

Длина наконечника стрелки, относительно mutation_size.

head_widthвещественное число, по умолчанию: 0.2

Ширина наконечника стрелки, относительно mutation_size.

widthA, widthBвещественное число, по умолчанию: 1.0

Ширина скобки.

lengthA, lengthBвещественное число, по умолчанию: 0.2

Длина скобки.

angleA, angleBвещественное число, по умолчанию: 0

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикулярно линии.

scaleA, scaleBвещественное число, по умолчанию: mutation_size

Масштаб скобок.

arrow='<-'

классCurveAB(head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None)[source]

Базы: _Curve

Стрелка с головками как в начале, так и в конце.

Параметры:

head_lengthвещественное число, по умолчанию: 0.4

Длина наконечника стрелки, относительно mutation_size.

head_widthвещественное число, по умолчанию: 0.2

Ширина наконечника стрелки, относительно mutation_size.

widthA, widthBвещественное число, по умолчанию: 1.0

Ширина скобки.

lengthA, lengthBвещественное число, по умолчанию: 0.2

Длина скобки.

angleA, angleBвещественное число, по умолчанию: 0

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикулярно линии.

scaleA, scaleBвещественное число, по умолчанию: mutation_size

Масштаб скобок.

arrow='<->'

classCurveB(head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None)[source]

Bases: _Curve

Стрелка с головкой в конечной точке.

Параметры:

head_lengthfloat, по умолчанию: 0.4

Длина головки стрелки, относительно mutation_size.

head_widthfloat, по умолчанию: 0.2

Ширина головки стрелки, относительно mutation_size.

widthA, widthBfloat, по умолчанию: 1.0

Ширина скобки.

lengthA, lengthBfloat, по умолчанию: 0.2

Длина скобки.

angleA, angleBfloat, по умолчанию: 0

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикулярность к линии.

scaleA, scaleBfloat, по умолчанию: mutation_size

Масштаб скобок.

arrow='->'

classCurveBracket(widthB=1.0, lengthB=0.2, angleB=None)[source]

Bases: _Curve

Стрелка с наружной квадратной скобкой в конце и головкой в начале.

Параметры:

widthBfloat, по умолчанию: 1.0

Ширина скобки.

lengthBfloat, по умолчанию: 0.2

Длина скобки.

angleBfloat, по умолчанию: 0 градусов

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикулярность к линии.

arrow='<-['

classCurveFilledA(head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None)[source]

Bases: _Curve

Стрелка с заполненной треугольной головкой в начале.

Параметры:

head_lengthfloat, по умолчанию: 0.4

Длина головки стрелки, относительно mutation_size.

head_widthfloat, по умолчанию: 0.2

Ширина головки стрелки, относительно mutation_size.

widthA, widthBfloat, по умолчанию: 1.0

Ширина скобки.

lengthA, lengthBfloat, по умолчанию: 0.2

Длина скобки.

angleA, angleBfloat, по умолчанию: 0

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикулярность к линии.

scaleA, scaleBfloat, по умолчанию: mutation_size

Масштаб скобок.

arrow='<|-'

classCurveFilledAB(head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None)[source]

Bases: _Curve

Стрелка с заполненными треугольными головками на обоих концах.

Параметры:

head_lengthfloat, по умолчанию: 0.4

Длина головки стрелки, относительно mutation_size.

head_widthfloat, по умолчанию: 0.2

Ширина головки стрелки, относительно mutation_size.

widthA, widthBfloat, по умолчанию: 1.0

Ширина скобки.

lengthA, lengthBfloat, по умолчанию: 0.2

Длина скобки.

angleA, angleBfloat, по умолчанию: 0

Ориентация скобки, как угол против часовой стрелки. 0 градусов означает перпендикулярность к линии.

scaleA, scaleBfloat, по умолчанию: mutation_size

Масштаб скобок.

arrow='<|-|>'

classCurveFilledB(head_length=0.4, head_width=0.2, widthA=1.0, widthB=1.0, lengthA=0.2, lengthB=0.2, angleA=0, angleB=0, scaleA=None, scaleB=None)[source]

Bases: _Curve

Стрелка с заполненным треугольным наконечником на конце.

Параметры:

head_lengthfloat, по умолчанию: 0.4

Длина стрелочного наконечника, в относительных единицах к mutation_size.

head_widthfloat, по умолчанию: 0.2

Ширина стрелочного наконечника, в относительных единицах к mutation_size.

widthA, widthBfloat, по умолчанию: 1.0

Ширина скобки.

lengthA, lengthBfloat, по умолчанию: 0.2

Длина скобки.

angleA, angleBfloat, по умолчанию: 0

Ориентация скобки, в градусах против часовой стрелки. 0 градусов означает перпендикулярность к линии.

scaleA, scaleBfloat, по умолчанию: mutation_size

Масштаб скобок.

arrow='-|>'

classFancy(head_length=0.4, head_width=0.4, tail_width=0.4)[source]

Bases: _Base

Изогнутая стрелка. Работает только с квадратичной кривой Безье.

Параметры:

head_lengthfloat, по умолчанию: 0.4

Длина стрелочного наконечника.

head_widthfloat, по умолчанию: 0.4

Ширина стрелочного наконечника.

tail_widthfloat, по умолчанию: 0.4

Ширина хвоста стрелки.

transmute(path, mutation_size, linewidth)[source]

Метод transmute — это ядро класса ArrowStyle и должен быть переопределён в подклассах. Он получает объект path, по которому будет нарисована стрелка, и mutation_size, с помощью которого будет масштабирован наконечник стрелки и т. д. linewidth может использоваться для корректировки пути, чтобы он не выходил за заданные точки. Он возвращает кортеж из объекта Path и булевого значения. Булевое значение указывает, можно ли заполнить путь. Возвращаемое значение также может быть списком путей и списком булевых значений той же длины.

classSimple(head_length=0.5, head_width=0.5, tail_width=0.2)[source]

Bases: _Base

Простая стрелка. Работает только с квадратичной кривой Безье.

Параметры:

head_lengthfloat, по умолчанию: 0.5

Длина стрелочного наконечника.

head_widthfloat, по умолчанию: 0.5

Ширина стрелочного наконечника.

tail_widthfloat, по умолчанию: 0.2

Ширина хвоста стрелки.

transmute(path, mutation_size, linewidth)[source]

Метод transmute — это ядро класса ArrowStyle и должен быть переопределён в подклассах. Он получает объект path, по которому будет нарисована стрелка, и mutation_size, с помощью которого будет масштабирован наконечник стрелки и т. д. linewidth может использоваться для корректировки пути, чтобы он не выходил за заданные точки. Он возвращает кортеж из объекта Path и булевого значения. Булевое значение указывает, можно ли заполнить путь. Возвращаемое значение также может быть списком путей и списком булевых значений той же длины.

classWedge(tail_width=0.3, shrink_factor=0.5)[source]

Bases: _Base

Форма клина. Работает только с квадратичной кривой Безье. Начальная точка имеет ширину tail_width, а конечная — 0. В середине ширина равна shrink_factor*x*tail_width.

Параметры:

tail_widthfloat, по умолчанию: 0.3

Ширина хвоста.

shrink_factorfloat, по умолчанию: 0.5

Доля ширины стрелки в средней точке.

transmute(path, mutation_size, linewidth)[source]

Метод transmute — это ядро класса ArrowStyle и должен быть переопределён в подклассах. Он получает объект path, по которому будет нарисована стрелка, и mutation_size, с помощью которого будет масштабирован наконечник стрелки и т. д. linewidth может использоваться для корректировки пути, чтобы он не выходил за заданные точки. Он возвращает кортеж из объекта Path и булевого значения. Булевое значение указывает, можно ли заполнить путь. Возвращаемое значение также может быть списком путей и списком булевых значений той же длины.

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

Углы на скобочных стрелках

Углы на скобочных стрелках

Справочник стилей стрелок аннотаций

Справочник стилей стрелок аннотаций