matplotlib.lines.Line2D¶
-
class
matplotlib.lines.
Line2D
(xdata, ydata, linewidth=None, linestyle=None, color=None, marker=None, markersize=None, markeredgewidth=None, markeredgecolor=None, markerfacecolor=None, markerfacecoloralt='none', fillstyle=None, antialiased=None, dash_capstyle=None, solid_capstyle=None, dash_joinstyle=None, solid_joinstyle=None, pickradius=5, drawstyle=None, markevery=None, **kwargs)[源代码]¶ -
线条-线条可以同时具有连接所有顶点的实线样式和每个顶点的标记。此外,实线的绘制受绘图样式的影响,例如,可以在各种样式中创建“阶梯”线。
创建一个
Line2D
实例与 x 和 y 数据序列 外部数据存储器 , YDATA .其他关键字参数是
Line2D
性能:财产 描述 agg_filter
一种过滤函数,它接受一个(m,n,3)浮点数组和一个dpi值,并返回一个(m,n,3)数组。 alpha
浮动或无 animated
布尔 antialiased
或者aa布尔 clip_box
Bbox
clip_on
布尔 clip_path
面片或(路径、变换)或无 color
或c颜色 contains
未知的 dash_capstyle
“对接”、“圆形”、“突出” dash_joinstyle
'miter'、'round'、'bevel' dashes
浮动顺序(点中的开/关墨迹)或(无,无) data
(2,N)阵列或两个一维阵列 drawstyle
或ds{'default','steps','steps pre','steps mid','steps post'},default:'默认' figure
Figure
fillstyle
'full'、'left'、'right'、'bottom'、'top'、'none' gid
STR in_layout
布尔 label
对象 linestyle
或ls'-'、'-'、'-'、'-'、':'、'、'、'(偏移量、开/关顺序)、… linewidth
或lw浮动 marker
标记样式字符串, Path
或MarkerStyle
markeredgecolor
或mec颜色 markeredgewidth
或者喵喵浮动 markerfacecolor
或mfc颜色 markerfacecoloralt
或mfcalt颜色 markersize
或ms浮动 markevery
None或int or(int,int)或slice或List [int] 或float或(float,float)或List [bool] path_effects
AbstractPathEffect
picker
未知的 pickradius
浮动 rasterized
布尔或无 sketch_params
(比例:浮动,长度:浮动,随机性:浮动) snap
布尔或无 solid_capstyle
“对接”、“圆形”、“突出” solid_joinstyle
'miter'、'round'、'bevel' transform
matplotlib.transforms.Transform
url
STR visible
布尔 xdata
一维阵列 ydata
一维阵列 zorder
浮动 见
set_linestyle()
对于线条样式的描述,set_marker()
对标记的描述,以及set_drawstyle()
用于描述绘图样式。-
__init__
(xdata, ydata, linewidth=None, linestyle=None, color=None, marker=None, markersize=None, markeredgewidth=None, markeredgecolor=None, markerfacecolor=None, markerfacecoloralt='none', fillstyle=None, antialiased=None, dash_capstyle=None, solid_capstyle=None, dash_joinstyle=None, solid_joinstyle=None, pickradius=5, drawstyle=None, markevery=None, **kwargs)[源代码]¶ 创建一个
Line2D
实例与 x 和 y 数据序列 外部数据存储器 , YDATA .其他关键字参数是
Line2D
性能:财产 描述 agg_filter
一种过滤函数,它接受一个(m,n,3)浮点数组和一个dpi值,并返回一个(m,n,3)数组。 alpha
浮动或无 animated
布尔 antialiased
或者aa布尔 clip_box
Bbox
clip_on
布尔 clip_path
面片或(路径、变换)或无 color
或c颜色 contains
未知的 dash_capstyle
“对接”、“圆形”、“突出” dash_joinstyle
'miter'、'round'、'bevel' dashes
浮动顺序(点中的开/关墨迹)或(无,无) data
(2,N)阵列或两个一维阵列 drawstyle
或ds{'default','steps','steps pre','steps mid','steps post'},default:'默认' figure
Figure
fillstyle
'full'、'left'、'right'、'bottom'、'top'、'none' gid
STR in_layout
布尔 label
对象 linestyle
或ls'-'、'-'、'-'、'-'、':'、'、'、'(偏移量、开/关顺序)、… linewidth
或lw浮动 marker
标记样式字符串, Path
或MarkerStyle
markeredgecolor
或mec颜色 markeredgewidth
或者喵喵浮动 markerfacecolor
或mfc颜色 markerfacecoloralt
或mfcalt颜色 markersize
或ms浮动 markevery
None或int or(int,int)或slice或List [int] 或float或(float,float)或List [bool] path_effects
AbstractPathEffect
picker
未知的 pickradius
浮动 rasterized
布尔或无 sketch_params
(比例:浮动,长度:浮动,随机性:浮动) snap
布尔或无 solid_capstyle
“对接”、“圆形”、“突出” solid_joinstyle
'miter'、'round'、'bevel' transform
matplotlib.transforms.Transform
url
STR visible
布尔 xdata
一维阵列 ydata
一维阵列 zorder
浮动 见
set_linestyle()
对于线条样式的描述,set_marker()
对标记的描述,以及set_drawstyle()
用于描述绘图样式。
-
__module__
= 'matplotlib.lines'¶
-
contains
(mouseevent)[源代码]¶ 测试是否 鼠标移动 发生在线路上。
如果事件小于
self.pickradius
(默认值:5分)远离它。使用get_pickradius
或set_pickradius
获取或设置拾取半径。参数: 返回: - contains布尔
是否有任何值在半径范围内。
- details双关语
字典
{{'ind': pointlist}}
在哪里 点列表 是事件位置周围pickradius内的直线点的列表。TODO:按距离对返回的索引进行排序
-
draw
(renderer)[源代码]¶ 使用给定的渲染器绘制艺术家(及其子对象)。
如果艺术家不可见,则此操作无效 (
Artist.get_visible
返回False)。参数: - 渲染器 :
RendererBase
子类。RenderBase子类。
笔记
此方法在Artist子类中被重写。
- 渲染器 :
-
drawStyleKeys
= ['default', 'steps-mid', 'steps-pre', 'steps-post', 'steps']¶
-
drawStyles
= {'default': '_draw_lines', 'steps': '_draw_steps_pre', 'steps-mid': '_draw_steps_mid', 'steps-post': '_draw_steps_post', 'steps-pre': '_draw_steps_pre'}¶
-
fillStyles
= ('full', 'left', 'right', 'bottom', 'top', 'none')¶
-
filled_markers
= ('o', 'v', '^', '<', '>', '8', 's', 'p', '*', 'h', 'H', 'D', 'd', 'P', 'X')¶
-
get_aa
()¶ Alias
get_antialiased
.
-
get_dash_capstyle
()[源代码]¶ 返回虚线的封口样式。
也见
set_dash_capstyle
.
-
get_dash_joinstyle
()[源代码]¶ 返回虚线的连接样式。
也见
set_dash_joinstyle
.
-
get_drawstyle
()[源代码]¶ 返回drawstyle。
也见
set_drawstyle
.
-
get_ds
()¶ Alias
get_drawstyle
.
-
get_fillstyle
()[源代码]¶ 返回标记填充样式。
也见
set_fillstyle
.
-
get_linestyle
()[源代码]¶ 返回线条样式。
也见
set_linestyle
.
-
get_linewidth
()[源代码]¶ 返回以磅为单位的线宽。
也见
set_linewidth
.
-
get_ls
()¶ Alias
get_linestyle
.
-
get_lw
()¶ Alias
get_linewidth
.
-
get_marker
()[源代码]¶ 返回线标记。
也见
set_marker
.
-
get_markeredgecolor
()[源代码]¶ 返回标记边缘颜色。
也见
set_markeredgecolor
.
-
get_markeredgewidth
()[源代码]¶ 返回以点为单位的标记边缘宽度。
也见
set_markeredgewidth
.
-
get_markerfacecolor
()[源代码]¶ 返回标记面颜色。
也见
set_markerfacecolor
.
-
get_markersize
()[源代码]¶ 以点为单位返回标记大小。
也见
set_markersize
.
-
get_markevery
()[源代码]¶ 返回标记子采样的markevery设置。
也见
set_markevery
.
-
get_mec
()¶ Alias
get_markeredgecolor
.
-
get_mew
()¶ Alias
get_markeredgewidth
.
-
get_mfc
()¶ Alias
get_markerfacecolor
.
-
get_mfcalt
()¶ Alias
get_markerfacecoloralt
.
-
get_ms
()¶ Alias
get_markersize
.
-
get_solid_capstyle
()[源代码]¶ 返回实线的封口样式。
也见
set_solid_capstyle
.
-
get_solid_joinstyle
()[源代码]¶ 返回实线的连接样式。
也见
set_solid_joinstyle
.
-
get_window_extent
(renderer)[源代码]¶ 获取显示空间中的轴边界框。
边界框的宽度和高度为非负。
子类应重写以包含在边界框“紧”计算中。默认值是返回0,0处的空边界框。
使用此函数时要小心,如果艺术家窗口的范围发生更改,结果将不会更新。范围可能因变换堆栈中的任何更改而更改,例如更改轴限制、图形大小或使用的画布(如保存图形时所做)。这可能会导致意想不到的行为,在屏幕上交互式图形看起来很好,但保存不正确。
-
is_dashed
()[源代码]¶ 返回直线是否具有虚线样式。
也见
set_linestyle
.
-
lineStyles
= {'': '_draw_nothing', ' ': '_draw_nothing', '-': '_draw_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted', 'None': '_draw_nothing'}¶
-
markers
= {'.': 'point', ',': 'pixel', 'o': 'circle', 'v': 'triangle_down', '^': 'triangle_up', '<': 'triangle_left', '>': 'triangle_right', '1': 'tri_down', '2': 'tri_up', '3': 'tri_left', '4': 'tri_right', '8': 'octagon', 's': 'square', 'p': 'pentagon', '*': 'star', 'h': 'hexagon1', 'H': 'hexagon2', '+': 'plus', 'x': 'x', 'D': 'diamond', 'd': 'thin_diamond', '|': 'vline', '_': 'hline', 'P': 'plus_filled', 'X': 'x_filled', 0: 'tickleft', 1: 'tickright', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 6: 'caretup', 7: 'caretdown', 8: 'caretleftbase', 9: 'caretrightbase', 10: 'caretupbase', 11: 'caretdownbase', 'None': 'nothing', None: 'nothing', ' ': 'nothing', '': 'nothing'}¶
-
set_aa
(b)¶ Alias
set_antialiased
.
-
set_dashes
(seq)[源代码]¶ 设置短划线顺序。
虚线序列是一个偶数长度的浮动序列,用于描述虚线和点中空格的长度。
例如,(5,2,1,2)描述了由2个点空间分隔的5点和1点虚线组成的序列。
参数: - seq浮动顺序(点中的开/关墨迹)或(无,无)
如果 seq 是空的还是
(None, None)
,则线型将设置为实心。
-
set_drawstyle
(drawstyle)[源代码]¶ 设置绘图样式。
drawstyle决定了点的连接方式。
参数: - drawstyle{'default','steps','steps pre','steps mid','steps post'},default:'默认'
对于“默认”,这些点用直线连接。
台阶变体用阶梯状线连接点,即水平线和垂直台阶。它们在台阶的位置不同:
- “steps pre”:步骤位于线段的开始处,即直线将位于右侧点的y值处。
- “步骤中间”:步骤位于点之间的中间。
- '步骤后:步骤位于线段的末尾,即直线将位于该点左侧的y值处。
- “steps”等于“steps pre”,并为向后兼容而进行维护。
有关示例,请参见 步骤演示 .
-
set_ds
(drawstyle)¶ Alias
set_drawstyle
.
-
set_fillstyle
(fs)[源代码]¶ 设置标记填充样式。
参数: - fs'full'、'left'、'right'、'bottom'、'top'、'none'
可能值:
- “full”:用 标记彩色 .
- “left”、“right”、“bottom”、“top”:用 标记彩色 . 标记的另一半填充 马克脸色拉 .
- “无”:不填充。
有关示例,请参见 标记填充样式 .
-
set_linestyle
(ls)[源代码]¶ 设置线的线型。
参数: - ls'-'、'-'、'-'、'-'、':'、'、'、'(偏移量、开/关顺序)、…
可能值:
字符串:
线条样式 描述 '-'
or'solid'
实线 '--'
or'dashed'
虚线 '-.'
or'dashdot'
虚线 ':'
or'dotted'
虚线 'None'
or' '
or''
一无所获 或者,可以提供以下形式的破折号元组:
(offset, onoffseq)
在哪里?
onoffseq
是一个偶数长度的开/关墨水输入点元组。另请参见set_dashes()
.
有关示例,请参见 直线运动 .
-
set_ls
(ls)¶ Alias
set_linestyle
.
-
set_lw
(w)¶ Alias
set_linewidth
.
-
set_marker
(marker)[源代码]¶ 设置线条标记。
参数: - 标记 :标记样式字符串,
Path
或MarkerStyle
标记样式字符串, 见
markers
对于可能的参数的完整描述。
- 标记 :标记样式字符串,
-
set_markevery
(every)[源代码]¶ 使用标记时,将MarkEvery属性设置为对绘图进行子采样。
例如,如果
every=5
,将绘制每5个标记。参数: - everyNone或int or(int,int)或slice或List [int] 或float或(float,float)或List [bool]
要绘制哪些标记。
- 每=无,将绘制每个点。
- 每=n,将从标记0开始绘制每个第n个标记。
- 每个=(start,n),每个n个标记,从点开始,将被绘制。
- 将绘制每个=切片(开始、结束、n)、每个第n个标记(从点开始到但不包括点结束)。
- 每= [我,J,M,N] ,将只绘制点i、j、m和n处的标记。
- 每= [真,假,真] ,将绘制正确的位置。
- 每=0.1(即浮点数),标记将沿直线以近似相等的距离间隔;标记之间的直线距离通过将轴边界框对角线的显示坐标距离乘以每的值来确定。
- every=(0.5,0.1)(即float的长度为2元组),显示的功能与every=0.1相同,但第一个标记将是0.5乘以沿直线的显示坐标对角线距离。
有关示例,请参见 市场演示 .
笔记
设置markevery属性将仅在实际数据点显示标记。当使用float参数在不规则间隔的数据上设置markevery属性时,由于实际数据点与标记之间的理论间距不一致,标记可能不会均匀间隔显示。
当使用起始偏移量指定第一个标记时,偏移量将从第一个数据点开始,如果放大绘图,则可能与第一个可见数据点不同。
如果在使用浮点参数时放大绘图,则具有标记的实际数据点将发生变化,因为标记之间的距离始终由显示坐标轴边界框对角线确定,而不考虑实际轴数据限制。
-
set_mec
(ec)¶ Alias
set_markeredgecolor
.
-
set_mew
(ew)¶ Alias
set_markeredgewidth
.
-
set_mfc
(fc)¶ Alias
set_markerfacecolor
.
-
set_mfcalt
(fc)¶ Alias
set_markerfacecoloralt
.
-
set_ms
(sz)¶ Alias
set_markersize
.
-
set_picker
(p)[源代码]¶ 定义艺术家的采摘行为。
参数: - picker无、布尔或可呼叫
这可以是以下情况之一:
None :此艺术家禁用拾取(默认)。
布尔值:如果 True 然后将启用拾取,并且如果鼠标事件位于艺术家上方,艺术家将触发拾取事件。
一个函数:如果picker是可调用的,它是一个用户提供的函数,用于确定艺术家是否被鼠标事件击中:
hit, props = picker(artist, mouseevent)
以确定命中测试。如果鼠标事件在艺术家上方,则返回 hit=True props是一个你想要添加到pickevent属性的属性字典。
贬低 为了
Line2D
只是, 捡拾器 也可以是一个float,用于设置检查事件是否“在”行上发生的容差;这是不推荐使用的。使用Line2D.set_pickradius
相反。
-
validCap
= ('butt', 'round', 'projecting')¶
-
validJoin
= ('miter', 'round', 'bevel')¶
-
zorder
= 2¶
-