matplotlib
diff --git a/‎examples/dynamic_collection.py‎
Lines changed: 48 additions & 0 deletions b/‎examples/dynamic_collection.py‎
Lines changed: 48 additions & 0 deletions
diff --git a/‎lib/matplotlib/backends/backend_tkagg.py‎
Lines changed: 3 additions & 1 deletion b/‎lib/matplotlib/backends/backend_tkagg.py‎
Lines changed: 3 additions & 1 deletion
diff --git a/‎lib/matplotlib/collections.py‎
Lines changed: 45 additions & 15 deletions b/‎lib/matplotlib/collections.py‎
Lines changed: 45 additions & 15 deletions
@@ -0,0 +1,48 @@
+import random
+from matplotlib.colors import colorConverter
+from matplotlib.collections import RegularPolyCollection 
+import matplotlib.cm as cm
+from pylab import figure, show, nx
+
+fig = figure()
+ax = fig.add_subplot(111, xlim=(0,1), ylim=(0,1), autoscale_on=False)
+ax.set_title("Press 'a' to add a point, 'd' to delete one")
+# a single point
+offsets = [(0.5,0.5)]
+facecolors = [cm.jet(0.5)]
+
+collection = RegularPolyCollection(
+    fig.dpi,
+    numsides=5, # a pentagon
+    rotation=0,
+    sizes=(50,), 
+    facecolors = facecolors,
+    edgecolors = (colorConverter.to_rgba('black'),),
+    linewidths = (1,),
+    offsets = offsets,
+    transOffset = ax.transData,
+    )
+
+ax.add_collection(collection)
+
+def onpress(event):
+    """
+    press 'a' to add a random point from the collection, 'd' to delete one
+    """
+    if event.key=='a':
+        x,y = nx.mlab.rand(2)
+        color = cm.jet(nx.mlab.rand())
+        offsets.append((x,y))
+        facecolors.append(color)
+        fig.canvas.draw()
+    elif event.key=='d':
+        N = len(offsets)
+        if N>0:
+            ind = random.randint(0,N-1)
+            offsets.pop(ind)
+            facecolors.pop(ind)
+            fig.canvas.draw()
+
+fig.canvas.mpl_connect('key_press_event', onpress)
+
+show()
@@ -63,7 +63,9 @@ def show():
     """
     Show all the figures and enter the gtk mainloop
 
-    This should be the last line of your script
+    This should be the last line of your script.  This function sets
+    interactive mode to True, as detailed on
+    http://matplotlib.sf.net/interactive.html
     """
     for manager in Gcf.get_all_fig_managers():
         manager.show()
 
@@ -288,36 +288,66 @@ def __init__(self,
                  sizes = (1,),
                  **kwargs):
         """
-        Draw a regular polygon with numsides.  sizes gives the area of
-        the circle circumscribing the regular polygon and rotation is
-        the rotation of the polygon in radians.
+        Draw a regular polygon with numsides.
+
+        * dpi is the figure dpi instance, and is required to do the
+          area scaling.
+
+        * numsides: the number of sides of the  polygon
+        
+        * sizes gives the area of the circle circumscribing the
+          regular polygon in points^2
+
+        * rotation is the rotation of the polygon in radians
+
+        kwargs: See PatchCollection for more details
+        
+          * offsets are a sequence of x,y tuples that give the centers of
+            the polygon in data coordinates
+
+          * transOffset is the Transformation instance used to
+            transform the centers onto the canvas.
+
+        Example: see examples/dynamic_collection.py for complete example
+
+        offsets = nx.mlab.rand(20,2)
+        facecolors = [cm.jet(x) for x in nx.mlab.rand(20)]
+        black = (0,0,0,1)
+        
+        collection = RegularPolyCollection(
+            fig.dpi,
+            numsides=5, # a pentagon
+            rotation=0,
+            sizes=(50,), 
+            facecolors = facecolors,
+            edgecolors = (black,),
+            linewidths = (1,),
+            offsets = offsets,
+            transOffset = ax.transData,
+            )
 
-        offsets are a sequence of x,y tuples that give the centers of
-        the polygon in data coordinates, and transOffset is the
-        Transformation instance used to transform the centers onto the
-        canvas.
 
-        dpi is the figure dpi instance, and is required to do the area
-        scaling.
         """
         PatchCollection.__init__(self,**kwargs)
-        self._sizes = asarray(sizes)
+        self._sizes = sizes
         self._dpi = dpi
+        self.numsides = numsides
+        self.rotation = rotation
+        self._update_verts()
 
+    def _update_verts(self):
         r = 1.0/math.sqrt(math.pi)  # unit area
-
-        theta = (2*math.pi/numsides)*arange(numsides) + rotation
+        theta = (2*math.pi/self.numsides)*arange(self.numsides) + self.rotation
         self._verts = zip( r*sin(theta), r*cos(theta) )
 
-
-
     def draw(self, renderer):
         if not self.get_visible(): return
         renderer.open_group('regpolycollection')
         self._transform.freeze()
         self._transOffset.freeze()
         self.update_scalarmappable()
-        scales = sqrt(self._sizes*self._dpi.get()/72.0)
+        self._update_verts()        
+        scales = sqrt(asarray(self._sizes)*self._dpi.get()/72.0)
 
         if is_string_like(self._edgecolors) and self._edgecolors == 'None':
             self._edgecolors = self._facecolors