matplotlib · timhoffm · Mar 17, 2022 · Jan 20, 2022
diff --git a/examples/lines_bars_and_markers/scatter_custom_symbol.py b/examples/lines_bars_and_markers/scatter_custom_symbol.py
@@ -1,18 +1,43 @@
 """
-=====================
-Scatter Custom Symbol
-=====================
-
-Creating a custom ellipse symbol in scatter plot.
+=================================
+Scatter plots with custom symbols
+=================================
 
+.. redirect-from:: /gallery/lines_bars_and_markers/scatter_symbol
+.. redirect-from:: /gallery/lines_bars_and_markers/scatter_piecharts
 """
+
+##############################################################################
+# Using TeX symbols
+# -----------------
+# An easy way to customize scatter symbols is passing a TeX symbol name
+# enclosed in $-signs as a marker. Below we use ``marker=r'$\clubsuit$'``.
+
 import matplotlib.pyplot as plt
 import numpy as np
 
-
 # Fixing random state for reproducibility
 np.random.seed(19680801)
 
+
+x = np.arange(0.0, 50.0, 2.0)
+y = x ** 1.3 + np.random.rand(*x.shape) * 30.0
+sizes = np.random.rand(*x.shape) * 800 + 500
+
+fig, ax = plt.subplots()
+ax.scatter(x, y, sizes, c="green", alpha=0.5, marker=r'$\clubsuit$',
+           label="Luck")
+ax.set_xlabel("Leprechauns")
+ax.set_ylabel("Gold")
+ax.legend()
+plt.show()
+
+##############################################################################
+# Using a custom path
+# -------------------
+# Alternatively, one can also pass a custom path of N vertices as a Nx2 array
+# of x, y values as *marker*.
+
 # unit area ellipse
 rx, ry = 3., 1.
 area = rx * ry * np.pi

diff --git a/examples/lines_bars_and_markers/scatter_piecharts.py b/examples/lines_bars_and_markers/scatter_piecharts.py
diff --git a/examples/lines_bars_and_markers/scatter_symbol.py b/examples/lines_bars_and_markers/scatter_symbol.py