matplotlib.axes.Axes.set_prop_cycle#

Axes.set_prop_cycle(*args, **kwargs)[源]#

设置 Axes 的属性循环。

属性循环控制未来绘图命令的样式属性，例如颜色、标记和线型。已经添加到 Axes 的数据的样式属性不会被修改。

调用签名

set_prop_cycle(cycler)
set_prop_cycle(label=values, label2=values2, ...)
set_prop_cycle(label, values)

形式 1 设置给定的 Cycler 对象。

形式 2 创建一个 Cycler，该对象同时循环一个或多个属性，并将其设置为 Axes 的属性循环。如果给定多个属性，它们的值列表必须具有相同的长度。这只是显式创建循环器并将其传递给函数的快捷方式，即它是 set_prop_cycle(cycler(label=values, label2=values2, ...)) 的简写。

形式 3 为单个属性创建一个 Cycler，并将其设置为 Axes 的属性循环。此形式是为了与原始 cycler.cycler 接口兼容而存在。不建议使用此形式，而建议使用 kwarg 形式，即 set_prop_cycle(label=values)。

参数:
cyclerCycler 或 None

设置给定的 Cycler。None 会重置为当前样式定义的循环。

labelstr

属性键。必须是有效的 Artist 属性。例如，'color' 或 'linestyle'。允许使用别名，例如 'c' 代表 'color'，'lw' 代表 'linewidth'。

values可迭代对象

属性值的有限长度可迭代对象。这些值经过验证，如果无效将引发 ValueError。

另请参阅

matplotlib.rcsetup.cycler

用于为属性创建已验证的 cycler 的便捷函数。

cycler.cycler

用于创建未经验证的 cycler 的原始函数。

示例

为单个属性设置属性循环

>>> ax.set_prop_cycle(color=['red', 'green', 'blue'])

为同时循环多个属性设置属性循环（例如，红色圆圈、绿色加号、蓝色叉号）

>>> ax.set_prop_cycle(color=['red', 'green', 'blue'],
...                   marker=['o', '+', 'x'])

使用 matplotlib.axes.Axes.set_prop_cycle 的示例#

32 年来的股票价格

32 年来的股票价格

使用 cycler 进行样式设置

使用 cycler 进行样式设置
在此页