Add example for label_outer.

anntzer · anntzer · commit f5c1ab7ff86c · 2016-06-21T12:07:12.000-07:00
diff --git a/examples/pylab_examples/subplots_demo.py b/examples/pylab_examples/subplots_demo.py
@@ -22,31 +22,32 @@
 
 # Two subplots, the axes array is 1-d
 f, axarr = plt.subplots(2, sharex=True)
+f.suptitle('Sharing X axis')
 axarr[0].plot(x, y)
-axarr[0].set_title('Sharing X axis')
 axarr[1].scatter(x, y)
 
 # Two subplots, unpack the axes array immediately
 f, (ax1, ax2) = plt.subplots(1, 2, sharey=True)
+f.suptitle('Sharing Y axis')
 ax1.plot(x, y)
-ax1.set_title('Sharing Y axis')
 ax2.scatter(x, y)
 
 # Three subplots sharing both x/y axes
-f, (ax1, ax2, ax3) = plt.subplots(3, sharex=True, sharey=True)
-ax1.plot(x, y)
-ax1.set_title('Sharing both axes')
-ax2.scatter(x, y)
-ax3.scatter(x, 2 * y ** 2 - 1, color='r')
-# Fine-tune figure; make subplots close to each other and hide x ticks for
-# all but bottom plot.
+f, axarr = plt.subplots(3, sharex=True, sharey=True)
+f.suptitle('Sharing both axes')
+axarr[0].plot(x, y)
+axarr[1].scatter(x, y)
+axarr[2].scatter(x, 2 * y ** 2 - 1, color='r')
+# Bring subplots close to each other.
 f.subplots_adjust(hspace=0)
-plt.setp([a.get_xticklabels() for a in f.axes[:-1]], visible=False)
+# Hide x labels and tick labels for all but bottom plot.
+for ax in axarr:
+    ax.label_outer()
 
 # row and column sharing
 f, ((ax1, ax2), (ax3, ax4)) = plt.subplots(2, 2, sharex='col', sharey='row')
+f.suptitle('Sharing x per column, y per row')
 ax1.plot(x, y)
-ax1.set_title('Sharing x per column, y per row')
 ax2.scatter(x, y)
 ax3.scatter(x, 2 * y ** 2 - 1, color='r')
 ax4.plot(x, 2 * y ** 2 - 1, color='r')
@@ -61,9 +62,11 @@
 axarr[1, 0].set_title('Axis [1,0]')
 axarr[1, 1].scatter(x, y ** 2)
 axarr[1, 1].set_title('Axis [1,1]')
-# Fine-tune figure; hide x ticks for top plots and y ticks for right plots
-plt.setp([a.get_xticklabels() for a in axarr[0, :]], visible=False)
-plt.setp([a.get_yticklabels() for a in axarr[:, 1]], visible=False)
+for ax in axarr.flat:
+    ax.set(xlabel='x-label', ylabel='y-label')
+# Hide x labels and tick labels for top plots and y ticks for right plots.
+for ax in axarr.flat:
+    ax.label_outer()
 
 # Four polar axes
 f, axarr = plt.subplots(2, 2, subplot_kw=dict(projection='polar'))
diff --git a/lib/matplotlib/axes/_subplots.py b/lib/matplotlib/axes/_subplots.py
@@ -125,7 +125,7 @@ def is_last_row(self):
     def is_last_col(self):
         return self.colNum == self.numCols - 1
 
-    # COVERAGE NOTE: Never used internally or from examples
+    # COVERAGE NOTE: Never used internally.
     def label_outer(self):
         """Only show "outer" labels and tick labels.
 
