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'])