Python matplotlib Axes.set_prop_cycle用法及代码示例

本文简要介绍 python 语言中 matplotlib.axes.Axes.set_prop_cycle 的用法。

用法

Axes.set_prop_cycle(*args, **kwargs)

设置轴的属性循环。

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

调用签名：

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

表格 1 设置给定 Cycler 对象。

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

表格 3 为单个属性创建一个 Cycler ，并将其设置为轴的属性循环。这种形式的存在是为了与原始 cycler.cycler 接口兼容。不鼓励使用它以支持 kwarg 形式，即 set_prop_cycle(label=values) 。

参数：

cycler Cycler

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

label str

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

values 可迭代的

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

例子

为单个属性设置属性周期：

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

设置属性循环以同时循环多个属性(例如红色圆圈、绿色加号、蓝色十字)：

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