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 实例与 xy 数据序列 外部数据存储器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 标记样式字符串, PathMarkerStyle
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 实例与 xy 数据序列 外部数据存储器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 标记样式字符串, PathMarkerStyle
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_pickradiusset_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。

如果 origTrue ,返回原始数据。

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)[源代码]

返回扩展数据。

如果 origTrue ,返回原始数据,否则返回已处理的数据。

get_xydata()[源代码]

返回 xy 数据为nx2 numpy数组。

get_ydata(orig=True)[源代码]

返回Ydata。

如果 origTrue ,返回原始数据,否则返回已处理的数据。

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)[源代码]

设置线条标记。

参数:
标记 :标记样式字符串, PathMarkerStyle标记样式字符串,

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)[源代码]

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

参数:
tmatplotlib.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