Clean up and move color_cycle demo

matplotlib · tonysyu · Dec 18, 2012 · Dec 18, 2012 · Dec 18, 2012 · Dec 18, 2012
commit 30a85ba22246884573f572b758fca25c367bc55c
diff --git a/doc/conf.py b/doc/conf.py
@@ -88,6 +88,7 @@
                         'statistics',
                         'images_contours_and_fields',
                         'pie_and_polar_charts',
+                        'color',
                         'text_labels_and_annotations',
                         'ticks_and_spines',
                         'subplots_axes_and_figures',

diff --git a/doc/sphinxext/gen_gallery.py b/doc/sphinxext/gen_gallery.py
@@ -22,6 +22,7 @@
                  'subplots_axes_and_figures': 'Subplots, axes, and figures',
                  'specialty_plots': 'Specialty plots',
                  'showcase': 'Showcase',
+                 'color': 'Color',
                  'api': 'API',
                  }
 

diff --git a/examples/api/color_cycle.py b/examples/api/color_cycle.py
diff --git a/examples/color/color_cycle_demo.py b/examples/color/color_cycle_demo.py
@@ -0,0 +1,34 @@
+"""
+Demo of custom color-cycle settings to control colors for multi-line plots.
+
+This example demonstrates two different APIs:
+
+    1. Setting the default rc-parameter specifying the color cycle.
+       This affects all subsequent plots.
+    2. Setting the color cycle for a specific axes. This only affects a single
+       axes.
+"""
+import numpy as np
+import matplotlib.pyplot as plt
+
+x = np.linspace(0, 2 * np.pi)
+offsets = np.linspace(0, 2*np.pi, 4, endpoint=False)
+# Create array with shifted-sine curve along each column
+yy = np.transpose([np.sin(x + phi) for phi in offsets])
+
+plt.rc('lines', linewidth=4)
+fig, (ax0, ax1)  = plt.subplots(nrows=2)
+
+plt.rc('axes', color_cycle=['r', 'g', 'b', 'y'])
+ax0.plot(yy)
+ax0.set_title('Set default color cycle to rgby')
+
+ax1.set_color_cycle(['c', 'm', 'y', 'k'])
+ax1.plot(yy)
+ax1.set_title('Set axes color cycle to cmyk')
+
+# Tweak spacing between subplots to prevent labels from overlapping
+plt.subplots_adjust(hspace=0.3)
+plt.show()
+
+