`matplotlib.container`#

class matplotlib.container.BarContainer(*args, **kwargs)[source]#

基类： Container

用于柱状图艺术家对象（例如由 Axes.bar 创建）的容器。

该容器可以被视为图块（patches）本身的元组。此外，您还可以通过属性访问这些参数及其进一步的参数。

属性：

patcheslist of Rectangle: 柱状图的艺术家对象。
errorbarNone or ErrorbarContainer: 如果存在误差条，则为误差条艺术家对象的容器。否则为 None。
datavaluesNone or array-like: 对应于柱状图的底层数据值。
orientation{'vertical', 'horizontal'}, default: None: 如果为 'vertical'，则假定柱状图是垂直的。如果为 'horizontal'，则假定柱状图是水平的。

property bottoms#: 返回柱状图下端的值。

于版本 3.11 新增。

property position_centers#: 返回柱状图位置的中心。

于版本 3.11 新增。

property tops#: 返回柱状图上端的值。

于版本 3.11 新增。

class matplotlib.container.Container(*args, **kwargs)[source]#

基类： tuple

容器的基类。

容器是用于收集语义相关艺术家对象（如柱状图中的柱子）的类。

add_callback(func)[source]#

添加一个回调函数，每当 Artist 的属性发生变化时都会调用该函数。

参数:

funccallable

回调函数。它必须具有以下签名：

def func(artist: Artist) -> Any

其中 artist 是调用的 Artist。返回值可能存在，但会被忽略。

返回:

int: 与回调关联的观察者 ID。此 ID 稍后可用于通过 remove_callback 移除该回调。

另请参阅

remove_callback

get_children()[source]#

get_label()[source]#: 返回此艺术家在图例中使用的标签。

pchanged()[source]#

调用所有已注册的回调函数。

当属性发生变化时，此函数会在内部触发。

另请参阅

add_callback
remove_callback

remove()[source]#

remove_callback(oid)[source]#

根据其观察者 ID 移除回调函数。

另请参阅

add_callback

set_label(s)[source]#

设置将在图例中显示的标签。

参数:

s对象: s 将通过调用 str 转换为字符串。

class matplotlib.container.ErrorbarContainer(*args, **kwargs)[source]#

基类： Container

用于误差条艺术家对象的容器（例如由 Axes.errorbar 创建）。

该容器可以被视为 lines 元组本身。此外，您还可以通过属性访问这些参数及其进一步的参数。

属性：

linestuple

包含 (data_line, caplines, barlinecols) 的元组。

data_line : x, y 绘图标记和/或线条的 Line2D 实例。
caplines : 误差条端点的 Line2D 实例元组。
barlinecols : 包含水平和垂直误差范围的 LineCollection 元组。

has_xerr, has_yerrbool

如果误差条具有 x/y 误差，则为 True。

class matplotlib.container.PieContainer(wedges, values, normalize)[source]#

基类： object

用于饼图艺术家对象的容器（例如由 Axes.pie 创建）。

于版本 3.11 新增。

警告

类名 PieContainer 是暂定的，将来可能会更改以反映其功能的开发。

您可以通过属性访问楔形图块和进一步的参数。

属性：

wedgeslist of Wedge: 饼图楔形的艺术家对象。
valuesnumpy.ndarray: 饼图所基于的数据。
fracsnumpy.ndarray: 每个楔形在饼图中占的比例。
textslist of list of Text: 饼图楔形上任何标签的艺术家对象。每个内部列表包含每个楔形的一个文本标签。

add_texts(texts)[source]#: 将 Text 对象列表添加到容器中。

property fracs#

remove()[source]#: 从坐标轴中移除所有楔形和文本

property texts#

property values#

class matplotlib.container.StemContainer(*args, **kwargs)[source]#

基类： Container

用于在 Axes.stem() 绘图中创建的艺术家对象的容器。

该容器可以像 namedtuple (markerline, stemlines, baseline) 一样对待。

属性：

markerlineLine2D: 茎顶端标记的艺术家对象。
stemlinesLineCollection: 所有茎的垂直线条艺术家对象。
baselineLine2D: 水平基线的艺术家对象。

参数:

markerline_stemlines_baselinetuple: 包含 (markerline, stemlines, baseline) 的元组。markerline 包含标记的 Line2D，stemlines 是主线条的 LineCollection，baseline 是基线的 Line2D。

matplotlib.container#

`matplotlib.container`#