Merge branch 'fat-crocodile-counterclock'

Conflicts:
	doc/api/api_changes.rst

fixed conflict in api_changes.rst

Author: tacaswell

CHANGELOG

@@ -1,3 +1,5 @@
+2014-03-13 Add parameter 'clockwise' to function pie, True by default.
+
 2014-27-02  Implemented separate horizontal/vertical axes padding to the
            ImageGrid in the AxesGrid toolkit
 

doc/api/api_changes.rst

@@ -147,6 +147,8 @@ original location:
 * Added support for skewed transforms to `matplotlib.transforms.Affine2D`,
   which can be created using the `skew` and `skew_deg` methods.
 
+* Added clockwise parameter to control sectors direction in `axes.pie`
+
 
 .. _changes_in_1_3:
 

lib/matplotlib/axes/_axes.py

@@ -2335,8 +2335,8 @@ def stem(self, *args, **kwargs):
         return stem_container
 
     def pie(self, x, explode=None, labels=None, colors=None,
-            autopct=None, pctdistance=0.6, shadow=False,
-            labeldistance=1.1, startangle=None, radius=None):
+            autopct=None, pctdistance=0.6, shadow=False, labeldistance=1.1,
+            startangle=None, radius=None, counterclock=True):
         r"""
         Plot a pie chart.
 
@@ -2390,6 +2390,9 @@ def pie(self, x, explode=None, labels=None, colors=None,
           *radius*: [ *None* | scalar ]
           The radius of the pie, if *radius* is *None* it will be set to 1.
 
+          *counterclock*: [ *False* | *True* ]
+            Specify fractions direction, clockwise or counterclockwise.
+
         The pie chart will probably look best if the figure and axes are
         square, or the Axes aspect is equal.  e.g.::
 
@@ -2449,13 +2452,14 @@ def pie(self, x, explode=None, labels=None, colors=None,
         i = 0
         for frac, label, expl in cbook.safezip(x, labels, explode):
             x, y = center
-            theta2 = theta1 + frac
+            theta2 = (theta1 + frac) if counterclock else (theta1 - frac)
             thetam = 2 * math.pi * 0.5 * (theta1 + theta2)
             x += expl * math.cos(thetam)
             y += expl * math.sin(thetam)
 
-            w = mpatches.Wedge((x, y), radius, 360. * theta1, 360. * theta2,
-                               facecolor=colors[i % len(colors)])
+            w = mpatches.Wedge((x, y), radius, 360. * min(theta1, theta2),
+                            360. * max(theta1, theta2),
+                            facecolor=colors[i % len(colors)])
             slices.append(w)
             self.add_patch(w)
             w.set_label(label)