matplotlib 3.5.1

Parameters
set_prop_cycle(self, *args, **kwargs)

The property cycle controls the style properties such as color, marker and linestyle of future plot commands. The style properties of data already added to the Axes are not modified.

Call signatures:

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

Form 1 sets given Cycler object.

Form 2 creates a Cycler which cycles over one or more properties simultaneously and set it as the property cycle of the Axes. If multiple properties are given, their value lists must have the same length. This is just a shortcut for explicitly creating a cycler and passing it to the function, i.e. it's short for set_prop_cycle(cycler(label=values label2=values2, ...)) .

Form 3 creates a Cycler for a single property and set it as the property cycle of the Axes. This form exists for compatibility with the original cycler.cycler interface. Its use is discouraged in favor of the kwarg form, i.e. set_prop_cycle(label=values) .

Parameters

cycler : Cycler

Set the given Cycler. None resets to the cycle defined by the current style.

label : str

The property key. Must be a valid .Artist property. For example, 'color' or 'linestyle'. Aliases are allowed, such as 'c' for 'color' and 'lw' for 'linewidth'.

values : iterable

Finite-length iterable of the property values. These values are validated and will raise a ValueError if invalid.

Set the property cycle of the Axes.

See Also

cycler.cycler

The original function for creating unvalidated cyclers.

matplotlib.rcsetup.cycler

Convenience function for creating validated cyclers for properties.

Examples

Setting the property cycle for a single property:

This example is valid syntax, but raise an exception at execution
>>> ax.set_prop_cycle(color=['red', 'green', 'blue'])

Setting the property cycle for simultaneously cycling over multiple properties (e.g. red circle, green plus, blue cross):

This example is valid syntax, but raise an exception at execution
>>> ax.set_prop_cycle(color=['red', 'green', 'blue'],
...  marker=['o', '+', 'x'])
See :

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them


File: /matplotlib/axes/_base.py#1505
type: <class 'function'>
Commit: