DOC: Add plot types section to quickstart

melissawm · melissawm · commit c0659d4cce98 · 2023-05-25T20:22:19.000-03:00
Also creates a Patches under the Artists explanations.
diff --git a/galleries/users_explain/artists/index.rst b/galleries/users_explain/artists/index.rst
@@ -176,7 +176,8 @@ Note that when we add an Artist manually like this, it doesn't necessarily
 adjust the axis limits like most of the helper methods do, so the Artists can
 be clipped, as is the case above for the ``clipped_circle`` patch.
 
-See :ref:`artist_reference` for other patches.
+See :ref:`artist_reference` or :ref:`patches_artists` for more information on
+patches.
 
 Removing Artists
 ~~~~~~~~~~~~~~~~
@@ -198,3 +199,4 @@ More details
     Concept: Path effects guide <patheffects_guide>
     In Depth: understanding the extent keyword argument of imshow <imshow_extent>
     transforms_tutorial
+    patches
diff --git a/galleries/users_explain/artists/patches.py b/galleries/users_explain/artists/patches.py
@@ -0,0 +1,28 @@
+"""
+.. _patches_artists:
+
+=======
+Patches
+=======
+
+:mod:`Patches <matplotlib.patches>` are a family of Artists that can be used
+when drawing arbitrary two-dimensional regions. In addition to the general
+Patch Artists :class:`~.patches.PathPatch` and :class:`~.patches.Polygon`,
+common shapes have corresponding Patch Artists such as
+:class:`~.patches.Circle`, :class:`~.patches.Rectangle`,
+:class:`~.patches.Ellipse`, etc.
+"""
+
+import matplotlib.pyplot as plt
+import matplotlib as mpl
+import numpy as np
+
+fig, ax = plt.subplots()
+
+polygon = mpl.patches.Polygon(np.array([[1, 0], [0.5, 1.5], [2, 1]]), closed=True)
+ax.add_patch(polygon)
+
+circle = mpl.patches.Circle((2, 2), 0.5, facecolor='orange', edgecolor='black')
+ax.add_patch(circle)
+
+ax.set(xlim=(0, 3), ylim=(0, 3), box_aspect=1)
diff --git a/galleries/users_explain/quick_start.py b/galleries/users_explain/quick_start.py
@@ -111,6 +111,26 @@
 # Artists are drawn to the **canvas**.  Most Artists are tied to an Axes; such
 # an Artist cannot be shared by multiple Axes, or moved from one to another.
 #
+# .. _plot_types_quickstart:
+#
+# Plot types
+# ==========
+#
+# For an overview of the different types of plot you can create with Matplotlib,
+# see the :ref:`Plot types gallery <plot_types>`. If you don't find the plot
+# type you need, it may still be possible to create the visualization you want
+# by combining existing Artists and plot elements.
+#
+# * To manipulate and customize points, see :class:`~.markers.MarkerStyle`
+# * To manipulate and customize lines, see :class:`~.lines.Line2D` or
+#   :class:`~.collections.LineCollection`
+# * To manipulate and customize regions, see :mod:`matplotlib.patches`
+# * To manipulate and customize :mod:`images <matplotlib.image>`, see
+#   :class:`~.image.AxesImage`
+# * To manipulate and customize contours and (vector) fields, see
+#   `~.axes.Axes.contour` and `~.axes.Axes.quiver`, respectively.
+# * For anything else, see :ref:`artists_tutorial`.
+#
 # .. _input_types:
 #
 # Types of inputs to plotting functions
@@ -559,27 +579,6 @@ def my_plotter(ax, data1, data2, param_dict):
 # and formatters appropriate to the norm.  These can be changed as for
 # other Axis objects.
 
-# %%
-# Patches
-# =======
-#
-# :mod:`Patches <matplotlib.patches>` are a family of Artists that can be used
-# when drawing arbitrary two-dimensional regions. In addition to the general
-# Patch Artists :class:`~.patches.PathPatch` and :class:`~.patches.Polygon`,
-# common shapes have corresponding Patch Artists such as
-# :class:`~.patches.Circle`, :class:`~.patches.Rectangle`,
-# :class:`~.patches.Ellipse`, etc.
-
-fig, ax = plt.subplots()
-
-polygon = mpl.patches.Polygon(np.array([[1, 0], [0.5, 1.5], [2, 1]]), closed=True)
-ax.add_patch(polygon)
-
-circle = mpl.patches.Circle((2, 2), 0.5, facecolor='orange', edgecolor='black')
-ax.add_patch(circle)
-
-ax.set(xlim=(0, 3), ylim=(0, 3), box_aspect=1)
-
 # %%
 # Working with multiple Figures and Axes
 # ======================================
