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)

基类：matplotlib.artist.Artist

线条-线条可以同时具有连接所有顶点的实线样式和每个顶点的标记。此外，实线的绘制受绘图样式的影响，例如，可以在各种样式中创建“阶梯”线。

创建一个 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'

__str__()

返回str（self）。

property axes

这个 Axes 艺术家居住的实例，或 None .

contains(mouseevent)

测试是否 鼠标移动 发生在线路上。

如果事件小于 self.pickradius （默认值：5分）远离它。使用 get_pickradius 或 set_pickradius 获取或设置拾取半径。

参数:

鼠标移动 ： matplotlib.backend_bases.MouseEventmatplotlib.backend_bases.MouseEvent

返回:

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_antialiased()

返回是否使用抗锯齿渲染。

get_c()

Alias get_color .

get_color()

返回线条颜色。

也见 set_color .

get_dash_capstyle()

返回虚线的封口样式。

也见 set_dash_capstyle .

get_dash_joinstyle()

返回虚线的连接样式。

也见 set_dash_joinstyle .

get_data(orig=True)

返回扩展数据Ydata。

如果 orig 是 True ，返回原始数据。

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_markerfacecoloralt()

返回备用标记面颜色。

也见 set_markerfacecoloralt .

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_path()

返回 Path 与此行关联的对象。

get_pickradius()

返回用于包容测试的拾取半径。

见 contains 了解更多详细信息。

get_solid_capstyle()

返回实线的封口样式。

也见 set_solid_capstyle .

get_solid_joinstyle()

返回实线的连接样式。

也见 set_solid_joinstyle .

get_window_extent(renderer)

获取显示空间中的轴边界框。

边界框的宽度和高度为非负。

子类应重写以包含在边界框“紧”计算中。默认值是返回0，0处的空边界框。

使用此函数时要小心，如果艺术家窗口的范围发生更改，结果将不会更新。范围可能因变换堆栈中的任何更改而更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做）。这可能会导致意想不到的行为，在屏幕上交互式图形看起来很好，但保存不正确。

get_xdata(orig=True)

返回扩展数据。

如果 orig 是 True ，返回原始数据，否则返回已处理的数据。

get_xydata()

返回 xy 数据为nx2 numpy数组。

get_ydata(orig=True)

返回Ydata。

如果 orig 是 True ，返回原始数据，否则返回已处理的数据。

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'}

property pickradius

返回用于包容测试的拾取半径。

见 contains 了解更多详细信息。

recache(always=False)

recache_always()

set_aa(b)

Alias set_antialiased .

set_antialiased(b)

设置是否使用抗锯齿渲染。

参数:

b布尔

set_c(color)

Alias set_color .

set_color(color)

设置线条的颜色。

参数:

color颜色

set_dash_capstyle(s)

设置虚线的封口样式。

参数:

s“对接”、“圆形”、“突出”

有关示例，请参见 连接样式和封口样式 .

set_dash_joinstyle(s)

设置虚线的连接样式。

参数:

s'miter'、'round'、'bevel'

有关示例，请参见 连接样式和封口样式 .

set_dashes(seq)

设置短划线顺序。

虚线序列是一个偶数长度的浮动序列，用于描述虚线和点中空格的长度。

例如，（5，2，1，2）描述了由2个点空间分隔的5点和1点虚线组成的序列。

参数:

seq浮动顺序（点中的开/关墨迹）或（无，无）

如果 seq 是空的还是 (None, None) ，则线型将设置为实心。

set_data(*args)

设置x和y数据。

参数:

*args（2，N）阵列或两个一维阵列

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_linewidth(w)

以点为单位设置线宽。

参数:

w浮动

线条宽度，以磅为单位。

set_ls(ls)

Alias set_linestyle .

set_lw(w)

Alias set_linewidth .

set_marker(marker)

设置线条标记。

参数:

标记 ：标记样式字符串， Path 或 MarkerStyle标记样式字符串，

见 markers 对于可能的参数的完整描述。

set_markeredgecolor(ec)

设置标记边缘颜色。

参数:

ec颜色

set_markeredgewidth(ew)

以点为单位设置标记边缘宽度。

参数:

ew浮动

标记边缘宽度，以磅为单位。

set_markerfacecolor(fc)

设置标记面颜色。

参数:

fc颜色

set_markerfacecoloralt(fc)

设置替代标记面颜色。

参数:

fc颜色

set_markersize(sz)

以点为单位设置标记大小。

参数:

sz浮动

标记大小，以磅为单位。

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 相反。

set_pickradius(d)

设置用于安全壳测试的拾取半径。

见 contains 了解更多详细信息。

参数:

d浮动

拾取半径，以点为单位。

set_solid_capstyle(s)

设置实线的封口样式。

参数:

s“对接”、“圆形”、“突出”

有关示例，请参见 连接样式和封口样式 .

set_solid_joinstyle(s)

设置实线的连接样式。

参数:

s'miter'、'round'、'bevel'

有关示例，请参见 连接样式和封口样式 .

set_transform(t)

设置此艺术家使用的转换实例。

参数:

t ： matplotlib.transforms.Transformmatplotlib.transforms.Transform

set_xdata(x)

为X设置数据数组。

参数:

x一维阵列

set_ydata(y)

为Y设置数据数组。

参数:

y一维阵列

update_from(other)

从复制属性 其他 对自己。

validCap = ('butt', 'round', 'projecting')

validJoin = ('miter', 'round', 'bevel')

zorder = 2

使用实例 matplotlib.lines.Line2D

自定义虚线样式

树干图

箱形图

注释绘图

编写自定义图例

图图例演示

图例演示

艺术家内部的艺术家

标注绘图

注释极坐标

图轴自定义简单

简单轴标签

向图形添加线条

Matplotlib艺术家参考

PathPatch对象

单纯寄生虫

寄生轴演示

寄生虫轴演示

按性别划分的学士学位

腐朽

双摆问题

动画线图

示波器

MATPLOTLIB UNCHAINED

数据浏览器

图例拾取

看格拉斯

拾取事件演示

选择事件演示2

多边形编辑器

重采样数据

锚定艺术家

十字光标

模拟演示

设置和获取属性

SVG滤波线

歪斜logp图：使用转换和自定义投影

多个有刺的牙龈

艺术家测试

简单图例02

按钮

复选按钮

单选按钮

滑块演示

跨距选择器

文本框

使用指南

PyPror教程

艺术家辅导

图例指南

闪电教程

转换教程