Merge pull request #11707 from meeseeksmachine/auto-backport-of-pr-11677-on-v2.2.2-doc

jklymak · web-flow · commit d5a77cf411a9 · 2018-07-19T16:32:19.000-07:00
Backport PR #11677 on branch v2.2.2-doc
diff --git a/examples/lines_bars_and_markers/stem_plot.py b/examples/lines_bars_and_markers/stem_plot.py
@@ -3,13 +3,23 @@
 Stem Plot
 =========
 
-Example stem plot.
+Stem plot plots vertical lines from baseline to the y-coordinate
+Plotting cosine(x) w.r.t x, using '-.' as the pattern
+for plotting vertical lines
 """
 import matplotlib.pyplot as plt
 import numpy as np
 
+# returns 10 evenly spaced samples from 0.1 to 2*PI
 x = np.linspace(0.1, 2 * np.pi, 10)
+
 markerline, stemlines, baseline = plt.stem(x, np.cos(x), '-.')
+
+# setting property of baseline with color red and linewidth 2
 plt.setp(baseline, color='r', linewidth=2)
 
 plt.show()
+
+#############################
+# This example makes use of:
+# * :meth:`matplotlib.axes.Axes.stem`
