Python matplotlib ArrowStyle用法及代码示例

本文简要介绍 python 语言中 matplotlib.patches.ArrowStyle 的用法。

用法

class matplotlib.patches.ArrowStyle(stylename, **kwargs)

基础：_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")

定义了以下类

类	名字	属性
Curve	-	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	]-	宽度A=1.0，长度A=0.2，角度A=0
BracketB	-[	宽度B=1.0，长度B=0.2，角度B=0
BracketAB	]-[	宽度A=1.0，长度A=0.2，角度A=0，宽度B=1.0，长度B=0.2，角度B=0
BarAB	|-|	宽度A=1.0，角度A=0，宽度B=1.0，角度B=0
BracketCurve	]->	宽度A=1.0，长度A=0.2，角度A=无
CurveBracket	<-[	宽度B=1.0，长度B=0.2，角度B=无
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

有关视觉外观的概述，请参阅注释箭头样式参考。

任何箭头样式类的实例都是可调用对象，其调用签名为：

__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 )

返回具有给定样式名称的子类的实例。

class BarAB(widthA=1.0,angleA=0,widthB=1.0,angleB=0)#

基础：_Curve

两端带有竖线 | 的箭头。

参数：

widthA, widthB 浮点数，默认值：1.0

支架的宽度。

angleA, angleB 浮点数，默认：0 度

支架的方向，逆时针角度。 0 度表示垂直于线。

箭 = '|-|'#

class BracketA(widthA=1.0,lengthA=0.2,angleA=0)#

基础：_Curve

开头带有外方括号的箭头。

参数：

widthA 浮点数，默认值：1.0

支架的宽度。

lengthA 浮点数，默认值：0.2

支架的长度。

angleA 浮点数，默认：0 度

支架的方向，逆时针角度。 0 度表示垂直于线。

箭 = ']-'#

class BracketAB(widthA=1.0,lengthA=0.2,angleA=0,widthB=1.0,lengthB=0.2,angleB=0)#

基础：_Curve

两端带外方括号的箭头。

参数：

widthA, widthB 浮点数，默认值：1.0

支架的宽度。

lengthA, lengthB 浮点数，默认值：0.2

支架的长度。

angleA, angleB 浮点数，默认：0 度

支架的方向，逆时针角度。 0 度表示垂直于线。

箭 = ']-['#

class BracketB(widthB=1.0,lengthB=0.2,angleB=0)#

基础：_Curve

末端带有外方括号的箭头。

参数：

widthB 浮点数，默认值：1.0

支架的宽度。

lengthB 浮点数，默认值：0.2

支架的长度。

angleB 浮点数，默认：0 度

支架的方向，逆时针角度。 0 度表示垂直于线。

箭 = '-['#

class BracketCurve(widthA=1.0,lengthA=0.2,angleA=None)#

基础：_Curve

一个箭头，在它的开头有一个向外的方括号，在结尾有一个头部。

参数：

widthA 浮点数，默认值：1.0

支架的宽度。

lengthA 浮点数，默认值：0.2

支架的长度。

angleA 浮点数，默认：0 度

支架的方向，逆时针角度。 0 度表示垂直于线。

箭 = ']->'#

class 曲线#

基础：_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

括号的比例。

class 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)#

基础：_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

括号的比例。

箭 = '<-'#

class 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)#

基础：_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

括号的比例。

箭 = '<->'#

class 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)#

基础：_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

括号的比例。

箭 = '->'#

class CurveBracket(widthB=1.0,lengthB=0.2,angleB=None)#

基础：_Curve

一个箭头，末端有一个向外的方括号，开头有一个箭头。

参数：

widthB 浮点数，默认值：1.0

支架的宽度。

lengthB 浮点数，默认值：0.2

支架的长度。

angleB 浮点数，默认：0 度

支架的方向，逆时针角度。 0 度表示垂直于线。

箭 = '<-['#

class 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)#

基础：_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

括号的比例。

箭 = '<|-'#

class 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)#

基础：_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

括号的比例。

箭 = '<|-|>'#

class 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)#

基础：_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

括号的比例。

箭 = '-|>'#

class 想要(head_length=0.4,head_width=0.4,tail_width=0.4)#

基础：_Base

一个奇特的箭头。仅适用于二次贝塞尔曲线。

参数：

head_length 浮点数，默认值：0.4

箭头的长度。

head_width 浮点数，默认值：0.4

箭头的宽度。

tail_width 浮点数，默认值：0.4

箭头尾部的宽度。

嬗变(path,mutation_size,linewidth)#

transmute 方法是 ArrowStyle 类的核心，必须在子类中重写。它接收 path 对象(将沿着该对象绘制箭头)和 mutation_size 对象(使用该对象缩放箭头等)。 linewidth 可用于调整路径，使其不会超出给定点。它返回 Path 实例和布尔值的元组。布尔值表示路径是否可以填充。返回值也可以是路径列表和相同长度的布尔值列表。

class 简单的(head_length=0.5,head_width=0.5,tail_width=0.2)#

基础：_Base

一个简单的箭头。仅适用于二次贝塞尔曲线。

参数：

head_length 浮点数，默认值：0.5

箭头的长度。

head_width 浮点数，默认值：0.5

箭头的宽度。

tail_width 浮点数，默认值：0.2

箭头尾部的宽度。

嬗变(path,mutation_size,linewidth)#

transmute 方法是 ArrowStyle 类的核心，必须在子类中重写。它接收 path 对象(将沿着该对象绘制箭头)和 mutation_size 对象(使用该对象缩放箭头等)。 linewidth 可用于调整路径，使其不会超出给定点。它返回 Path 实例和布尔值的元组。布尔值表示路径是否可以填充。返回值也可以是路径列表和相同长度的布尔值列表。

class 楔(tail_width=0.3,shrink_factor=0.5)#

基础：_Base

楔形(？)形状。仅适用于二次贝塞尔曲线。起点的宽度为 tail_width ，终点的宽度为 0。中间的宽度为 shrink_factor*x*tail_width 。

参数：

tail_width 浮点数，默认：0.3

尾巴的宽度。

shrink_factor 浮点数，默认值：0.5

中点处箭头宽度的分数。

嬗变(path,mutation_size,linewidth)#

transmute 方法是 ArrowStyle 类的核心，必须在子类中重写。它接收 path 对象(将沿着该对象绘制箭头)和 mutation_size 对象(使用该对象缩放箭头等)。 linewidth 可用于调整路径，使其不会超出给定点。它返回 Path 实例和布尔值的元组。布尔值表示路径是否可以填充。返回值也可以是路径列表和相同长度的布尔值列表。