DOC: update hatch_style_reference

jklymak · jklymak · commit 9cd0a746963f · 2020-07-14T21:38:00.000-07:00
diff --git a/examples/shapes_and_collections/hatch_style_reference.py b/examples/shapes_and_collections/hatch_style_reference.py
@@ -1,47 +1,66 @@
 """
-=====================
-Hatch style reference
-=====================
+=======
+Hatches
+=======
 
-Hatching (pattern filled polygons) is currently supported in the backends
-PS, PDF, SVG and Agg. The backends OSX, WX and Cairo ignore hatching.
+Hatching (pattern filled polygons) is currently supported in the PS, PDF, SVG,
+OSX, and Agg backends. The WX and Cairo backends ignore hatching.
+
+See also :doc:`/gallery/images_contours_and_fields/contourf_hatching` for
+an example using `~.Axes.contourf`, and
+:doc:`/gallery/shapes_and_collections/hatch_demo` for examples using
+`~.Axes.bar` and polygons.
 """
+
+import numpy as np
 import matplotlib.pyplot as plt
-from matplotlib.patches import Rectangle
+from matplotlib.patches import Ellipse, Polygon, Rectangle
 
-fig, axs = plt.subplots(2, 5, constrained_layout=True, figsize=(6.4, 3.2))
+x = np.arange(1, 5)
+y1 = np.arange(1, 5)
+y2 = np.ones(y1.shape) * 4
 
-hatches = ['/', '\\', '|', '-', '+', 'x', 'o', 'O', '.', '*']
+fig, (ax1, ax2, ax3) = plt.subplots(3)
 
+ax1.bar(x, y1, edgecolor='black', hatch="/")
+ax1.bar(x, y2, bottom=y1, edgecolor='black', hatch='//')
+ax1.set_xticks([1.5, 2.5, 3.5, 4.5])
 
-def hatches_plot(ax, h):
-    ax.add_patch(Rectangle((0, 0), 2, 2, fill=False, hatch=h))
-    ax.text(1, -0.5, f"' {h} '", size=15, ha="center")
-    ax.axis('equal')
-    ax.axis('off')
-
-for ax, h in zip(axs.flat, hatches):
-    hatches_plot(ax, h)
+ax2.bar(x, y1, edgecolor='black', hatch=['-', '+', 'x', '\\'])
+ax2.bar(x, y2, bottom=y1, edgecolor='black', hatch=['*', 'o', 'O', '.'])
+ax2.set_xticks([1.5, 2.5, 3.5, 4.5])
 
-###############################################################################
-# Hatching patterns can be repeated to increase the density.
+ax3.fill([1, 3, 3, 1], [1, 1, 2, 2], fill=False, hatch='\\')
+ax3.add_patch(Ellipse((4, 1.5), 4, 0.5, fill=False, hatch='*'))
+ax3.add_patch(Polygon([[0, 0], [4, 1.1], [6, 2.5], [2, 1.4]], closed=True,
+                      fill=False, hatch='/'))
+ax3.set_xlim((0, 6))
+ax3.set_ylim((0, 2.5))
 
-fig, axs = plt.subplots(2, 5, constrained_layout=True, figsize=(6.4, 3.2))
+plt.show()
 
-hatches = ['//', '\\\\', '||', '--', '++', 'xx', 'oo', 'OO', '..', '**']
+#############################################################################
+# Hatch style reference
+# ---------------------
+#
+# For convenience we document the 10 different possible hatch styles using the
+# code below:
 
-for ax, h in zip(axs.flat, hatches):
-    hatches_plot(ax, h)
+fig, axs = plt.subplots(2, 5, constrained_layout=True, figsize=(6, 3))
 
-###############################################################################
-# Hatching patterns can be combined to create additional patterns.
+hatches = ['/', '\\', '|', '-', '+', 'x', 'o', 'O', '.', '*']
 
-fig, axs = plt.subplots(2, 5, constrained_layout=True, figsize=(6.4, 3.2))
 
-hatches = ['/o', '\\|', '|*', '-\\', '+o', 'x*', 'o-', 'O|', 'O.', '*-']
+def hatches_plot(ax, h):
+    ax.add_patch(Rectangle((0, 0), 2, 2, fill=False, hatch=h))
+    ax.text(1, -0.5, f"' {h} '", size=10, ha="center")
+    ax.axis('equal')
+    ax.axis('off')
 
 for ax, h in zip(axs.flat, hatches):
     hatches_plot(ax, h)
+plt.show()
+
 
 #############################################################################
 #
@@ -55,6 +74,9 @@ def hatches_plot(ax, h):
 
 import matplotlib
 matplotlib.patches
-matplotlib.patches.Rectangle
+matplotlib.patches.Ellipse
+matplotlib.patches.Polygon
 matplotlib.axes.Axes.add_patch
-matplotlib.axes.Axes.text
+matplotlib.patches.Patch.set_hatch
+matplotlib.axes.Axes.bar
+matplotlib.pyplot.bar
