Update docs, examples, for new color kwarg in hist.

efiring · efiring · commit e79a0bb6d7bd · 2010-04-03T23:22:48.000Z
svn path=/trunk/matplotlib/; revision=8220
diff --git a/CHANGELOG b/CHANGELOG
@@ -1,7 +1,10 @@
-2010-03-24 refactor colorbar code so that no cla() is necessary when 
+2010-04-03 Added color kwarg to Axes.hist(), based on work by
+           Jeff Klukas. - EF
+
+2010-03-24 refactor colorbar code so that no cla() is necessary when
            mappable is changed. -JJL
 
-2010-03-22 fix incorrect rubber band during the zoom mode when mouse 
+2010-03-22 fix incorrect rubber band during the zoom mode when mouse
            leaves the axes. -JJL
 
 2010-03-21 x/y key during the zoom mode only changes the x/y limits. -JJL
diff --git a/doc/api/api_changes.rst b/doc/api/api_changes.rst
@@ -10,6 +10,9 @@ list may help describe what changes may be necessary in your code.
 Changes beyond 0.99.x
 =====================
 
+* The :meth:`matplotlib.axes.Axes.hist` *color* kwarg now accepts
+  a sequence of color specs to match a sequence of datasets.
+
 * The :class:'~matplotlib.collections.EllipseCollection' has been
   changed in two ways:
 
@@ -19,7 +22,7 @@ Changes beyond 0.99.x
 
   + The *height* and *width* kwargs have been changed to specify
     the height and width, again for consistency with
-    :class:'~matplotlib.patches.Ellipse`, and to better match
+    :class:`~matplotlib.patches.Ellipse`, and to better match
     their names; previously they specified the half-height and
     half-width.
 
diff --git a/examples/pylab_examples/histogram_demo_extended.py b/examples/pylab_examples/histogram_demo_extended.py
@@ -63,13 +63,18 @@
 
 #
 # histogram has the ability to plot multiple data in parallel ...
+# Note the new color kwarg, used to override the default, which
+# uses the line color cycle.
 #
 P.figure()
 
 # create a new data-set
 x = mu + sigma*P.randn(1000,3)
 
-n, bins, patches = P.hist(x, 10, normed=1, histtype='bar')
+n, bins, patches = P.hist(x, 10, normed=1, histtype='bar',
+                            color=['crimson', 'burlywood', 'chartreuse'],
+                            label=['Crimson', 'Burlywood', 'Chartreuse'])
+P.legend()
 
 #
 # ... or we can stack the data

Original file line number	Diff line number	Diff line change
`@@ -63,13 +63,18 @@`
`63`	`63`
`64`	`64`	`#`
`65`	`65`	`# histogram has the ability to plot multiple data in parallel ...`
	`66`	`+# Note the new color kwarg, used to override the default, which`
	`67`	`+# uses the line color cycle.`
`66`	`68`	`#`
`67`	`69`	`P.figure()`
`68`	`70`
`69`	`71`	`# create a new data-set`
`70`	`72`	`x = mu + sigma*P.randn(1000,3)`
`71`	`73`
`72`		`-n, bins, patches = P.hist(x, 10, normed=1, histtype='bar')`
	`74`	`+n, bins, patches = P.hist(x, 10, normed=1, histtype='bar',`
	`75`	`+ color=['crimson', 'burlywood', 'chartreuse'],`
	`76`	`+ label=['Crimson', 'Burlywood', 'Chartreuse'])`
	`77`	`+P.legend()`
`73`	`78`
`74`	`79`	`#`
`75`	`80`	`# ... or we can stack the data`