Cycler

0.12.1 · active · verified Sat Mar 28

Cycler is a Python library for creating composable style cycles, allowing for flexible and reusable combinations of style properties. The current version is 0.12.1, released on a regular basis, with the latest release on March 28, 2026.

Warnings

breaking Cycler 0.12.1 introduces changes to the 'Cycler' class constructor, which may affect existing code that relies on the previous constructor signature.
Fix: Update the constructor calls to match the new signature as per the latest documentation.
gotcha When using Cycler with Matplotlib, ensure that the 'cycler' module is imported before creating plots to avoid potential conflicts with Matplotlib's default style cycle.
Fix: Import 'cycler' before importing 'matplotlib.pyplot' to ensure the custom style cycle is applied correctly.

Install

pip install cycler Install Cycler

Imports

cycler
```
from cycler import cycler
```
Importing the 'cycler' function from the 'cycler' module.
Cycler
```
from cycler import Cycler
```
Importing the 'Cycler' class from the 'cycler' module.

Quickstart

This example demonstrates how to use Cycler to create a custom style cycle for plotting multiple sine curves with different colors and line styles.

from cycler import cycler
import matplotlib.pyplot as plt
import numpy as np

# Generate sample data
x = np.linspace(0, 2 * np.pi, 50)
offsets = np.linspace(0, 2 * np.pi, 4, endpoint=False)
yy = np.transpose([np.sin(x + phi) for phi in offsets])

# Create a cycler object
style_cycler = cycler(color=['r', 'g', 'b', 'c'], linestyle=['-', '--', '-.'])

# Apply the cycler to the current axes
plt.gca().set_prop_cycle(style_cycler)

# Plot the data
for y in yy:
    plt.plot(x, y)

plt.show()

view raw JSON →