.. 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 `_