彩条

matplotlib.colorbar¶

带两个类和一个函数的颜色条工具包：

ColorbarBase

具有完整颜色栏绘制功能的基类。它可以按原样为给定的颜色映射制作颜色条；不需要可映射对象（例如，图像）。

Colorbar

用于图像或轮廓图的派生类。

make_axes()

用于调整轴大小并添加适合颜色条的第二个轴的函数。

这个 colorbar() 方法使用 make_axes() 和 Colorbar ； colorbar() 函数是一个薄包装 colorbar() .

class matplotlib.colorbar.Colorbar(ax, mappable, **kw)[源代码]¶

基类：matplotlib.colorbar.ColorbarBase

这个类连接 ColorbarBase 到A ScalarMappable 比如A AxesImage 生成通过 imshow() .

它不打算直接实例化；而是使用 colorbar() 或 colorbar() 做你的彩条。

add_lines(CS, erase=True)[源代码]¶

添加非填充行 ContourSet 到颜色条。

集合 擦除 如果这些行应添加到任何现有行中，则为false。

minorticks_off()[源代码]¶

关闭颜色栏上的小刻度。

minorticks_on()[源代码]¶

打开颜色条上的小刻度，而不挤压到“扩展区域”。

on_mappable_changed(mappable)[源代码]¶

更新此颜色栏以匹配映射表的属性。

通常，它会自动注册为事件处理程序 colorbar_factory() 不应手动调用。

remove()[源代码]¶

从图中删除此颜色条。如果颜色条是用 use_gridspec=True 然后将gridspec恢复到其先前的值。

update_bruteforce(mappable)[源代码]¶

销毁并重建颜色条。这将变得过时，可能会被弃用，然后删除。当使用pyplot.colorbar函数或figure.colorbar方法创建colorbar时，不调用该函数。

update_normal(mappable)[源代码]¶

更新实体、线条等。与更新图形不同，它不清除轴。这意味着当颜色条所属的图像或轮廓图更改时调用。

class matplotlib.colorbar.ColorbarBase(ax, cmap=None, norm=None, alpha=None, values=None, boundaries=None, orientation='vertical', ticklocation='auto', extend='neither', spacing='uniform', ticks=None, format=None, drawedges=False, filled=True, extendfrac=None, extendrect=False, label='')[源代码]¶

基类：matplotlib.cm.ScalarMappable

在现有轴中绘制颜色条。

这是 Colorbar 类，它是 colorbar() 函数和 colorbar() 方法，这是创建颜色条的常用方法。

它本身也有助于显示颜色图。如果 cmap Kwarg被给予，但是 边界 和 价值观 保留为“无”，则颜色映射将以0-1的比例显示。要显示欠值和超值颜色，请指定 norm AS：：

colors.Normalize(clip=False)

要显示颜色与索引，而不是0-1比例，请使用：

norm=colors.NoNorm.

有用的公共方法是 set_label() 和 add_lines() .

属性:	ax : 轴线 这个 Axes 在其中绘制颜色条的实例。 线 : 列表 列表 LineCollection 如果画了线，则为空列表。 除法器 : LineCollection LineCollection如果 排水楔 是 True ，否则 None .

add_lines(levels, colors, linewidths, erase=True)[源代码]¶

在颜色栏上画线。

** 和 线宽度 必须是与相同长度的标量或序列 水平 .

集合 擦除 若为false，则在不首先删除任何先前添加的行的情况下添加行。

ax = None¶

这个颜色条所居住的轴。

config_axis()[源代码]¶

draw_all()[源代码]¶

根据当前的CMAP和规范计算任意自由参数，并绘制所有图纸。

get_ticks(minor=False)[源代码]¶

返回X记号作为位置列表

n_rasterize = 50¶

remove()[源代码]¶

从图中删除此颜色条

set_alpha(alpha)[源代码]¶

set_label(label, **kw)[源代码]¶

标记颜色条的长轴

set_ticklabels(ticklabels, update_ticks=True)[源代码]¶

设置刻度线标签。除非更新标记为 假 . 要手动更新刻度，请调用 update_ticks 方法显式。

set_ticks(ticks, update_ticks=True)[源代码]¶

设置刻度位置。

参数:	ticks : 无，序列，定位器实例 如果没有，将使用默认定位器。 update_ticks : 真、假，可选 如果为真，则立即更新勾选位置。如果为假，使用 update_ticks() 手动更新刻度。

update_ticks()[源代码]¶

强制更新刻度和刻度标签。只要勾号定位器和/或勾号格式化程序更改，就必须调用此函数。

class matplotlib.colorbar.ColorbarPatch(ax, mappable, **kw)[源代码]¶

基类：matplotlib.colorbar.Colorbar

使用创建的颜色条 Patch 而不是违约 pcolor() .

它使用补丁实例列表而不是 PatchCollection 因为后者不允许图案填充图案在集合的成员中发生变化。

matplotlib.colorbar.colorbar_factory(cax, mappable, **kwargs)[源代码]¶

在给定轴上为给定的可映射表创建颜色条。

通常，对于自动颜色条放置，只提供一个可映射的用途 colorbar() .

matplotlib.colorbar.make_axes(parents, location=None, orientation=None, fraction=0.15, shrink=1.0, aspect=20, **kw)[源代码]¶

调整和重新定位父轴，并返回适合颜色条的子轴。

关键字参数可以包括以下内容（使用默认值）：

位置 : [无“左”“右”“上”“下”]

位置，相对于 父母 ，创建颜色条轴的位置。如果没有，则该值将来自给定的 orientation ，否则将默认为“右”。

方向 : [无‘垂直’‘水平’]

颜色条的方向。通常，不应使用此关键字，因为它可以从 location 关键字。

财产	描述
方向	垂直或水平
分数	0.15；用于颜色条的原始轴的分数
pad	垂直0.05，水平0.15；颜色条和新图像轴之间原始轴的分数
收缩	1.0；要乘以颜色条大小的分数
方面	20；长尺寸与短尺寸之比
锚	（0.0，0.5）如果垂直；（0.5，1.0）如果水平；颜色条轴的定位点
潘乔	（1.0，0.5）如果垂直；（0.5，0.0）如果水平；颜色条父轴的定位点。如果为false，则父轴的定位将保持不变。

返回（cax，kw）、创建colorbar实例时要传递的子轴和缩减的kw字典。

matplotlib.colorbar.make_axes_gridspec(parent, *, fraction=0.15, shrink=1.0, aspect=20, **kw)[源代码]¶

调整父轴的大小和位置，并返回适合颜色条的子轴。此功能类似于生成轴。主要区别在于

• make_axes_gridspec 只处理 方向 关键字，不能处理“location”关键字。
• make_axes_gridspec 只能与子批次父项一起使用。

• make_axes 创建轴的实例。 make_axes_gridspec

  创建子批次的实例。

• make_axes 更新的位置

  起源。 make_axes_gridspec 用新的网格替换父网格的“spec”属性。

虽然此函数旨在与 make_axes 可能会有一些细微的差异。

关键字参数可以包括以下内容（使用默认值）：

方向

“垂直”或“水平”

财产	描述
方向	垂直或水平
分数	0.15；用于颜色条的原始轴的分数
pad	垂直0.05，水平0.15；颜色条和新图像轴之间原始轴的分数
收缩	1.0；要乘以颜色条大小的分数
方面	20；长尺寸与短尺寸之比
锚	（0.0，0.5）如果垂直；（0.5，1.0）如果水平；颜色条轴的定位点
潘乔	（1.0，0.5）如果垂直；（0.5，0.0）如果水平；颜色条父轴的定位点。如果为false，则父轴的定位将保持不变。

除了第一个以外，其余的都从输入功率组中剥离。

返回（cax，kw）、创建colorbar实例时要传递的子轴和缩减的kw字典。