matplotlib.patches.ArrowStyle

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

Bases: _Style

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

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

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
КриваяA	<-	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
КриваяB	->	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
КриваяAB	<->	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
Заполненная криваяA	<|-	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
Заполненная криваяB	-|>	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
Заполненная криваяAB	<|-|>	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
СкобкаA	]-	widthA=1.0, lengthA=0.2, angleA=0
СкобкаB	-[	widthB=1.0, lengthB=0.2, angleB=0
СкобкаAB	]-[	widthA=1.0, lengthA=0.2, angleA=0, widthB=1.0, lengthB=0.2, angleB=0
БлокAB	|-|	widthA=1.0, angleA=0, widthB=1.0, angleB=0
СкобкаКривая	]->	widthA=1.0, lengthA=0.2, angleA=None
КриваяСкобка	<-[	widthB=1.0, lengthB=0.2, angleB=None
Простой	simple	head_length=0.5, head_width=0.5, tail_width=0.2
Изящный	fancy	head_length=0.4, head_width=0.4, tail_width=0.4
Клинообразный	wedge	tail_width=0.3, shrink_factor=0.5

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

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

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

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

Примечания

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

(Source code, png)

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

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

Bases: _Curve

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

Параметры:

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

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

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

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

arrow='|-|'

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

Bases: _Curve

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

Параметры:

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

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

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

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

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

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

arrow=']-'

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

Bases: _Curve

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

Параметры:

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

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

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

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

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

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

arrow=']-['

classBracketB(widthB=1.0, lengthB=0.2, angleB=0)[source]

Bases: _Curve

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

Параметры:

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

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

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

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

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

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

arrow='-['

classBracketCurve(widthA=1.0, lengthA=0.2, angleA=None)[source]

Bases: _Curve

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

Параметры:

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

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

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

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

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

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

arrow=']->'

classCurve[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

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

classCurveA(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='<-'

classCurveAB(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='<->'

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

Аннотации углов на стрелках скобок

Аннотации углов на стрелках скобок

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

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