matplotlib.lines.Line2D #

类 matplotlib.lines。Line2D ( xdata , ydata , * , linewidth = None , linestyle = None , color = None , gapcolor = 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 ) [来源] #

基地：Artist

一条线 - 这条线既可以具有连接所有顶点的实线样式，也可以具有每个顶点处的标记。此外，实线的绘制受drawstyle的影响，例如，可以创建各种样式的“阶梯”线。

使用xdata和ydata序列中的x和y数据创建一个Line2D实例。

其他关键字参数是Line2D属性：

财产

描述

agg_filter

一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量

alpha

标量或无

animated

布尔

antialiased或aa

布尔

clip_box

Bbox

clip_on

布尔

clip_path

补丁或（路径，变换）或无

color或 c

颜色

dash_capstyle

CapStyle或 {'butt', 'projecting', 'round'}

dash_joinstyle

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

gapcolor

颜色或无

gid

字符串

in_layout

布尔

label

目的

linestyle或 ls

{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}

linewidth或 lw

漂浮

marker

标记样式字符串，Path或MarkerStyle

markeredgecolor或机械

颜色

markeredgewidth或者喵喵

漂浮

markerfacecolor或 mfc

颜色

markerfacecoloralt或 mfcalt

颜色

markersize或毫秒

漂浮

markevery

无或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]

mouseover

布尔

path_effects

AbstractPathEffect

picker

浮动或可调用[[艺术家，事件]，元组[布尔，字典]]

pickradius

未知

rasterized

布尔

sketch_params

（比例：浮动，长度：浮动，随机性：浮动）

snap

布尔或无

solid_capstyle

CapStyle或 {'butt', 'projecting', 'round'}

solid_joinstyle

JoinStyle或 {'miter', 'round', 'bevel'}

transform

未知

url

字符串

visible

布尔

xdata

一维数组

ydata

一维数组

zorder

漂浮

财产	描述
`agg_filter`	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
`alpha`	标量或无
`animated`	布尔
`antialiased`或aa	布尔
`clip_box`	`Bbox`
`clip_on`	布尔
`clip_path`	补丁或（路径，变换）或无
`color`或 c	颜色
`dash_capstyle`	`CapStyle`或 {'butt', 'projecting', 'round'}
`dash_joinstyle`	`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'}
`gapcolor`	颜色或无
`gid`	字符串
`in_layout`	布尔
`label`	目的
`linestyle`或 ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth`或 lw	漂浮
`marker`	标记样式字符串，`Path`或`MarkerStyle`
`markeredgecolor`或机械	颜色
`markeredgewidth`或者喵喵	漂浮
`markerfacecolor`或 mfc	颜色
`markerfacecoloralt`或 mfcalt	颜色
`markersize`或毫秒	漂浮
`markevery`	无或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
`mouseover`	布尔
`path_effects`	`AbstractPathEffect`
`picker`	浮动或可调用[[艺术家，事件]，元组[布尔，字典]]
`pickradius`	未知
`rasterized`	布尔
`sketch_params`	（比例：浮动，长度：浮动，随机性：浮动）
`snap`	布尔或无
`solid_capstyle`	`CapStyle`或 {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle`或 {'miter', 'round', 'bevel'}
`transform`	未知
`url`	字符串
`visible`	布尔
`xdata`	一维数组
`ydata`	一维数组
`zorder`	漂浮

有关set_linestyle()线条样式 set_marker()的说明、标记 set_drawstyle()的说明以及绘制样式的说明，请参阅。

包含( mouseevent ) [来源] #

测试一下是否发生了鼠标事件就行了。

如果一个事件与它的距离小于self.pickradius（默认值：5 点），则认为该事件已发生在“线上”。使用 get_pickradius或set_pickradius获取或设置拾取半径。

参数：

鼠标事件matplotlib.backend_bases.MouseEvent

返回：

包含布尔

是否有任何值在半径内。

详细信息字典

字典，其中pointlist是在事件位置周围的拾取半径内的线的点列表。{'ind': pointlist}

TODO：按距离对返回的索引进行排序

绘制（渲染器）[来源] #

使用给定的渲染器绘制艺术家（及其子级）。

如果艺术家不可见，这将无效（Artist.get_visible 返回 False）。

参数：

渲染器RendererBase子类。

笔记

此方法在 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') #

填充标记=（'o'，'v'，'^'，'<'，'>'，'8'，'s'，'p'，'*'，'h'，'H'，'D' , 'd', 'P', 'X') #

get_aa ( ) [来源] #: 的别名get_antialiased。

get_antialiased ( ) [来源] #: 返回是否使用抗锯齿渲染。

get_bbox ( ) [来源] #: 获取这条线的边界框。

get_c ( ) [来源] #: 的别名get_color。

get_color ( ) [来源] #

返回线条颜色。

另请参阅set_color。

get_dash_capstyle ( ) [来源] #

返回CapStyle虚线。

另请参阅set_dash_capstyle。

get_dash_joinstyle ( ) [来源] #

返回JoinStyle虚线。

另请参阅set_dash_joinstyle。

get_data ( orig = True ) [来源] #

成对返回行数据。(xdata, ydata)

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

get_drawstyle ( ) [来源] #

返回绘图样式。

另请参阅set_drawstyle。

get_ds ( ) [来源] #: 的别名get_drawstyle。

get_fillstyle ( ) [来源] #

返回标记填充样式。

另请参阅set_fillstyle。

get_gapcolor ( ) [来源] #

返回线条间隙颜色。

另请参阅set_gapcolor。

get_linestyle ( ) [来源] #

返回线型。

另请参阅set_linestyle。

get_linewidth ( ) [来源] #

返回以点为单位的线宽。

另请参阅set_linewidth。

get_ls ( ) [来源] #: 的别名get_linestyle。

get_lw ( ) [来源] #: 的别名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_markever ( ) [来源] #

返回标记子采样的 markevery 设置。

另请参阅set_markevery。

get_mec ( ) [来源] #: 的别名get_markeredgecolor。

get_mew ( ) [来源] #: 的别名get_markeredgewidth。

get_mfc ( ) [来源] #: 的别名get_markerfacecolor。

get_mfcalt ( ) [来源] #: 的别名get_markerfacecoloralt。

get_ms ( ) [来源] #: 的别名get_markersize。

get_path ( ) [来源] #: 返回Path与此行关联的。

get_pickradius ( ) [来源] #

返回用于遏制测试的拾取半径。

有关contains更多详细信息，请参阅。

get_solid_capstyle ( ) [来源] #

返回CapStyle实线。

另请参阅set_solid_capstyle。

get_solid_joinstyle ( ) [来源] #

返回JoinStyle实线。

另请参阅set_solid_joinstyle。

get_window_extent ( renderer = None ) [source] #

在显示空间中获取艺术家的边界框。

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

子类应覆盖以包含在边界框“紧密”计算中。默认是在 0, 0 处返回一个空的边界框。

使用此功能时要小心，如果艺术家的艺术家窗口范围发生变化，结果将不会更新。由于变换堆栈中的任何更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做的那样），范围可能会发生变化。这可能会导致意外行为，其中交互式图形在屏幕上看起来很好，但会错误地保存。

get_xdata ( orig = True ) [来源] #

返回 xdata。

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

get_xydata ( ) [来源] #: 将xy数据作为 Nx2 numpy 数组返回。

get_ydata ( orig = True ) [来源] #

返回 ydata。

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

is_dashed ( ) [来源] #

返回线条是否具有虚线样式。

假设自定义线型为虚线，我们不 onoffseq直接检查。

另请参阅set_linestyle。

lineStyles = {''：'_draw_nothing'，' '：'_draw_nothing'，'-'：'_draw_solid'，'--'：'_draw_dashed'，'-.'：'_draw_dash_dot'，':'：'_draw_dotted' , '无': '_draw_nothing'} #

标记= {'.': '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': '八角形', ' s'：'正方形'，'p'：'五边形'，'*'：'星形'，'h': 'hexagon1', 'H': 'hexagon2', '+': '加号', 'x': 'x', 'D': '钻石', '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'， '无'： '无'， '无'： '无'， ' '： '无'， ''： '什么都没有'} #

属性选择半径#

返回用于遏制测试的拾取半径。

有关contains更多详细信息，请参阅。

recache ( always = False ) [来源] #

recache_always ( ) [来源] #

设置( * , agg_filter=<UNSET> , alpha=<UNSET> , animated=<UNSET> , antialiased=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , color=<UNSET > , dash_capstyle=<UNSET> , dash_joinstyle=<UNSET> , dashes=<UNSET> , data=<UNSET> , drawstyle=<UNSET> , fillstyle=<UNSET> , gapcolor=<UNSET> , gid=<UNSET> , in_layout=<UNSET> ,标签=<UNSET> ,linestyle=<UNSET> , linewidth=<UNSET> , marker=<UNSET> , markeredgecolor=<UNSET> , markeredgewidth=<UNSET> , markerfacecolor=<UNSET> , markerfacecoloralt=<UNSET> , markersize=<UNSET> , markevery= <UNSET> , mouseover=<UNSET> , path_effects=<UNSET > , picker=< UNSET> , pickradius=<UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , solid_capstyle=<UNSET > ,solid_joinstyle=<UNSET> ,transform=<UNSET> , url=<UNSET> , visible=<UNSET> , xdata=<UNSET> , ydata=<UNSET> , zorder=<UNSET> ) [来源] #

一次设置多个属性。

支持的属性是

财产

描述

agg_filter

一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量

alpha

标量或无

animated

布尔

antialiased

布尔

clip_box

Bbox

clip_on

布尔

clip_path

补丁或（路径，变换）或无

color

颜色

dash_capstyle

CapStyle或 {'butt', 'projecting', 'round'}

dash_joinstyle

JoinStyle或 {'miter', 'round', 'bevel'}

dashes

浮动序列（以点为单位的开/关墨水）或（无，无）

data

(2, N) 数组或两个一维数组

drawstyle

{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}，默认值：'default'

figure

Figure

fillstyle

{'full', 'left', 'right', 'bottom', 'top', 'none'}

gapcolor

颜色或无

gid

字符串

in_layout

布尔

label

目的

linestyle

{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}

linewidth

漂浮

marker

标记样式字符串，Path或MarkerStyle

markeredgecolor

颜色

markeredgewidth

漂浮

markerfacecolor

颜色

markerfacecoloralt

颜色

markersize

漂浮

markevery

无或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]

mouseover

布尔

path_effects

AbstractPathEffect

picker

浮动或可调用[[艺术家，事件]，元组[布尔，字典]]

pickradius

未知

rasterized

布尔

sketch_params

（比例：浮动，长度：浮动，随机性：浮动）

snap

布尔或无

solid_capstyle

CapStyle或 {'butt', 'projecting', 'round'}

solid_joinstyle

JoinStyle或 {'miter', 'round', 'bevel'}

transform

未知

url

字符串

visible

布尔

xdata

一维数组

ydata

一维数组

zorder

漂浮

财产	描述
`agg_filter`	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
`alpha`	标量或无
`animated`	布尔
`antialiased`	布尔
`clip_box`	`Bbox`
`clip_on`	布尔
`clip_path`	补丁或（路径，变换）或无
`color`	颜色
`dash_capstyle`	`CapStyle`或 {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle`或 {'miter', 'round', 'bevel'}
`dashes`	浮动序列（以点为单位的开/关墨水）或（无，无）
`data`	(2, N) 数组或两个一维数组
`drawstyle`	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}，默认值：'default'
`figure`	`Figure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gapcolor`	颜色或无
`gid`	字符串
`in_layout`	布尔
`label`	目的
`linestyle`	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth`	漂浮
`marker`	标记样式字符串，`Path`或`MarkerStyle`
`markeredgecolor`	颜色
`markeredgewidth`	漂浮
`markerfacecolor`	颜色
`markerfacecoloralt`	颜色
`markersize`	漂浮
`markevery`	无或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
`mouseover`	布尔
`path_effects`	`AbstractPathEffect`
`picker`	浮动或可调用[[艺术家，事件]，元组[布尔，字典]]
`pickradius`	未知
`rasterized`	布尔
`sketch_params`	（比例：浮动，长度：浮动，随机性：浮动）
`snap`	布尔或无
`solid_capstyle`	`CapStyle`或 {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle`或 {'miter', 'round', 'bevel'}
`transform`	未知
`url`	字符串
`visible`	布尔
`xdata`	一维数组
`ydata`	一维数组
`zorder`	漂浮

set_aa ( b ) [来源] #: 的别名set_antialiased。

set_antialiased ( b ) [来源] #

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

参数：

b布尔值

set_c (颜色) [来源] #: 的别名set_color。

set_color (颜色) [来源] #

设置线条的颜色。

参数：

颜色颜色

set_dash_capstyle ( s ) [来源] #

如果线是 . 如何绘制端盖is_dashed。

默认大写样式是rcParams["lines.dash_capstyle"]（默认值：）。<CapStyle.butt: 'butt'>

参数：

sCapStyle或 {'butt', 'projecting', 'round'}

set_dash_joinstyle ( s ) [来源] #

如果可以，如何连接线段is_dashed。

默认连接样式是rcParams["lines.dash_joinstyle"]（默认值：）。<JoinStyle.round: 'round'>

参数：

sJoinStyle或 {'miter', 'round', 'bevel'}

set_dashes ( seq ) [来源] #

设置破折号序列。

破折号序列是一系列偶数长度的浮点数，以点为单位描述破折号和空格的长度。

例如，(5, 2, 1, 2) 描述了由 2 个点空间分隔的 5 点和 1 点破折号序列。

另请参阅set_gapcolor，它允许用颜色填充这些空间。

参数：

seq浮点序列（开/关墨点）或（无，无）: 如果seq为空或，则线型将设置为solid。(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值向右。
'steps-mid'：步长在点之间。
'steps-post：步长在线段的末端，即线将在左侧点的y值处。
'steps' 等于 'steps-pre' 并保持向后兼容。

有关示例，请参见步骤演示。

set_ds ( drawstyle ) [来源] #: 的别名set_drawstyle。

set_fillstyle ( fs ) [来源] #

设置标记填充样式。

参数：

fs {'full', 'left', 'right', 'bottom', 'top', 'none'}

可能的值：

'full'：用markerfacecolor填充整个标记。
'left', 'right', 'bottom', 'top'：用markerfacecolor填充给定侧的标记一半。标记的另一半用markerfacecoloralt填充。
“无”：没有填充。

有关示例，请参见标记填充样式。

set_gapcolor ( gapcolor ) [来源] #

设置颜色以填充虚线样式中的空白。

笔记

条纹线是通过绘制两条交错的虚线来创建的。这两者之间可能存在重叠，这可能会在使用透明度时导致伪影。

此功能是实验性的，可能会发生变化。

参数：

gapcolor颜色或无: 填补空白的颜色。如果没有，则空白未填充。

set_linestyle ( ls ) [来源] #

设置线条的线型。

参数：

ls {'-', '--', '-.', ':', '', (offset, on-off-seq), ...}

可能的值：

一个字符串：

线型

描述

'-'或者'solid'

实线

'--'或者'dashed'

虚线

'-.'或者'dashdot'

点划线

':'或者'dotted'

虚线

'none', 'None', , 或' '''

什么都不画
或者，可以提供以下形式的破折号元组：
```
(offset, onoffseq)
```
其中onoffseq是一个以点为单位的 on 和 off ink 的偶数长度元组。另请参阅set_dashes()。

线型	描述
`'-'`或者`'solid'`	实线
`'--'`或者`'dashed'`	虚线
`'-.'`或者`'dashdot'`	点划线
`':'`或者`'dotted'`	虚线
`'none'`, `'None'`, , 或`' '''`	什么都不画

有关示例，请参见线条样式。

set_linewidth ( w ) [来源] #

以点为单位设置线宽。

参数：

w浮动: 线宽，以磅为单位。

set_ls ( ls ) [来源] #: 的别名set_linestyle。

set_lw ( w ) [来源] #: 的别名set_linewidth。

set_marker (标记) [来源] #

设置线标记。

参数：

标记标记样式字符串，Path或MarkerStyle: 有关markers可能参数的完整描述，请参阅。

set_markeredgecolor ( ec ) [来源] #

设置标记边缘颜色。

参数：

ec颜色

set_markeredgewidth ( ew ) [来源] #

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

参数：

新浮法: 标记边缘宽度，以磅为单位。

set_markerfacecolor ( fc ) [来源] #

设置标记面颜色。

参数：

fc颜色

set_markerfacecoloralt ( fc ) [来源] #

设置备用标记面颜色。

参数：

fc颜色

set_markersize ( sz ) [来源] #

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

参数：

大小浮动: 标记大小，以磅为单位。

set_markevery ( every ) [来源] #

设置 markevery 属性以在使用标记时对绘图进行二次采样。

例如，如果every=5，将绘制每 5 个标记。

参数：

每个None 或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]

要绘制的标记。

every=None：将绘制每个点。
every=N：每个第 N 个标记将从标记 0 开始绘制。
every=(start, N)：将绘制从索引start 开始的每个第 N 个标记。
every=slice(start, end, N)：将绘制从索引start 开始到但不包括索引end的每个第 N 个标记。
every=[i, j, m, ...]：只会绘制给定索引处的标记。
every=[True, False, True, ...]: 只有为真的位置才会被绘制。该列表必须与数据点具有相同的长度。
every=0.1,（即浮点数）：标记将沿线以大致相等的视觉距离间隔开；沿标记之间的线的距离是通过将轴边界框对角线的显示坐标距离乘以every的值来确定的。
every=(0.5, 0.1)（即一个长度为 2 的浮点元组）：类似于every=0.1但第一个标记将沿线偏移 0.5 乘以沿线的显示坐标对角距离。