DOC: Add plot types section to quickstart

melissawm · melissawm · commit f1a58e5575a7 · 2023-08-10T13:48:32.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
@@ -21,3 +21,4 @@ and :doc:`Axes <../axes/index>` are Artists, and generally contain
     Path effects guide <patheffects_guide>
     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
 # ======================================
