matplotlib.lines.Line2D#

class 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)[source]#

基类：Artist

一条线——这条线可以具有连接所有顶点的实心线型，并且在每个顶点处都有一个标记。此外，实线的绘制受绘制样式（drawstyle）的影响，例如，可以创建各种样式的“阶梯”线。

使用 x 和 y 数据序列（xdata, ydata）创建一个 Line2D 实例。

其他关键字参数是 Line2D 属性

属性

描述

agg_filter

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

alpha

浮点数或 None

animated

布尔值

antialiased 或 aa

布尔值

clip_box

BboxBase 或 None

clip_on

布尔值

clip_path

Patch 或 (Path, Transform) 或 None

color 或 c

color

dash_capstyle

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

dash_joinstyle

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

dashes

浮点数序列（点中的开/关墨迹）或 (None, None)

data

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

drawstyle 或 ds

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

figure

Figure 或 SubFigure

fillstyle

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

gapcolor

颜色或 None

gid

str

in_layout

布尔值

label

object

linestyle 或 ls

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

linewidth 或 lw

浮点数

marker

marker style string, Path 或 MarkerStyle

markeredgecolor 或 mec

color

markeredgewidth 或 mew

浮点数

markerfacecolor 或 mfc

color

markerfacecoloralt 或 mfcalt

color

markersize 或 ms

浮点数

markevery

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

mouseover

布尔值

path_effects

AbstractPathEffect 列表

picker

浮点数或 callable[[Artist, Event], tuple[bool, dict]]

pickradius

浮点数

rasterized

布尔值

sketch_params

(scale: 浮点数, length: 浮点数, randomness: 浮点数)

snap

布尔值或 None

solid_capstyle

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

solid_joinstyle

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

transform

未知

url

str

visible

布尔值

xdata

一维数组

ydata

一维数组

zorder

浮点数

有关线型的描述，请参见 set_linestyle()；有关标记的描述，请参见 set_marker()；有关绘制样式的描述，请参见 set_drawstyle()。

contains(mouseevent)[source]#

测试鼠标事件（mouseevent）是否发生在线上。

如果事件距离线小于 self.pickradius（默认：5 点），则认为事件发生在线上。使用 get_pickradius 或 set_pickradius 获取或设置拾取半径。

参数:

mouseevent类型：MouseEvent

返回:

contains布尔值

是否有任何值在半径范围内。

details字典

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

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

draw(renderer)[source]#

使用给定的渲染器绘制 Artist（及其子对象）。

如果艺术家不可见（Artist.get_visible 返回 False），则此操作无效。

参数:

renderer类型：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')#

filled_markers = ('.', 'o', 'v', '^', '<', '>', '8', 's', 'p', '*', 'h', 'H', 'D', 'd', 'P', 'X')#

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

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

get_bbox()[source]#: 获取此线的边界框。

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

get_color()[source]#

返回线的颜色。

另请参见 set_color。

get_dash_capstyle()[source]#

返回虚线的 CapStyle。

另请参见 set_dash_capstyle。

get_dash_joinstyle()[source]#

返回虚线的 JoinStyle。

另请参见 set_dash_joinstyle。

get_data(orig=True)[source]#

将线数据作为 (xdata, ydata) 对返回。

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

get_drawstyle()[source]#

返回绘制样式。

另请参见 set_drawstyle。

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

get_fillstyle()[source]#

返回标记填充样式。

另请参见 set_fillstyle。

get_gapcolor()[source]#

返回线的间隙颜色。

另请参见 set_gapcolor。

get_linestyle()[source]#

返回线型。

另请参见 set_linestyle。

get_linewidth()[source]#

返回以点为单位的线宽。

另请参见 set_linewidth。

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

get_lw()[source]#: get_linewidth 的别名。

get_marker()[source]#

返回线的标记。

另请参见 set_marker。

get_markeredgecolor()[source]#

返回标记边缘颜色。

另请参见 set_markeredgecolor。

get_markeredgewidth()[source]#

返回以点为单位的标记边缘宽度。

另请参见 set_markeredgewidth。

get_markerfacecolor()[source]#

返回标记面颜色。

另请参见 set_markerfacecolor。

get_markerfacecoloralt()[source]#

返回备用标记面颜色。

另请参见 set_markerfacecoloralt。

get_markersize()[source]#

返回以点为单位的标记大小。

另请参见 set_markersize。

get_markevery()[source]#

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

另请参见 set_markevery。

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

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

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

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

get_ms()[source]#: 是 get_markersize 的别名。

get_path()[source]#: 返回与此线条关联的 Path 对象。

get_pickradius()[source]#

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

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

get_solid_capstyle()[source]#

返回实线的 CapStyle。

另请参阅 set_solid_capstyle。

get_solid_joinstyle()[source]#

返回实线的 JoinStyle。

另请参阅 set_solid_joinstyle。

get_window_extent(renderer=None)[source]#

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

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

子类应覆盖此方法，以便将其包含在边界框“紧密”计算中。默认返回一个位于 0, 0 的空边界框。

使用此函数时请小心，如果艺术家（artist）的窗口范围发生变化，结果将不会更新。范围可能因变换堆栈中的任何变化而改变，例如更改坐标轴限制、图形大小或所使用的画布（例如保存图形时）。这可能导致意外行为，即交互式图形在屏幕上看起来正常，但保存时会出现错误。

get_xdata(orig=True)[source]#

返回 x 数据。

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

get_xydata()[source]#: 将 xy 数据返回为 (N, 2) 数组。

get_ydata(orig=True)[source]#

返回 y 数据。

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

is_dashed()[source]#

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

自定义线条样式被假定为虚线，我们不直接检查 onoffseq。

另请参见 set_linestyle。

lineStyles = {'': '_draw_nothing', ' ': '_draw_nothing', '-': '_draw_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted', 'None': '_draw_nothing'}#

markers = {' ': 'nothing', '': 'nothing', '*': 'star', '+': 'plus', ',': 'pixel', '.': 'point', '1': 'tri_down', '2': 'tri_up', '3': 'tri_left', '4': 'tri_right', '8': 'octagon', '<': 'triangle_left', '>': 'triangle_right', 'D': 'diamond', 'H': 'hexagon2', 'None': 'nothing', 'P': 'plus_filled', 'X': 'x_filled', '^': 'triangle_up', '_': 'hline', 'd': 'thin_diamond', 'h': 'hexagon1', 'none': 'nothing', 'o': 'circle', 'p': 'pentagon', 's': 'square', 'v': 'triangle_down', 'x': 'x', '|': 'vline', 0: 'tickleft', 1: 'tickright', 10: 'caretupbase', 11: 'caretdownbase', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 6: 'caretup', 7: 'caretdown', 8: 'caretleftbase', 9: 'caretrightbase'}#

property pickradius#

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

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

recache(always=False)[source]#

recache_always()[source]#

set(*, 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>, label=<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>)[source]#

一次性设置多个属性。

支持的属性包括：

属性

描述

agg_filter

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

alpha

浮点数或 None

animated

布尔值

antialiased

布尔值

clip_box

BboxBase 或 None

clip_on

布尔值

clip_path

Patch 或 (Path, Transform) 或 None

color

color

dash_capstyle

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

dash_joinstyle

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

dashes

浮点数序列（点中的开/关墨迹）或 (None, None)

data

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

dash_joinstyle

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

figure

Figure 或 SubFigure

fillstyle

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

gapcolor

颜色或 None

gid

str

in_layout

布尔值

label

object

linestyle

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

linewidth

浮点数

marker

marker style string, Path 或 MarkerStyle

marker

color

markeredgecolor

浮点数

markeredgewidth

color

markerfacecolor

color

markerfacecoloralt

浮点数

markevery

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

mouseover

布尔值

path_effects

AbstractPathEffect 列表

picker

浮点数或 callable[[Artist, Event], tuple[bool, dict]]

pickradius

浮点数

rasterized

布尔值

sketch_params

(scale: 浮点数, length: 浮点数, randomness: 浮点数)

snap

布尔值或 None

solid_capstyle

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

solid_joinstyle

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

transform

未知

url

str

visible

布尔值

xdata

一维数组

ydata

一维数组

zorder

浮点数

set_aa(b)[source]#: 是 set_antialiased 的别名。

set_antialiased(b)[source]#

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

参数:

bbool

set_c(color)[source]#: 是 set_color 的别名。

set_color(color)[source]#

设置线条的颜色。

参数:

color颜色

set_dash_capstyle(s)[source]#

如果线条为 is_dashed，则如何绘制端点。

默认的端点样式为 rcParams["lines.dash_capstyle"] (默认值: <CapStyle.butt: 'butt'>)。

参数:

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

set_dash_joinstyle(s)[source]#

如果线条为 is_dashed，则如何连接线条的线段。

默认的连接样式为 rcParams["lines.dash_joinstyle"] (默认值: <JoinStyle.round: 'round'>)。

参数:

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

set_dashes(seq)[source]#

设置虚线序列。

虚线序列是一个偶数长度的浮点数序列，描述了虚线和空白的长度（单位为点）。

例如，(5, 2, 1, 2) 描述了一个由 5 点虚线和 1 点虚线组成的序列，它们之间由 2 点空白分隔。

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

参数:

seq浮点数序列（表示开启/关闭墨迹的点数）或 (None, None): 如果 seq 为空或 (None, None)，线条样式将设置为实线。

set_data(*args)[source]#

设置 x 和 y 数据。

参数:

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

另请参阅

set_xdata
set_ydata

set_drawstyle(drawstyle)[source]#

设置绘图的绘制样式。

绘制样式决定了点如何连接。

参数:

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

对于 'default'，点之间用直线连接。

`steps` 变体用阶梯状线条连接点，即带有垂直阶梯的水平线。它们在阶梯位置上有所不同

'steps-pre': 阶梯位于线段的起点，即线条将位于右侧点的 y 值处。
'steps-mid': 阶梯位于点之间的中间位置。
'steps-post: 阶梯位于线段的末尾，即线条将位于左侧点的 y 值处。
'steps' 等同于 'steps-pre'，并为向后兼容性而保留。

示例请参阅 Step Demo。

set_ds(drawstyle)[source]#: 是 set_drawstyle 的别名。

set_fillstyle(fs)[source]#

设置标记的填充样式。

参数:

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

可能的值

'full': 用 markerfacecolor 填充整个标记。
'left', 'right', 'bottom', 'top': 用 markerfacecolor 填充标记在给定侧的一半。标记的另一半用 markerfacecoloralt 填充。
'none': 不填充。

示例请参阅 Marker fill styles。

set_gapcolor(gapcolor)[source]#

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

注意

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

此功能是实验性的，可能会更改。

参数:

gapcolor颜色或 None: 用于填充空白的颜色。如果为 None，则空白不填充。

set_linestyle(ls)[source]#

设置线条的样式。

参数:

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

可能的值

一个字符串

linestyle

描述

'-' 或 'solid'

实线

'--' 或 'dashed'

虚线

'-.' 或 'dashdot'

点划线

':' 或 'dotted'

点线

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

不绘制任何内容
或者，可以提供以下形式的虚线元组
```
(offset, onoffseq)
```
其中 onoffseq 是一个偶数长度的元组，表示开启和关闭墨迹的点数。另请参阅 set_dashes()。

示例请参阅 Linestyles。

set_linewidth(w)[source]#

设置线宽（单位为点）。

参数:

wfloat: 线宽，单位为点。

set_ls(ls)[source]#: 是 set_linestyle 的别名。

set_lw(w)[source]#: 是 set_linewidth 的别名。

set_marker(marker)[source]#

设置线条标记。

参数:

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

set_markeredgecolor(ec)[source]#

设置标记边缘颜色。

参数:

ec颜色

set_markeredgewidth(ew)[source]#

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

参数:

ewfloat: 标记边缘宽度，单位为点。

set_markerfacecolor(fc)[source]#

设置标记面颜色。

参数:

fc颜色

set_markerfacecoloralt(fc)[source]#

设置备用标记面颜色。

参数:

fc颜色

set_markersize(sz)[source]#

设置标记大小（单位为点）。

参数:

szfloat: 标记大小，单位为点。

set_markevery(every)[source]#

设置 `markevery` 属性，以便在使用标记时对绘图进行子采样。

例如，如果 every=5，则每隔 5 个标记绘制一个。

参数:

everyNone 或整型或 (整型, 整型) 或切片或整型列表或浮点数或 (浮点数, 浮点数) 或布尔值列表

要绘制的标记。

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

示例请参阅 Markevery Demo。

备注

设置 markevery 仍只会在实际数据点处绘制标记。虽然浮点参数形式旨在实现均匀的视觉间距，但它必须将理想间距强制转换为最近的可用数据点。根据数据点的数量和分布，结果可能仍然看起来不均匀。

当使用起始偏移来指定第一个标记时，偏移将从第一个数据点开始，如果绘图已放大，此数据点可能与第一个可见数据点不同。

当使用浮点参数放大绘图时，具有标记的实际数据点将发生变化，因为标记之间的距离总是根据显示坐标的坐标轴边界框对角线确定的，而不考虑实际的坐标轴数据限制。

set_mec(ec)[source]#: 是 set_markeredgecolor 的别名。

set_mew(ew)[source]#: 是 set_markeredgewidth 的别名。

set_mfc(fc)[source]#: 是 set_markerfacecolor 的别名。

set_mfcalt(fc)[source]#: 是 set_markerfacecoloralt 的别名。

set_ms(sz)[source]#: 是 set_markersize 的别名。

set_picker(p)[source]#

设置线条的事件拾取器详细信息。

参数:

pfloat 或可调用对象[[Artist, Event], tuple[bool, dict]]: 如果是浮点数，则用作拾取半径（单位为点）。

set_pickradius(pickradius)[source]#

设置用于包含性测试的拾取半径。

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

参数:

pickradius浮点数: 拾取半径，单位为点。

set_solid_capstyle(s)[source]#

如果线条是实线（不是 is_dashed），则如何绘制端点。

默认的端点样式为 rcParams["lines.solid_capstyle"] (默认值: <CapStyle.projecting: 'projecting'>)。

参数:

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

set_solid_joinstyle(s)[source]#

如果线条是实线（不是 is_dashed），则如何连接线段。

默认的连接样式为 rcParams["lines.solid_joinstyle"] (默认值: <JoinStyle.round: 'round'>)。

参数:

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

set_transform(t)[source]#

设置艺术家变换。

参数:

tTransform

set_xdata(x)[source]#

设置 x 的数据数组。

参数:

x一维数组

另请参阅

set_data
set_ydata

set_ydata(y)[source]#

设置 y 的数据数组。

参数:

y一维数组

另请参阅

set_data
set_xdata

update_from(other)[source]#: 将属性从 other 复制到自身。

zorder = 2#

使用 `matplotlib.lines.Line2D` 的示例#

SkewT-logP 图：使用变换和自定义投影

带有坐标轴脊线的多个 Y 轴

箱线图

图形标签：suptitle, supxlabel, supylabel

使用 RangeSlider 进行图像缩放

属性	描述
`agg_filter`	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
`alpha`	浮点数或 None
`animated`	布尔值
`antialiased` 或 `aa`	布尔值
`clip_box`	`BboxBase` 或 None
`clip_on`	布尔值
`clip_path`	Patch 或 (Path, Transform) 或 None
`color` 或 `c`	color
`dash_capstyle`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`dashes`	浮点数序列（点中的开/关墨迹）或 (None, None)
`data`	(2, N) 数组或两个一维数组
`drawstyle` 或 `ds`	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}，默认值: 'default'
`figure`	`Figure` 或 `SubFigure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gapcolor`	颜色或 None
`gid`	str
`in_layout`	布尔值
`label`	object
`linestyle` 或 `ls`	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth` 或 `lw`	浮点数
`marker`	marker style string, `Path` 或 `MarkerStyle`
`markeredgecolor` 或 `mec`	color
`markeredgewidth` 或 `mew`	浮点数
`markerfacecolor` 或 `mfc`	color
`markerfacecoloralt` 或 `mfcalt`	color
`markersize` 或 `ms`	浮点数
`markevery`	None 或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
`mouseover`	布尔值
`path_effects`	`AbstractPathEffect` 列表
`picker`	浮点数或 callable[[Artist, Event], tuple[bool, dict]]
`pickradius`	浮点数
`rasterized`	布尔值
`sketch_params`	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
`snap`	布尔值或 None
`solid_capstyle`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`transform`	未知
`url`	str
`visible`	布尔值
`xdata`	一维数组
`ydata`	一维数组
`zorder`	浮点数

linestyle	描述
`'-'` 或 `'solid'`	实线
`'--'` 或 `'dashed'`	虚线
`'-.'` 或 `'dashdot'`	点划线
`':'` 或 `'dotted'`	点线
`'none'`, `'None'`, `' '`, 或 `''`	不绘制任何内容

matplotlib.lines.Line2D#

使用 matplotlib.lines.Line2D 的示例#

使用 `matplotlib.lines.Line2D` 的示例#