ENH: Add the ability to have a separate title for each subplot when plotting

doc/source/whatsnew/v0.20.0.txt

@@ -40,7 +40,7 @@ Other enhancements
 ^^^^^^^^^^^^^^^^^^
 
 - ``pd.read_excel`` now preserves sheet order when using ``sheetname=None`` (:issue:`9930`)
-
+- ``pd.DataFrame.plot`` now prints a title above each subplot if ``suplots=True`` and ``title`` is a list of strings
 
 .. _whatsnew_0200.api_breaking:
 

pandas/tests/plotting/test_misc.py

@@ -16,13 +16,11 @@
 from pandas.tests.plotting.common import (TestPlotBase, _check_plot_works,
                                           _ok_for_gaussian_kde)
 
-
 """ Test cases for misc plot functions """
 
 
 @tm.mplskip
 class TestSeriesPlots(TestPlotBase):
-
     def setUp(self):
         TestPlotBase.setUp(self)
         import matplotlib as mpl
@@ -54,7 +52,6 @@ def test_bootstrap_plot(self):
 
 @tm.mplskip
 class TestDataFramePlots(TestPlotBase):
-
     @slow
     def test_scatter_plot_legacy(self):
         tm._skip_if_no_scipy()
@@ -277,6 +274,24 @@ def test_radviz(self):
         handles, labels = ax.get_legend_handles_labels()
         self._check_colors(handles, facecolors=colors)
 
+    @slow
+    def test_subplot_titles(self):
+        df = self.iris.drop('Name', axis=1).head()
+        # Use the column names as the subplot titles
+        title = list(df.columns)
+
+        # Case len(title) == len(df)
+        plot = df.plot(subplots=True, title=title)
+        self.assertEqual([p.title._text for p in plot], title)
+
+        # Case len(title) > len(df)
+        plot = df.plot(subplots=True, title=title + ['Ignore me!'])
+        self.assertEqual([p.title._text for p in plot], title)
+
+        # Case len(title) < len(df)
+        plot = df.plot(subplots=True, title=title[:2])
+        self.assertEqual([p.title._text for p in plot], title[:2] + ['', ''])
+
 
 if __name__ == '__main__':
     nose.runmodule(argv=[__file__, '-vvs', '-x', '--pdb', '--pdb-failure'],

pandas/tools/plotting.py

@@ -1217,7 +1217,11 @@ def _adorn_subplots(self):
 
         if self.title:
             if self.subplots:
-                self.fig.suptitle(self.title)
+                if is_list_like(self.title):
+                    for (ax, title) in zip(self.axes, self.title):
+                        ax.set_title(title)
+                else:
+                    self.fig.suptitle(self.title)
             else:
                 self.axes[0].set_title(self.title)
 
@@ -2555,8 +2559,12 @@ def _plot(data, x=None, y=None, subplots=False,
     figsize : a tuple (width, height) in inches
     use_index : boolean, default True
         Use index as ticks for x axis
-    title : string
-        Title to use for the plot
+    title : string or list
+        If a string is passed, print the string at the top of the figure. If a
+        list of strings is passed and subplots is True, print the the first
+        string above the first subplot, the second string above the second
+        subplot, and so forth until the end of the list is reached or there are
+        no more subplots.
     grid : boolean, default None (matlab style default)
         Axis grid lines
     legend : False/True/'reverse'