Update Subplot Demo eg to OO format, add link to related eg

dmgt · dmgt · commit 39ca4abed870 · 2017-07-16T16:02:34.000-05:00
diff --git a/examples/subplots_axes_and_figures/subplot_demo.py b/examples/subplots_axes_and_figures/subplot_demo.py
@@ -1,28 +1,28 @@
 """
-============
-Subplot Demo
-============
+==================
+Basic Subplot Demo
+==================
 
-Simple demo with multiple subplots.
+Demo with two subplots.
+For more options, see
+:ref:`sphx_glr_examples_subplots_axes_and_figures_subplots_demo.py`
 """
 import numpy as np
 import matplotlib.pyplot as plt
 
-
+# Data for plotting
 x1 = np.linspace(0.0, 5.0)
 x2 = np.linspace(0.0, 2.0)
-
 y1 = np.cos(2 * np.pi * x1) * np.exp(-x1)
 y2 = np.cos(2 * np.pi * x2)
 
-plt.subplot(2, 1, 1)
-plt.plot(x1, y1, 'ko-')
-plt.title('A tale of 2 subplots')
-plt.ylabel('Damped oscillation')
+# Create two subplots sharing y axis
+fig, (ax1, ax2) = plt.subplots(2, sharey=True)
+
+ax1.plot(x1, y1, 'ko-')
+ax1.set(title='A tale of 2 subplots', ylabel='Damped oscillation')
 
-plt.subplot(2, 1, 2)
-plt.plot(x2, y2, 'r.-')
-plt.xlabel('time (s)')
-plt.ylabel('Undamped')
+ax2.plot(x2, y2, 'r.-')
+ax2.set(xlabel='time (s)', ylabel='Undamped')
 
-plt.show()
+plt.show()
