SF.net SVN: matplotlib: [5390] trunk/matplotlib

[<jd...@us...>]

Revision: 5390
          http://matplotlib.svn.sourceforge.net/matplotlib/?rev=5390&view=rev
Author:   jdh2358
Date:     2008-06-04 12:11:16 -0700 (Wed, 04 Jun 2008)

Log Message:
-----------
added suptitle

Modified Paths:
--------------
    trunk/matplotlib/CHANGELOG
    trunk/matplotlib/examples/pylab_examples/figtext.py
    trunk/matplotlib/lib/matplotlib/figure.py
    trunk/matplotlib/lib/matplotlib/pylab.py
    trunk/matplotlib/lib/matplotlib/pyplot.py

Modified: trunk/matplotlib/CHANGELOG
===================================================================
--- trunk/matplotlib/CHANGELOG	2008-06-04 18:52:07 UTC (rev 5389)
+++ trunk/matplotlib/CHANGELOG	2008-06-04 19:11:16 UTC (rev 5390)
@@ -1,3 +1,6 @@
+2006-06-04 Added a figure title command subtitle as a Figure method
+           and pyplot command -- see examples/figure_title.py - JDH
+
 2008-06-02 Added support for log to hist with histtype='step' and fixed
            a bug for log-scale stacked histograms - MM
 

Modified: trunk/matplotlib/examples/pylab_examples/figtext.py
===================================================================
--- trunk/matplotlib/examples/pylab_examples/figtext.py	2008-06-04 18:52:07 UTC (rev 5389)
+++ trunk/matplotlib/examples/pylab_examples/figtext.py	2008-06-04 19:11:16 UTC (rev 5390)
@@ -16,10 +16,7 @@
 plot(t1, f(t1), 'bo', t2, f(t2), 'k')
 title('subplot 1')
 ylabel('Damped oscillation')
-figtitle = 'This is a somewhat long figure title'
-t = gcf().text(0.5, 0.95, figtitle,
-               horizontalalignment='center',
-               fontproperties=FontProperties(size=16))
+suptitle('This is a somewhat long figure title', fontsize=16)
 
 
 subplot(122)

Modified: trunk/matplotlib/lib/matplotlib/figure.py
===================================================================
--- trunk/matplotlib/lib/matplotlib/figure.py	2008-06-04 18:52:07 UTC (rev 5389)
+++ trunk/matplotlib/lib/matplotlib/figure.py	2008-06-04 19:11:16 UTC (rev 5390)
@@ -313,6 +313,35 @@
         'get the figure bounding box in display space; kwargs are void'
         return self.bbox
 
+    def suptitle(self, t, **kwargs):
+        """
+        add a centered title to the figure
+
+        kwargs are matplotlib.text.Text properties.  Using figure
+        coordinates, the defaults are
+
+          x = 0.5
+          y = 0.98
+          horizontalalignment = 'center'
+          verticalalignment = 'top'
+
+        The matplotlib.text.Text instance is returned
+
+        Example:
+
+          fig.subtitle('this is the figure title', fontsize=12)
+        """
+        x = kwargs.pop('x', 0.5)
+        y = kwargs.pop('y', 0.98)
+        if ('horizontalalignment' not in kwargs) and ('ha' not in kwargs):
+            kwargs['horizontalalignment'] = 'center'
+
+        if ('verticalalignment' not in kwargs) and ('va' not in kwargs):
+            kwargs['verticalalignment'] = 'top'
+
+        t = self.text(x, y, t, **kwargs)
+        return t
+
     def set_canvas(self, canvas):
         """
         Set the canvas the contains the figure

Modified: trunk/matplotlib/lib/matplotlib/pylab.py
===================================================================
--- trunk/matplotlib/lib/matplotlib/pylab.py	2008-06-04 18:52:07 UTC (rev 5389)
+++ trunk/matplotlib/lib/matplotlib/pylab.py	2008-06-04 19:11:16 UTC (rev 5390)
@@ -78,6 +78,7 @@
   subplot  - make a subplot (numrows, numcols, axesnum)
   subplots_adjust - change the params controlling the subplot positions of current figure
   subplot_tool - launch the subplot configuration tool
+  suptitle   - add a figure title
   table    - add a table to the plot
   text     - add some text at location x,y to the current axes
   thetagrids - customize the radial theta grids and labels for polar

Modified: trunk/matplotlib/lib/matplotlib/pyplot.py
===================================================================
--- trunk/matplotlib/lib/matplotlib/pyplot.py	2008-06-04 18:52:07 UTC (rev 5389)
+++ trunk/matplotlib/lib/matplotlib/pyplot.py	2008-06-04 19:11:16 UTC (rev 5390)
@@ -303,6 +303,13 @@
 if Figure.text.__doc__ is not None:
     figtext.__doc__ = dedent(Figure.text.__doc__)
 
+def suptitle(*args, **kwargs):
+    ret =  gcf().suptitle(*args, **kwargs)
+    draw_if_interactive()
+    return ret
+if Figure.suptitle.__doc__ is not None:
+    suptitle.__doc__ = dedent(Figure.suptitle.__doc__)
+
 def figimage(*args, **kwargs):
     # allow callers to override the hold state by passing hold=True|False
     ret =  gcf().figimage(*args, **kwargs)


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.