matplotlib.patches.ArrowStyle

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

Основы: _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
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	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, 2x.png, png)

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

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

Основы: _Curve

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

Параметры:

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

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

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

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

arrow='|-|'

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

Основы: _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]

Основы: _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

Угловые аннотации к стрелкам скобок

Угловые аннотации к стрелкам скобок

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

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