import numpy as np
import matplotlib.pyplot as plt
from matplotlib.widgets import multicursor

t = np.arange(0.0, 2.0, 0.01)
s1 = np.sin(2*np.pi*t)
s2 = np.sin(4*np.pi*t)

fig, (ax1, ax2) = plt.subplots(2, sharex=true)
ax1.plot(t, s1)
ax2.plot(t, s2)

multi = multicursor(fig.canvas, (ax1, ax2), color='r', lw=1)
plt.show()

multi = multicursor(fig.canvas, (ax1, ax2), color='r', lw=1, horizon=true, verton=true)

class multicursor(widget):
  """
  provide a vertical (default) and/or horizontal line cursor shared between
  multiple axes.

  for the cursor to remain responsive you must keep a reference to it.

  example usage::

    from matplotlib.widgets import multicursor
    import matplotlib.pyplot as plt
    import numpy as np

    fig, (ax1, ax2) = plt.subplots(nrows=2, sharex=true)
    t = np.arange(0.0, 2.0, 0.01)
    ax1.plot(t, np.sin(2*np.pi*t))
    ax2.plot(t, np.sin(4*np.pi*t))

    multi = multicursor(fig.canvas, (ax1, ax2), color='r', lw=1,
              horizon=false, verton=true)
    plt.show()

  """
  def __init__(self, canvas, axes, useblit=true, horizon=false, verton=true,
         **lineprops):

    self.canvas = canvas
    self.axes = axes
    self.horizon = horizon
    self.verton = verton

    xmin, xmax = axes[-1].get_xlim()
    ymin, ymax = axes[-1].get_ylim()
    xmid = 0.5 * (xmin + xmax)
    ymid = 0.5 * (ymin + ymax)

    self.visible = true
    self.useblit = useblit and self.canvas.supports_blit
    self.background = none
    self.needclear = false

    if self.useblit:
      lineprops['animated'] = true

    if verton:
      self.vlines = [ax.axvline(xmid, visible=false, **lineprops)
              for ax in axes]
    else:
      self.vlines = []

    if horizon:
      self.hlines = [ax.axhline(ymid, visible=false, **lineprops)
              for ax in axes]
    else:
      self.hlines = []

    self.connect()
    
  def connect(self):
    """connect events."""
    self._cidmotion = self.canvas.mpl_connect('motion_notify_event',
                         self.onmove)
    self._ciddraw = self.canvas.mpl_connect('draw_event', self.clear)

  def disconnect(self):
    """disconnect events."""
    self.canvas.mpl_disconnect(self._cidmotion)
    self.canvas.mpl_disconnect(self._ciddraw)

  def clear(self, event):
    """clear the cursor."""
    if self.ignore(event):
      return
    if self.useblit:
      self.background = (
        self.canvas.copy_from_bbox(self.canvas.figure.bbox))
    for line in self.vlines + self.hlines:
      line.set_visible(false)

  def onmove(self, event):
    if self.ignore(event):
      return
    if event.inaxes is none:
      return
    if not self.canvas.widgetlock.available(self):
      return
    self.needclear = true
    if not self.visible:
      return
    if self.verton:
      for line in self.vlines:
        line.set_xdata((event.xdata, event.xdata))
        line.set_visible(self.visible)
    if self.horizon:
      for line in self.hlines:
        line.set_ydata((event.ydata, event.ydata))
        line.set_visible(self.visible)
    self._update()


  def _update(self):
    if self.useblit:
      if self.background is not none:
        self.canvas.restore_region(self.background)
      if self.verton:
        for ax, line in zip(self.axes, self.vlines):
          ax.draw_artist(line)
      if self.horizon:
        for ax, line in zip(self.axes, self.hlines):
          ax.draw_artist(line)
      self.canvas.blit()
    else:
      self.canvas.draw_idle()