diff --git a/examples/axisartist/demo_axisline_style.py b/examples/axisartist/demo_axisline_style.py index a8e2c7ada5d7..7823e9c52b12 100644 --- a/examples/axisartist/demo_axisline_style.py +++ b/examples/axisartist/demo_axisline_style.py @@ -1,3 +1,10 @@ +""" +================ +Axis line styles +================ + +This example shows some configurations for axis style. +""" from mpl_toolkits.axisartist.axislines import SubplotZero import matplotlib.pyplot as plt @@ -9,10 +16,14 @@ fig.add_subplot(ax) for direction in ["xzero", "yzero"]: + # adds arrows at the ends of each axis ax.axis[direction].set_axisline_style("-|>") + + # adds X and Y-axis from the origin ax.axis[direction].set_visible(True) for direction in ["left", "right", "bottom", "top"]: + # hides borders ax.axis[direction].set_visible(False) x = np.linspace(-0.5, 1., 100) diff --git a/examples/event_handling/keypress_demo.py b/examples/event_handling/keypress_demo.py index e36eda6bfb72..aa0a4d249c47 100644 --- a/examples/event_handling/keypress_demo.py +++ b/examples/event_handling/keypress_demo.py @@ -1,4 +1,8 @@ """ +========= +Key Press +========= + Show how to connect to keypress events """ from __future__ import print_function diff --git a/examples/event_handling/pipong.py b/examples/event_handling/pipong.py index 89ab36ef9b36..180889a57021 100644 --- a/examples/event_handling/pipong.py +++ b/examples/event_handling/pipong.py @@ -1,7 +1,12 @@ -# A matplotlib based game of Pong illustrating one way to write interactive -# animation which are easily ported to multiple backends -# pipong.py was written by Paul Ivanov - +""" +==== +Pong +==== + +A Matplotlib based game of Pong illustrating one way to write interactive +animations which are easily ported to multiple backends. pipong.py was written +by `Paul Ivanov `_. +""" from __future__ import print_function import numpy as np diff --git a/examples/event_handling/poly_editor.py b/examples/event_handling/poly_editor.py index df95a95d11fe..045d85aa517d 100644 --- a/examples/event_handling/poly_editor.py +++ b/examples/event_handling/poly_editor.py @@ -1,7 +1,10 @@ """ -This is an example to show how to build cross-GUI applications using -matplotlib event handling to interact with objects on the canvas +=========== +Poly Editor +=========== +This is an example to show how to build cross-GUI applications using +matplotlib event handling to interact with objects on the canvas. """ import numpy as np from matplotlib.lines import Line2D diff --git a/examples/event_handling/resample.py b/examples/event_handling/resample.py index 1b380a06cb96..84ba3ee6539b 100644 --- a/examples/event_handling/resample.py +++ b/examples/event_handling/resample.py @@ -1,3 +1,13 @@ +""" +=============== +Resampling Data +=============== + +Downsampling lowers the sample rate or sample size of a signal. In this +tutorial, the signal is downsampled when the plot is adjusted through dragging +and zooming. +""" + import numpy as np import matplotlib.pyplot as plt diff --git a/examples/mplot3d/lines3d.py b/examples/mplot3d/lines3d.py index a1504de63e22..444eed2d4c8e 100644 --- a/examples/mplot3d/lines3d.py +++ b/examples/mplot3d/lines3d.py @@ -3,7 +3,7 @@ 3D parametric curve =================== -Demonstrating plotting a parametric curve in 3D. +This example demonstrates plotting a parametric curve in 3D. ''' import matplotlib as mpl diff --git a/examples/mplot3d/mixed_subplots.py b/examples/mplot3d/mixed_subplots.py index 00d691813485..16f1d5ccc29b 100644 --- a/examples/mplot3d/mixed_subplots.py +++ b/examples/mplot3d/mixed_subplots.py @@ -1,9 +1,9 @@ """ -================== -2D and 3D subplots -================== +============================================ +Demonstrate the mixing of 2D and 3D subplots +============================================ -Demonstrate the mixing of 2d and 3d subplots. +This example shows a how to plot a 2D and 3D plot on the same figure. """ from mpl_toolkits.mplot3d import Axes3D diff --git a/examples/mplot3d/offset.py b/examples/mplot3d/offset.py index a92757cd9d96..da846c8cc26a 100644 --- a/examples/mplot3d/offset.py +++ b/examples/mplot3d/offset.py @@ -1,7 +1,7 @@ ''' -=================== -Offset text display -=================== +========================= +Automatic Text Offsetting +========================= This example demonstrates mplot3d's offset text display. As one rotates the 3D figure, the offsets should remain oriented the diff --git a/examples/pylab_examples/bar_stacked.py b/examples/pylab_examples/bar_stacked.py index 67ef657a8eea..b1fb908b5604 100644 --- a/examples/pylab_examples/bar_stacked.py +++ b/examples/pylab_examples/bar_stacked.py @@ -1,3 +1,13 @@ +""" +================= +Stacked Bar Graph +================= + +This is an example of creating a stacked bar plot with error bars using +plt.bar. Note the parameters *yerr* used for error bars, and *bottom* +to stack the women's bars on top of the men's bars. +""" + # a stacked bar plot with errorbars import numpy as np import matplotlib.pyplot as plt diff --git a/examples/pylab_examples/dolphin.py b/examples/pylab_examples/dolphin.py index 3e876180589f..7f8472a44fa1 100644 --- a/examples/pylab_examples/dolphin.py +++ b/examples/pylab_examples/dolphin.py @@ -1,3 +1,12 @@ +""" +======== +Dolphins +======== + +This example shows how to draw, and manipulate shapes given vertices and nodes +using the `Patches`, `Path` and `Transforms` classes. +""" + import matplotlib.cm as cm import matplotlib.pyplot as plt from matplotlib.patches import Circle, PathPatch diff --git a/examples/pylab_examples/fill_between_demo.py b/examples/pylab_examples/fill_between_demo.py index b3653e456ce5..2b065ed42f60 100644 --- a/examples/pylab_examples/fill_between_demo.py +++ b/examples/pylab_examples/fill_between_demo.py @@ -1,3 +1,12 @@ +""" +============================== +Filling the area between lines +============================== + +This example shows how to use `fill_between` to color between lines based on +user-defined logic. +""" + import matplotlib.pyplot as plt import numpy as np diff --git a/examples/pylab_examples/geo_demo.py b/examples/pylab_examples/geo_demo.py index 9ef96b2b564c..07fcc4c43096 100644 --- a/examples/pylab_examples/geo_demo.py +++ b/examples/pylab_examples/geo_demo.py @@ -1,3 +1,15 @@ +""" +====================== +Geographic Projections +====================== + +This shows 4 possible projections using subplot. +Matplotlib also supports +`Basemaps Toolkit