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 同时循环一个或多个属性,并将其设置为轴的属性循环。如果给定了多个属性,则它们的值列表必须具有相同的长度。这只是显式创建一个cycler并将其传递给函数的一个快捷方式,即它是 set_prop_cycle(cycler(label=values label2=values2, ...)) .

表单3创建 Cycler 对于单个属性,并将其设置为轴的属性循环。此表单与原始表单兼容 cycler.cycler 接口。不鼓励使用Kwarg形式,即 set_prop_cycle(label=values) .

参数:
cycler自行车运动员

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

labelSTR

属性键。必须是有效的 Artist 财产。例如,“color”或“linestyle”。允许使用别名,例如“color”的“c”和“lineidth”的“lw”。

values可迭代的

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

参见

matplotlib.rcsetup.cycler
为属性创建已验证的Cyclers的便利功能。
cycler.cycler
用于创建未验证的Cyclers的原始函数。

实例

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

>>> 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