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 对象。

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

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

参数:

cyclerCycler

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

标签str

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

值可迭代对象

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

参见

matplotlib.rcsetup.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年间的股票价格

Stock prices over 32 years

使用 cycler 进行样式设置

Styling with cycler