Cycle(*args, samples=None, name=None, marker=None, alpha=None, dashes=None, linestyle=None, linewidth=None, markersize=None, markeredgewidth=None, markeredgecolor=None, markerfacecolor=None, save=False, save_kw=None, **kwargs)[source]¶
Generate and merge
Cyclerinstances in a variety of ways. Used to interpret the
cycle_kwarguments when passed to any plotting method wrapped by
If you just want a list of colors instead of a
Cyclerinstance, use the
colorsfunction. If you want a
Cyclerinstance that imposes black as the default color and cycles through properties like
linestyleinstead, call this function without any positional arguments.
*args (colormap-spec or cycle-spec, optional) – Positional arguments control the colors in the
Cyclerobject. If more than one argument is passed, the resulting cycles are merged. Arguments are interpreted as follows.
Cycler, nothing more is done.
If list of RGB tuples or color strings, these colors are used.
ListedColormap, colors from the
colorsattribute are used.
If string color cycle name, that
ListedColormapis looked up and its
colorsattribute is used. See
Otherwise, the argument is passed to
Colormap, and colors from the resulting
LinearSegmentedColormapare used. See the
If the last positional argument is numeric, it is used for the
samples (float or list of float, optional) – For
ListedColormaps, this is the number of colors to select. For example,
Cycle('538', 4)returns the first 4 colors of the
LinearSegmentedColormaps, this is either a list of sample coordinates used to draw colors from the map, or an integer number of colors to draw. If the latter, the sample coordinates are
np.linspace(0, 1, samples). For example,
Cycle('Reds', 5)divides the
'Reds'colormap into five evenly spaced colors.
name (str, optional) – Name of the resulting
ListedColormapused to register the color cycle. Default name is
marker, alpha, dashes, linestyle, linewidth, markersize, markeredgewidth, markeredgecolor, markerfacecolor (list of specs, optional) – Lists of
Line2Dproperties that can be added to the
Cyclerinstance. If the lists have unequal length, they will be filled to match the length of the longest list. See
set_prop_cyclefor more info on cyclers. Also see the line style reference, the marker reference, and the custom dashes reference.
save (bool, optional) – Whether to save the
ListedColormapassociated with this cycle. See
save_kw (dict-like, optional) – Ignored if
False. Passed to
ListedColormapassociated with this cycle.
**kwargs – Passed to
Colormapwhen the input is not already a
Cycler– A cycler instance that can be passed to