matplotlib · phobson · Mar 23, 2017 · Mar 10, 2017
diff --git a/doc/faq/howto_faq.rst b/doc/faq/howto_faq.rst
@@ -353,7 +353,8 @@ some ratio which controls the ratio::
 
 .. htmlonly::
 
-    See :ref:`pylab_examples-equal_aspect_ratio` for a complete example.
+    See :ref:`subplots_axes_and_figures-plot_equal_aspect_ratio` for a complete
+    example.
 
 
 .. _howto-twoscale:

diff --git a/examples/pylab_examples/equal_aspect_ratio.py b/examples/pylab_examples/equal_aspect_ratio.py
diff --git a/examples/subplots_axes_and_figures/plot_equal_aspect_ratio.py b/examples/subplots_axes_and_figures/plot_equal_aspect_ratio.py
@@ -0,0 +1,26 @@
+"""
+=================
+Equal aspect axes
+=================
+
+This example shows how to make a plot whose x and y axes have a 1:1 aspect
+ratio.
+"""
+import matplotlib.pyplot as plt
+import numpy as np
+
+t = np.arange(0.0, 1.0 + 0.01, 0.01)
+s = np.cos(2 * 2 * np.pi * t)
+
+fig, ax = plt.subplots()
+ax.plot(t, s, '-', lw=2)
+
+ax.set_xlabel('Time (s)')
+ax.set_ylabel('Voltage (mV)')
+ax.set_title('About as simple as it gets, folks')
+ax.grid(True)
+
+ax.set_aspect('equal', 'datalim')
+
+fig.tight_layout()
+plt.show()