.. only:: html
.. note::
:class: sphx-glr-download-link-note
Click :ref:`here ` to download the full example code
.. rst-class:: sphx-glr-example-title
.. _sphx_glr_tutorials_intermediate_color_cycle.py:
===================
Styling with cycler
===================
Demo of custom property-cycle settings to control colors and other style
properties for multi-line plots.
.. note::
More complete documentation of the ``cycler`` API can be found
`here `_.
This example demonstrates two different APIs:
1. Setting the rc parameter specifying the default property cycle.
This affects all subsequent axes (but not axes already created).
2. Setting the property cycle for a single pair of axes.
.. code-block:: default
from cycler import cycler
import numpy as np
import matplotlib.pyplot as plt
First we'll generate some sample data, in this case, four offset sine
curves.
.. code-block:: default
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])
Now ``yy`` has shape
.. code-block:: default
print(yy.shape)
.. rst-class:: sphx-glr-script-out
Out:
.. code-block:: none
(50, 4)
So ``yy[:, i]`` will give you the ``i``-th offset sine curve. Let's set the
default ``prop_cycle`` using :func:`matplotlib.pyplot.rc`. We'll combine a
color cycler and a linestyle cycler by adding (``+``) two ``cycler``'s
together. See the bottom of this tutorial for more information about
combining different cyclers.
.. code-block:: default
default_cycler = (cycler(color=['r', 'g', 'b', 'y']) +
cycler(linestyle=['-', '--', ':', '-.']))
plt.rc('lines', linewidth=4)
plt.rc('axes', prop_cycle=default_cycler)
Now we'll generate a figure with two axes, one on top of the other. On the
first axis, we'll plot with the default cycler. On the second axis, we'll
set the ``prop_cycle`` using :func:`matplotlib.axes.Axes.set_prop_cycle`,
which will only set the ``prop_cycle`` for this :mod:`matplotlib.axes.Axes`
instance. We'll use a second ``cycler`` that combines a color cycler and a
linewidth cycler.
.. code-block:: default
custom_cycler = (cycler(color=['c', 'm', 'y', 'k']) +
cycler(lw=[1, 2, 3, 4]))
fig, (ax0, ax1) = plt.subplots(nrows=2)
ax0.plot(yy)
ax0.set_title('Set default color cycle to rgby')
ax1.set_prop_cycle(custom_cycler)
ax1.plot(yy)
ax1.set_title('Set axes color cycle to cmyk')
# Add a bit more space between the two plots.
fig.subplots_adjust(hspace=0.3)
plt.show()
.. image:: /tutorials/intermediate/images/sphx_glr_color_cycle_001.png
:alt: Set default color cycle to rgby, Set axes color cycle to cmyk
:class: sphx-glr-single-img
Setting ``prop_cycle`` in the :file:`matplotlibrc` file or style files
----------------------------------------------------------------------
Remember, a custom cycler can be set in your :file:`matplotlibrc`
file or a style file (:file:`style.mplstyle`) under ``axes.prop_cycle``:
.. code-block:: python
axes.prop_cycle : cycler(color='bgrcmyk')
Cycling through multiple properties
-----------------------------------
You can add cyclers:
.. code-block:: python
from cycler import cycler
cc = (cycler(color=list('rgb')) +
cycler(linestyle=['-', '--', '-.']))
for d in cc:
print(d)
Results in:
.. code-block:: python
{'color': 'r', 'linestyle': '-'}
{'color': 'g', 'linestyle': '--'}
{'color': 'b', 'linestyle': '-.'}
You can multiply cyclers:
.. code-block:: python
from cycler import cycler
cc = (cycler(color=list('rgb')) *
cycler(linestyle=['-', '--', '-.']))
for d in cc:
print(d)
Results in:
.. code-block:: python
{'color': 'r', 'linestyle': '-'}
{'color': 'r', 'linestyle': '--'}
{'color': 'r', 'linestyle': '-.'}
{'color': 'g', 'linestyle': '-'}
{'color': 'g', 'linestyle': '--'}
{'color': 'g', 'linestyle': '-.'}
{'color': 'b', 'linestyle': '-'}
{'color': 'b', 'linestyle': '--'}
{'color': 'b', 'linestyle': '-.'}
.. _sphx_glr_download_tutorials_intermediate_color_cycle.py:
.. only :: html
.. container:: sphx-glr-footer
:class: sphx-glr-footer-example
.. container:: sphx-glr-download sphx-glr-download-python
:download:`Download Python source code: color_cycle.py `
.. container:: sphx-glr-download sphx-glr-download-jupyter
:download:`Download Jupyter notebook: color_cycle.ipynb `
.. only:: html
.. rst-class:: sphx-glr-signature
Keywords: matplotlib code example, codex, python plot, pyplot
`Gallery generated by Sphinx-Gallery
`_