Add new example with advanced MarkerStyle mapping

Author: deep-jkl

examples/lines_bars_and_markers/multivariate_marker_plot.py

@@ -0,0 +1,45 @@
+"""
+==============================================
+Mapping marker properties to multivariate data
+==============================================
+
+This example shows how to use different properties of markers to plot
+multivariate datasets. Following example shows an illustrative case of
+plotting success of baseball throw as an smiley face with size mapped to
+the skill of thrower, rotation mapped to the take-off angle, and thrust
+to the color of the marker.
+"""
+
+import numpy as np
+import matplotlib.pyplot as plt
+from matplotlib.markers import MarkerStyle
+from matplotlib.transforms import Affine2D
+from matplotlib.textpath import TextPath
+from matplotlib.colors import Normalize
+
+SUCCESS_SYMBOLS = [
+    TextPath((0,0), "☹"), 
+    TextPath((0,0), "😒"), 
+    TextPath((0,0), "☺"), 
+]
+
+N = 25
+np.random.seed(42)
+skills = np.random.uniform(5, 80, size=N) * 0.1 + 5
+takeoff_angles = np.random.normal(0, 90, N)
+thrusts = np.random.uniform(size=N)
+successfull = np.random.randint(0, 3, size=N)
+positions = np.random.normal(size=(N, 2)) * 5
+data = zip(skills, takeoff_angles, thrusts, successfull, positions)
+
+cmap = plt.cm.get_cmap("plasma")
+fig, ax = plt.subplots()
+fig.suptitle("Throwing success", size=14)
+for skill, takeoff, thrust, mood, pos in data:
+    t = Affine2D().scale(skill).rotate_deg(takeoff)
+    m = MarkerStyle(SUCCESS_SYMBOLS[mood], transform=t)
+    ax.plot(pos[0], pos[1], marker=m, color=cmap(thrust))
+fig.colorbar(plt.cm.ScalarMappable(norm=Normalize(0, 1), cmap=cmap),
+    ax=ax, label="Normalized Thrust [a.u.]")
+ax.set_xlabel("X position [m]")
+ax.set_ylabel("Y position [m]")

lib/matplotlib/markers.py

@@ -93,7 +93,7 @@
 
 * :doc:`/gallery/lines_bars_and_markers/marker_reference`
 * :doc:`/gallery/lines_bars_and_markers/scatter_star_poly`
-
+* :doc:`/gallery/lines_bars_and_markers/multivariate_marker_plot`
 
 .. |m00| image:: /_static/markers/m00.png
 .. |m01| image:: /_static/markers/m01.png