iframe-proxy | Sunbelt Computer Software

975 lines (874 loc) · 68.6 KB
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>widgets &mdash; Matplotlib 1.4.1 documentation</title>
    <link rel="stylesheet" href="../_static/mpl.css"
type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css"
type="text/css" />
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
        VERSION:     '1.4.1',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
    </script>
    <script type="text/javascript" src="../_static/jquery.js"></script>
    <script type="text/javascript" src="../_static/underscore.js"></script>
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <link rel="search" type="application/opensearchdescription+xml"
          title="Search within Matplotlib 1.4.1 documentation"
          href="../_static/opensearch.xml"/>
    <link rel="top" title="Matplotlib 1.4.1 documentation" href="../index.html" />
    <link rel="up" title="The Matplotlib API" href="index.html" />
    <link rel="next" title="Matplotlib Examples" href="../examples/index.html" />
    <link rel="prev" title="units" href="units_api.html" /> 
<link href="https://fonts.googleapis.com/css?family=Raleway" rel="stylesheet" type="text/css">
    <link rel="canonical" href="https://matplotlib.org/stable/api/widgets_api.html" />
    <script data-domain="matplotlib.org" defer="defer" src="https://views.scientific-python.org/js/script.js"></script>
<div id="unreleased-message"> You are reading an old version of the documentation (v1.4.1).  For the latest version see <a href="https://matplotlib.org/stable/api/widgets_api.html">https://matplotlib.org/stable/api/widgets_api.html</a></div>
<link rel="shortcut icon" href="/_static/favicon.ico">
<!-- The "Fork me on github" ribbon -->
<img style="float: right; margin-bottom: -40px; top: 0; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_orange_ff7600.png" usemap="#ribbonmap"/>
<map name="ribbonmap">
    <area shape="poly" coords="15,0,148,-1,148,135" href="https://github.com/matplotlib/matplotlib" title="Fork me on GitHub" />
<div style="background-color: white; text-align: left; padding: 10px 10px 15px 15px">
<a href="../index.html"><img src="../_static/logo2.png" border="0" alt="matplotlib"/></a>
    <div class="related">
      <h3>Navigation</h3>
        <li class="right" style="margin-right: 10px">
          <a href="../genindex.html" title="General Index"
             accesskey="I">index</a></li>
        <li class="right" >
          <a href="../py-modindex.html" title="Python Module Index"
             >modules</a> |</li>
        <li class="right" >
          <a href="../examples/index.html" title="Matplotlib Examples"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="units_api.html" title="units"
             accesskey="P">previous</a> |</li>
        <li><a href="../index.html">home</a>|&nbsp;</li>
        <li><a href="../examples/index.html">examples</a>|&nbsp;</li>
        <li><a href="../gallery.html">gallery</a>|&nbsp;</li>
        <li><a href="pyplot_summary.html">pyplot</a>|&nbsp;</li>
        <li><a href="../contents.html">docs</a> &raquo;</li>
          <li><a href="index.html" accesskey="U">The Matplotlib API</a> &raquo;</li> 
      </ul>
      <div class="sphinxsidebar">
        <div class="sphinxsidebarwrapper">
  <h3><a href="../contents.html">Table Of Contents</a></h3>
<li><a class="reference internal" href="#">widgets</a><ul>
<li><a class="reference internal" href="#module-matplotlib.widgets"><code class="docutils literal"><span class="pre">matplotlib.widgets</span></code></a><ul>
<li><a class="reference internal" href="#gui-neutral-widgets">GUI Neutral widgets</a></li>
  <h4>Previous topic</h4>
  <p class="topless"><a href="units_api.html"
                        title="previous chapter">units</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="../examples/index.html"
                        title="next chapter">Matplotlib Examples</a></p>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="../_sources/api/widgets_api.txt"
            rel="nofollow">Show Source</a></li>
<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" />
      <input type="submit" value="Go" />
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
    <p class="searchtip" style="font-size: 90%">
    Enter search terms or a module, class or function name.
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
  <div class="section" id="widgets">
<h1>widgets<a class="headerlink" href="#widgets" title="Permalink to this headline">¶</a></h1>
<div class="section" id="module-matplotlib.widgets">
<span id="matplotlib-widgets"></span><h2><a class="reference internal" href="#module-matplotlib.widgets" title="matplotlib.widgets"><code class="xref py py-mod docutils literal"><span class="pre">matplotlib.widgets</span></code></a><a class="headerlink" href="#module-matplotlib.widgets" title="Permalink to this headline">¶</a></h2>
<div class="section" id="gui-neutral-widgets">
<h3>GUI Neutral widgets<a class="headerlink" href="#gui-neutral-widgets" title="Permalink to this headline">¶</a></h3>
<p>Widgets that are designed to work for any of the GUI backends.
All of these widgets require you to predefine an <a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.axes.Axes</span></code></a>
instance and pass that as the first arg.  matplotlib doesn&#8217;t try to
be too smart with respect to layout &#8211; you will have to figure out how
wide and tall you want your Axes to be to accommodate your widget.</p>
<dl class="class">
<dt id="matplotlib.widgets.AxesWidget">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">AxesWidget</code><span class="sig-paren">(</span><em>ax</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.AxesWidget" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.Widget" title="matplotlib.widgets.Widget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.Widget</span></code></a></p>
<p>Widget that is connected to a single
<a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">Axes</span></code></a>.</p>
<p>To guarantee that the widget remains responsive and not garbage-collected,
a reference to the object should be maintained by the user.</p>
<p>This is necessary because the callback registry
maintains only weak-refs to the functions, which are member
functions of the widget.  If there are no references to the widget
object it may be garbage collected which will disconnect the
callbacks.</p>
<p>Attributes:</p>
<dl class="docutils">
<dt><em>ax</em> <span class="classifier-delimiter">:</span> <span class="classifier"><a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">Axes</span></code></a></span></dt>
<dd>The parent axes for the widget</dd>
<dt><em>canvas</em> <span class="classifier-delimiter">:</span> <span class="classifier"><a class="reference internal" href="backend_bases_api.html#matplotlib.backend_bases.FigureCanvasBase" title="matplotlib.backend_bases.FigureCanvasBase"><code class="xref py py-class docutils literal"><span class="pre">FigureCanvasBase</span></code></a> subclass</span></dt>
<dd>The parent figure canvas for the widget.</dd>
<dt><em>active</em> <span class="classifier-delimiter">:</span> <span class="classifier">bool</span></dt>
<dd>If False, the widget does not respond to events.</dd>
<dl class="method">
<dt id="matplotlib.widgets.AxesWidget.connect_event">
<code class="descname">connect_event</code><span class="sig-paren">(</span><em>event</em>, <em>callback</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.AxesWidget.connect_event" title="Permalink to this definition">¶</a></dt>
<dd><p>Connect callback with an event.</p>
<p>This should be used in lieu of <code class="xref py py-obj docutils literal"><span class="pre">figure.canvas.mpl_connect</span></code> since this
function stores call back ids for later clean up.</p>
<dl class="method">
<dt id="matplotlib.widgets.AxesWidget.disconnect_events">
<code class="descname">disconnect_events</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.AxesWidget.disconnect_events" title="Permalink to this definition">¶</a></dt>
<dd><p>Disconnect all events created by this widget.</p>
<dl class="method">
<dt id="matplotlib.widgets.AxesWidget.ignore">
<code class="descname">ignore</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.AxesWidget.ignore" title="Permalink to this definition">¶</a></dt>
<dd><p>Return True if event should be ignored.</p>
<p>This method (or a version of it) should be called at the beginning
of any event callback.</p>
<dl class="class">
<dt id="matplotlib.widgets.Button">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">Button</code><span class="sig-paren">(</span><em>ax</em>, <em>label</em>, <em>image=None</em>, <em>color=u'0.85'</em>, <em>hovercolor=u'0.95'</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Button" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.AxesWidget" title="matplotlib.widgets.AxesWidget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.AxesWidget</span></code></a></p>
<p>A GUI neutral button.</p>
<p>For the button to remain responsive
you must keep a reference to it.</p>
<p>The following attributes are accessible</p>
<blockquote>
<div><dl class="docutils">
<dt><em>ax</em></dt>
<dd>The <a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.axes.Axes</span></code></a> the button renders into.</dd>
<dt><em>label</em></dt>
<dd>A <a class="reference internal" href="text_api.html#matplotlib.text.Text" title="matplotlib.text.Text"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.text.Text</span></code></a> instance.</dd>
<dt><em>color</em></dt>
<dd>The color of the button when not hovering.</dd>
<dt><em>hovercolor</em></dt>
<dd>The color of the button when hovering.</dd>
</div></blockquote>
<p>Call <a class="reference internal" href="#matplotlib.widgets.Button.on_clicked" title="matplotlib.widgets.Button.on_clicked"><code class="xref py py-meth docutils literal"><span class="pre">on_clicked()</span></code></a> to connect to the button</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><p class="first"><strong>ax</strong> : matplotlib.axes.Axes</p>
<blockquote>
<div><p>The <a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.axes.Axes</span></code></a> instance the button
will be placed into.</p>
</div></blockquote>
<p><strong>label</strong> : str</p>
<blockquote>
<div><p>The button text. Accepts string.</p>
</div></blockquote>
<p><strong>image</strong> : array, mpl image, PIL image</p>
<blockquote>
<div><p>The image to place in the button, if not <em>None</em>.
Can be any legal arg to imshow (numpy array,
matplotlib Image instance, or PIL image).</p>
</div></blockquote>
<p><strong>color</strong> : color</p>
<blockquote>
<div><p>The color of the button when not activated</p>
</div></blockquote>
<p><strong>hovercolor</strong> : color</p>
<blockquote class="last">
<div><p>The color of the button when the mouse is over it</p>
</div></blockquote>
<dl class="method">
<dt id="matplotlib.widgets.Button.disconnect">
<code class="descname">disconnect</code><span class="sig-paren">(</span><em>cid</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Button.disconnect" title="Permalink to this definition">¶</a></dt>
<dd><p>remove the observer with connection id <em>cid</em></p>
<dl class="method">
<dt id="matplotlib.widgets.Button.on_clicked">
<code class="descname">on_clicked</code><span class="sig-paren">(</span><em>func</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Button.on_clicked" title="Permalink to this definition">¶</a></dt>
<dd><p>When the button is clicked, call this <em>func</em> with event</p>
<p>A connection id is returned which can be used to disconnect</p>
<dl class="class">
<dt id="matplotlib.widgets.CheckButtons">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">CheckButtons</code><span class="sig-paren">(</span><em>ax</em>, <em>labels</em>, <em>actives</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.CheckButtons" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.AxesWidget" title="matplotlib.widgets.AxesWidget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.AxesWidget</span></code></a></p>
<p>A GUI neutral radio button.</p>
<p>For the check buttons to remain responsive you much keep a
reference to this object.</p>
<p>The following attributes are exposed</p>
<blockquote>
<div><dl class="docutils">
<dt><em>ax</em></dt>
<dd>The <a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.axes.Axes</span></code></a> instance the buttons are
located in</dd>
<dt><em>labels</em></dt>
<dd>List of <a class="reference internal" href="text_api.html#matplotlib.text.Text" title="matplotlib.text.Text"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.text.Text</span></code></a> instances</dd>
<dt><em>lines</em></dt>
<dd>List of (line1, line2) tuples for the x&#8217;s in the check boxes.
These lines exist for each box, but have <code class="docutils literal"><span class="pre">set_visible(False)</span></code>
when its box is not checked.</dd>
<dt><em>rectangles</em></dt>
<dd>List of <a class="reference internal" href="patches_api.html#matplotlib.patches.Rectangle" title="matplotlib.patches.Rectangle"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.patches.Rectangle</span></code></a> instances</dd>
</div></blockquote>
<p>Connect to the CheckButtons with the <a class="reference internal" href="#matplotlib.widgets.CheckButtons.on_clicked" title="matplotlib.widgets.CheckButtons.on_clicked"><code class="xref py py-meth docutils literal"><span class="pre">on_clicked()</span></code></a> method</p>
<p>Add check buttons to <a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.axes.Axes</span></code></a> instance <em>ax</em></p>
<dl class="docutils">
<dt><em>labels</em></dt>
<dd>A len(buttons) list of labels as strings</dd>
<dt><em>actives</em></dt>
<dd><dl class="first last docutils">
<dt>A len(buttons) list of booleans indicating whether</dt>
<dd>the button is active</dd>
<dl class="method">
<dt id="matplotlib.widgets.CheckButtons.disconnect">
<code class="descname">disconnect</code><span class="sig-paren">(</span><em>cid</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.CheckButtons.disconnect" title="Permalink to this definition">¶</a></dt>
<dd><p>remove the observer with connection id <em>cid</em></p>
<dl class="method">
<dt id="matplotlib.widgets.CheckButtons.on_clicked">
<code class="descname">on_clicked</code><span class="sig-paren">(</span><em>func</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.CheckButtons.on_clicked" title="Permalink to this definition">¶</a></dt>
<dd><p>When the button is clicked, call <em>func</em> with button label</p>
<p>A connection id is returned which can be used to disconnect</p>
<dl class="class">
<dt id="matplotlib.widgets.Cursor">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">Cursor</code><span class="sig-paren">(</span><em>ax</em>, <em>horizOn=True</em>, <em>vertOn=True</em>, <em>useblit=False</em>, <em>**lineprops</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Cursor" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.AxesWidget" title="matplotlib.widgets.AxesWidget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.AxesWidget</span></code></a></p>
<p>A horizontal and vertical line span the axes that and move with
the pointer.  You can turn off the hline or vline spectively with
the attributes</p>
<blockquote>
<div><dl class="docutils">
<dt><em>horizOn</em></dt>
<dd>Controls the visibility of the horizontal line</dd>
<dt><em>vertOn</em></dt>
<dd>Controls the visibility of the horizontal line</dd>
</div></blockquote>
<p>and the visibility of the cursor itself with the <em>visible</em> attribute.</p>
<p>For the cursor to remain responsive you much keep a reference to
<p>Add a cursor to <em>ax</em>.  If <code class="docutils literal"><span class="pre">useblit=True</span></code>, use the backend-
dependent blitting features for faster updates (GTKAgg
only for now).  <em>lineprops</em> is a dictionary of line properties.</p>
<p>(<a class="reference external" href="../mpl_examples/widgets/cursor.py">Source code</a>, <a class="reference external" href="../mpl_examples/widgets/cursor.png">png</a>, <a class="reference external" href="../mpl_examples/widgets/cursor.hires.png">hires.png</a>, <a class="reference external" href="../mpl_examples/widgets/cursor.pdf">pdf</a>)</p>
<div class="figure">
<img alt="../_images/cursor.png" src="../_images/cursor.png" />
<dl class="method">
<dt id="matplotlib.widgets.Cursor.clear">
<code class="descname">clear</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Cursor.clear" title="Permalink to this definition">¶</a></dt>
<dd><p>clear the cursor</p>
<dl class="method">
<dt id="matplotlib.widgets.Cursor.onmove">
<code class="descname">onmove</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Cursor.onmove" title="Permalink to this definition">¶</a></dt>
<dd><p>on mouse motion draw the cursor if visible</p>
<dl class="class">
<dt id="matplotlib.widgets.Lasso">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">Lasso</code><span class="sig-paren">(</span><em>ax</em>, <em>xy</em>, <em>callback=None</em>, <em>useblit=True</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Lasso" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.AxesWidget" title="matplotlib.widgets.AxesWidget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.AxesWidget</span></code></a></p>
<p>Selection curve of an arbitrary shape.</p>
<p>The selected path can be used in conjunction with
<a class="reference internal" href="path_api.html#matplotlib.path.Path.contains_point" title="matplotlib.path.Path.contains_point"><code class="xref py py-func docutils literal"><span class="pre">contains_point()</span></code></a> to select data points
from an image.</p>
<p>Unlike <a class="reference internal" href="#matplotlib.widgets.LassoSelector" title="matplotlib.widgets.LassoSelector"><code class="xref py py-class docutils literal"><span class="pre">LassoSelector</span></code></a>, this must be initialized with a starting
point <code class="xref py py-obj docutils literal"><span class="pre">xy</span></code>, and the <a class="reference internal" href="#matplotlib.widgets.Lasso" title="matplotlib.widgets.Lasso"><code class="xref py py-obj docutils literal"><span class="pre">Lasso</span></code></a> events are destroyed upon release.</p>
<p>Parameters:</p>
<dl class="docutils">
<dt><em>ax</em> <span class="classifier-delimiter">:</span> <span class="classifier"><a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">Axes</span></code></a></span></dt>
<dd>The parent axes for the widget.</dd>
<dt><em>xy</em> <span class="classifier-delimiter">:</span> <span class="classifier">array</span></dt>
<dd>Coordinates of the start of the lasso.</dd>
<dt><em>callback</em> <span class="classifier-delimiter">:</span> <span class="classifier">function</span></dt>
<dd>Whenever the lasso is released, the <code class="xref py py-obj docutils literal"><span class="pre">callback</span></code> function is called and
passed the vertices of the selected path.</dd>
<dl class="method">
<dt id="matplotlib.widgets.Lasso.onmove">
<code class="descname">onmove</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Lasso.onmove" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.Lasso.onrelease">
<code class="descname">onrelease</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Lasso.onrelease" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="class">
<dt id="matplotlib.widgets.LassoSelector">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">LassoSelector</code><span class="sig-paren">(</span><em>ax</em>, <em>onselect=None</em>, <em>useblit=True</em>, <em>lineprops=None</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.LassoSelector" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.AxesWidget" title="matplotlib.widgets.AxesWidget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.AxesWidget</span></code></a></p>
<p>Selection curve of an arbitrary shape.</p>
<p>For the selector to remain responsive you much keep a reference to
<p>The selected path can be used in conjunction with
<a class="reference internal" href="path_api.html#matplotlib.path.Path.contains_point" title="matplotlib.path.Path.contains_point"><code class="xref py py-func docutils literal"><span class="pre">contains_point()</span></code></a> to select
data points from an image.</p>
<p>In contrast to <a class="reference internal" href="#matplotlib.widgets.Lasso" title="matplotlib.widgets.Lasso"><code class="xref py py-class docutils literal"><span class="pre">Lasso</span></code></a>, <a class="reference internal" href="#matplotlib.widgets.LassoSelector" title="matplotlib.widgets.LassoSelector"><code class="xref py py-obj docutils literal"><span class="pre">LassoSelector</span></code></a> is written with an interface
similar to <a class="reference internal" href="#matplotlib.widgets.RectangleSelector" title="matplotlib.widgets.RectangleSelector"><code class="xref py py-class docutils literal"><span class="pre">RectangleSelector</span></code></a> and <a class="reference internal" href="#matplotlib.widgets.SpanSelector" title="matplotlib.widgets.SpanSelector"><code class="xref py py-class docutils literal"><span class="pre">SpanSelector</span></code></a> and will
continue to interact with the axes until disconnected.</p>
<p>Parameters:</p>
<dl class="docutils">
<dt><em>ax</em> <span class="classifier-delimiter">:</span> <span class="classifier"><a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">Axes</span></code></a></span></dt>
<dd>The parent axes for the widget.</dd>
<dt><em>onselect</em> <span class="classifier-delimiter">:</span> <span class="classifier">function</span></dt>
<dd>Whenever the lasso is released, the <code class="xref py py-obj docutils literal"><span class="pre">onselect</span></code> function is called and
passed the vertices of the selected path.</dd>
<p>Example usage:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">ax</span> <span class="o">=</span> <span class="n">subplot</span><span class="p">(</span><span class="mi">111</span><span class="p">)</span>
<span class="n">ax</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">x</span><span class="p">,</span><span class="n">y</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">onselect</span><span class="p">(</span><span class="n">verts</span><span class="p">):</span>
    <span class="k">print</span> <span class="n">verts</span>
<span class="n">lasso</span> <span class="o">=</span> <span class="n">LassoSelector</span><span class="p">(</span><span class="n">ax</span><span class="p">,</span> <span class="n">onselect</span><span class="p">)</span>
</pre></div>
<dl class="method">
<dt id="matplotlib.widgets.LassoSelector.ignore">
<code class="descname">ignore</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.LassoSelector.ignore" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.LassoSelector.onmove">
<code class="descname">onmove</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.LassoSelector.onmove" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.LassoSelector.onpress">
<code class="descname">onpress</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.LassoSelector.onpress" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.LassoSelector.onrelease">
<code class="descname">onrelease</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.LassoSelector.onrelease" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.LassoSelector.update_background">
<code class="descname">update_background</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.LassoSelector.update_background" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="class">
<dt id="matplotlib.widgets.LockDraw">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">LockDraw</code><a class="headerlink" href="#matplotlib.widgets.LockDraw" title="Permalink to this definition">¶</a></dt>
<dd><p>Some widgets, like the cursor, draw onto the canvas, and this is not
desirable under all circumstances, like when the toolbar is in
zoom-to-rect mode and drawing a rectangle.  The module level &#8220;lock&#8221;
allows someone to grab the lock and prevent other widgets from
drawing.  Use <code class="docutils literal"><span class="pre">matplotlib.widgets.lock(someobj)</span></code> to pr</p>
<dl class="method">
<dt id="matplotlib.widgets.LockDraw.available">
<code class="descname">available</code><span class="sig-paren">(</span><em>o</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.LockDraw.available" title="Permalink to this definition">¶</a></dt>
<dd><p>drawing is available to <em>o</em></p>
<dl class="method">
<dt id="matplotlib.widgets.LockDraw.isowner">
<code class="descname">isowner</code><span class="sig-paren">(</span><em>o</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.LockDraw.isowner" title="Permalink to this definition">¶</a></dt>
<dd><p>Return True if <em>o</em> owns this lock</p>
<dl class="method">
<dt id="matplotlib.widgets.LockDraw.locked">
<code class="descname">locked</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.LockDraw.locked" title="Permalink to this definition">¶</a></dt>
<dd><p>Return True if the lock is currently held by an owner</p>
<dl class="method">
<dt id="matplotlib.widgets.LockDraw.release">
<code class="descname">release</code><span class="sig-paren">(</span><em>o</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.LockDraw.release" title="Permalink to this definition">¶</a></dt>
<dd><p>release the lock</p>
<dl class="class">
<dt id="matplotlib.widgets.MultiCursor">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">MultiCursor</code><span class="sig-paren">(</span><em>canvas</em>, <em>axes</em>, <em>useblit=True</em>, <em>horizOn=False</em>, <em>vertOn=True</em>, <em>**lineprops</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.MultiCursor" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.Widget" title="matplotlib.widgets.Widget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.Widget</span></code></a></p>
<p>Provide a vertical (default) and/or horizontal line cursor shared between
multiple axes.</p>
<p>For the cursor to remain responsive you much keep a reference to
<p>Example usage:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="kn">from</span> <span class="nn">matplotlib.widgets</span> <span class="kn">import</span> <span class="n">MultiCursor</span>
<span class="kn">from</span> <span class="nn">pylab</span> <span class="kn">import</span> <span class="n">figure</span><span class="p">,</span> <span class="n">show</span><span class="p">,</span> <span class="n">np</span>
<span class="n">t</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">arange</span><span class="p">(</span><span class="mf">0.0</span><span class="p">,</span> <span class="mf">2.0</span><span class="p">,</span> <span class="mf">0.01</span><span class="p">)</span>
<span class="n">s1</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">sin</span><span class="p">(</span><span class="mi">2</span><span class="o">*</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="o">*</span><span class="n">t</span><span class="p">)</span>
<span class="n">s2</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">sin</span><span class="p">(</span><span class="mi">4</span><span class="o">*</span><span class="n">np</span><span class="o">.</span><span class="n">pi</span><span class="o">*</span><span class="n">t</span><span class="p">)</span>
<span class="n">fig</span> <span class="o">=</span> <span class="n">figure</span><span class="p">()</span>
<span class="n">ax1</span> <span class="o">=</span> <span class="n">fig</span><span class="o">.</span><span class="n">add_subplot</span><span class="p">(</span><span class="mi">211</span><span class="p">)</span>
<span class="n">ax1</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">t</span><span class="p">,</span> <span class="n">s1</span><span class="p">)</span>
<span class="n">ax2</span> <span class="o">=</span> <span class="n">fig</span><span class="o">.</span><span class="n">add_subplot</span><span class="p">(</span><span class="mi">212</span><span class="p">,</span> <span class="n">sharex</span><span class="o">=</span><span class="n">ax1</span><span class="p">)</span>
<span class="n">ax2</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">t</span><span class="p">,</span> <span class="n">s2</span><span class="p">)</span>
<span class="n">multi</span> <span class="o">=</span> <span class="n">MultiCursor</span><span class="p">(</span><span class="n">fig</span><span class="o">.</span><span class="n">canvas</span><span class="p">,</span> <span class="p">(</span><span class="n">ax1</span><span class="p">,</span> <span class="n">ax2</span><span class="p">),</span> <span class="n">color</span><span class="o">=</span><span class="s">&#39;r&#39;</span><span class="p">,</span> <span class="n">lw</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>
                    <span class="n">horizOn</span><span class="o">=</span><span class="bp">False</span><span class="p">,</span> <span class="n">vertOn</span><span class="o">=</span><span class="bp">True</span><span class="p">)</span>
<span class="n">show</span><span class="p">()</span>
</pre></div>
<dl class="method">
<dt id="matplotlib.widgets.MultiCursor.clear">
<code class="descname">clear</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.MultiCursor.clear" title="Permalink to this definition">¶</a></dt>
<dd><p>clear the cursor</p>
<dl class="method">
<dt id="matplotlib.widgets.MultiCursor.connect">
<code class="descname">connect</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.MultiCursor.connect" title="Permalink to this definition">¶</a></dt>
<dd><p>connect events</p>
<dl class="method">
<dt id="matplotlib.widgets.MultiCursor.disconnect">
<code class="descname">disconnect</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.MultiCursor.disconnect" title="Permalink to this definition">¶</a></dt>
<dd><p>disconnect events</p>
<dl class="method">
<dt id="matplotlib.widgets.MultiCursor.onmove">
<code class="descname">onmove</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.MultiCursor.onmove" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="class">
<dt id="matplotlib.widgets.RadioButtons">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">RadioButtons</code><span class="sig-paren">(</span><em>ax</em>, <em>labels</em>, <em>active=0</em>, <em>activecolor=u'blue'</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RadioButtons" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.AxesWidget" title="matplotlib.widgets.AxesWidget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.AxesWidget</span></code></a></p>
<p>A GUI neutral radio button</p>
<p>For the buttons to remain responsive
you much keep a reference to this object.</p>
<p>The following attributes are exposed</p>
<blockquote>
<div><dl class="docutils">
<dt><em>ax</em></dt>
<dd>The <a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.axes.Axes</span></code></a> instance the buttons are in</dd>
<dt><em>activecolor</em></dt>
<dd>The color of the button when clicked</dd>
<dt><em>labels</em></dt>
<dd>A list of <a class="reference internal" href="text_api.html#matplotlib.text.Text" title="matplotlib.text.Text"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.text.Text</span></code></a> instances</dd>
<dt><em>circles</em></dt>
<dd>A list of <a class="reference internal" href="patches_api.html#matplotlib.patches.Circle" title="matplotlib.patches.Circle"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.patches.Circle</span></code></a> instances</dd>
</div></blockquote>
<p>Connect to the RadioButtons with the <a class="reference internal" href="#matplotlib.widgets.RadioButtons.on_clicked" title="matplotlib.widgets.RadioButtons.on_clicked"><code class="xref py py-meth docutils literal"><span class="pre">on_clicked()</span></code></a> method</p>
<p>Add radio buttons to <a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.axes.Axes</span></code></a> instance <em>ax</em></p>
<dl class="docutils">
<dt><em>labels</em></dt>
<dd>A len(buttons) list of labels as strings</dd>
<dt><em>active</em></dt>
<dd>The index into labels for the button that is active</dd>
<dt><em>activecolor</em></dt>
<dd>The color of the button when clicked</dd>
<dl class="method">
<dt id="matplotlib.widgets.RadioButtons.disconnect">
<code class="descname">disconnect</code><span class="sig-paren">(</span><em>cid</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RadioButtons.disconnect" title="Permalink to this definition">¶</a></dt>
<dd><p>remove the observer with connection id <em>cid</em></p>
<dl class="method">
<dt id="matplotlib.widgets.RadioButtons.on_clicked">
<code class="descname">on_clicked</code><span class="sig-paren">(</span><em>func</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RadioButtons.on_clicked" title="Permalink to this definition">¶</a></dt>
<dd><p>When the button is clicked, call <em>func</em> with button label</p>
<p>A connection id is returned which can be used to disconnect</p>
<dl class="class">
<dt id="matplotlib.widgets.RectangleSelector">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">RectangleSelector</code><span class="sig-paren">(</span><em>ax</em>, <em>onselect</em>, <em>drawtype=u'box'</em>, <em>minspanx=None</em>, <em>minspany=None</em>, <em>useblit=False</em>, <em>lineprops=None</em>, <em>rectprops=None</em>, <em>spancoords=u'data'</em>, <em>button=None</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RectangleSelector" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.AxesWidget" title="matplotlib.widgets.AxesWidget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.AxesWidget</span></code></a></p>
<p>Select a rectangular region of an axes.</p>
<p>For the cursor to remain responsive you much keep a reference to
<p>Example usage:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="kn">from</span> <span class="nn">matplotlib.widgets</span> <span class="kn">import</span>  <span class="n">RectangleSelector</span>
<span class="kn">from</span> <span class="nn">pylab</span> <span class="kn">import</span> <span class="o">*</span>
<span class="k">def</span> <span class="nf">onselect</span><span class="p">(</span><span class="n">eclick</span><span class="p">,</span> <span class="n">erelease</span><span class="p">):</span>
  <span class="s">&#39;eclick and erelease are matplotlib events at press and release&#39;</span>
  <span class="k">print</span> <span class="s">&#39; startposition : (</span><span class="si">%f</span><span class="s">, </span><span class="si">%f</span><span class="s">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">eclick</span><span class="o">.</span><span class="n">xdata</span><span class="p">,</span> <span class="n">eclick</span><span class="o">.</span><span class="n">ydata</span><span class="p">)</span>
  <span class="k">print</span> <span class="s">&#39; endposition   : (</span><span class="si">%f</span><span class="s">, </span><span class="si">%f</span><span class="s">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="n">erelease</span><span class="o">.</span><span class="n">xdata</span><span class="p">,</span> <span class="n">erelease</span><span class="o">.</span><span class="n">ydata</span><span class="p">)</span>
  <span class="k">print</span> <span class="s">&#39; used button   : &#39;</span><span class="p">,</span> <span class="n">eclick</span><span class="o">.</span><span class="n">button</span>
<span class="k">def</span> <span class="nf">toggle_selector</span><span class="p">(</span><span class="n">event</span><span class="p">):</span>
    <span class="k">print</span> <span class="s">&#39; Key pressed.&#39;</span>
    <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">key</span> <span class="ow">in</span> <span class="p">[</span><span class="s">&#39;Q&#39;</span><span class="p">,</span> <span class="s">&#39;q&#39;</span><span class="p">]</span> <span class="ow">and</span> <span class="n">toggle_selector</span><span class="o">.</span><span class="n">RS</span><span class="o">.</span><span class="n">active</span><span class="p">:</span>
        <span class="k">print</span> <span class="s">&#39; RectangleSelector deactivated.&#39;</span>
        <span class="n">toggle_selector</span><span class="o">.</span><span class="n">RS</span><span class="o">.</span><span class="n">set_active</span><span class="p">(</span><span class="bp">False</span><span class="p">)</span>
    <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">key</span> <span class="ow">in</span> <span class="p">[</span><span class="s">&#39;A&#39;</span><span class="p">,</span> <span class="s">&#39;a&#39;</span><span class="p">]</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">toggle_selector</span><span class="o">.</span><span class="n">RS</span><span class="o">.</span><span class="n">active</span><span class="p">:</span>
        <span class="k">print</span> <span class="s">&#39; RectangleSelector activated.&#39;</span>
        <span class="n">toggle_selector</span><span class="o">.</span><span class="n">RS</span><span class="o">.</span><span class="n">set_active</span><span class="p">(</span><span class="bp">True</span><span class="p">)</span>
<span class="n">x</span> <span class="o">=</span> <span class="n">arange</span><span class="p">(</span><span class="mi">100</span><span class="p">)</span><span class="o">/</span><span class="p">(</span><span class="mf">99.0</span><span class="p">)</span>
<span class="n">y</span> <span class="o">=</span> <span class="n">sin</span><span class="p">(</span><span class="n">x</span><span class="p">)</span>
<span class="n">fig</span> <span class="o">=</span> <span class="n">figure</span>
<span class="n">ax</span> <span class="o">=</span> <span class="n">subplot</span><span class="p">(</span><span class="mi">111</span><span class="p">)</span>
<span class="n">ax</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">x</span><span class="p">,</span><span class="n">y</span><span class="p">)</span>
<span class="n">toggle_selector</span><span class="o">.</span><span class="n">RS</span> <span class="o">=</span> <span class="n">RectangleSelector</span><span class="p">(</span><span class="n">ax</span><span class="p">,</span> <span class="n">onselect</span><span class="p">,</span> <span class="n">drawtype</span><span class="o">=</span><span class="s">&#39;line&#39;</span><span class="p">)</span>
<span class="n">connect</span><span class="p">(</span><span class="s">&#39;key_press_event&#39;</span><span class="p">,</span> <span class="n">toggle_selector</span><span class="p">)</span>
<span class="n">show</span><span class="p">()</span>
</pre></div>
<p>Create a selector in <em>ax</em>.  When a selection is made, clear
the span and call onselect with:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">onselect</span><span class="p">(</span><span class="n">pos_1</span><span class="p">,</span> <span class="n">pos_2</span><span class="p">)</span>
</pre></div>
<p>and clear the drawn box/line. The <code class="docutils literal"><span class="pre">pos_1</span></code> and <code class="docutils literal"><span class="pre">pos_2</span></code> are
arrays of length 2 containing the x- and y-coordinate.</p>
<p>If <em>minspanx</em> is not <em>None</em> then events smaller than <em>minspanx</em>
in x direction are ignored (it&#8217;s the same for y).</p>
<p>The rectangle is drawn with <em>rectprops</em>; default:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">rectprops</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">facecolor</span><span class="o">=</span><span class="s">&#39;red&#39;</span><span class="p">,</span> <span class="n">edgecolor</span> <span class="o">=</span> <span class="s">&#39;black&#39;</span><span class="p">,</span>
                 <span class="n">alpha</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span> <span class="n">fill</span><span class="o">=</span><span class="bp">False</span><span class="p">)</span>
</pre></div>
<p>The line is drawn with <em>lineprops</em>; default:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">lineprops</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">color</span><span class="o">=</span><span class="s">&#39;black&#39;</span><span class="p">,</span> <span class="n">linestyle</span><span class="o">=</span><span class="s">&#39;-&#39;</span><span class="p">,</span>
                 <span class="n">linewidth</span> <span class="o">=</span> <span class="mi">2</span><span class="p">,</span> <span class="n">alpha</span><span class="o">=</span><span class="mf">0.5</span><span class="p">)</span>
</pre></div>
<p>Use <em>drawtype</em> if you want the mouse to draw a line,
a box or nothing between click and actual position by setting</p>
<p><code class="docutils literal"><span class="pre">drawtype</span> <span class="pre">=</span> <span class="pre">'line'</span></code>, <code class="docutils literal"><span class="pre">drawtype='box'</span></code> or <code class="docutils literal"><span class="pre">drawtype</span> <span class="pre">=</span> <span class="pre">'none'</span></code>.</p>
<p><em>spancoords</em> is one of &#8216;data&#8217; or &#8216;pixels&#8217;.  If &#8216;data&#8217;, <em>minspanx</em>
and <em>minspanx</em> will be interpreted in the same coordinates as
the x and y axis. If &#8216;pixels&#8217;, they are in pixels.</p>
<p><em>button</em> is a list of integers indicating which mouse buttons should
be used for rectangle selection.  You can also specify a single
integer if only a single button is desired.  Default is <em>None</em>,
which does not limit which button can be used.</p>
<dl class="docutils">
<dt>Note, typically:</dt>
<dd>1 = left mouse button
2 = center mouse button (scroll wheel)
3 = right mouse button</dd>
<dl class="method">
<dt id="matplotlib.widgets.RectangleSelector.get_active">
<code class="descname">get_active</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RectangleSelector.get_active" title="Permalink to this definition">¶</a></dt>
<dd><p>Get status of active mode (boolean variable)</p>
<dl class="method">
<dt id="matplotlib.widgets.RectangleSelector.ignore">
<code class="descname">ignore</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RectangleSelector.ignore" title="Permalink to this definition">¶</a></dt>
<dd><p>return <em>True</em> if <em>event</em> should be ignored</p>
<dl class="method">
<dt id="matplotlib.widgets.RectangleSelector.onmove">
<code class="descname">onmove</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RectangleSelector.onmove" title="Permalink to this definition">¶</a></dt>
<dd><p>on motion notify event if box/line is wanted</p>
<dl class="method">
<dt id="matplotlib.widgets.RectangleSelector.press">
<code class="descname">press</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RectangleSelector.press" title="Permalink to this definition">¶</a></dt>
<dd><p>on button press event</p>
<dl class="method">
<dt id="matplotlib.widgets.RectangleSelector.release">
<code class="descname">release</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RectangleSelector.release" title="Permalink to this definition">¶</a></dt>
<dd><p>on button release event</p>
<dl class="method">
<dt id="matplotlib.widgets.RectangleSelector.set_active">
<code class="descname">set_active</code><span class="sig-paren">(</span><em>active</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RectangleSelector.set_active" title="Permalink to this definition">¶</a></dt>
<dd><p>Use this to activate / deactivate the RectangleSelector
from your program with an boolean parameter <em>active</em>.</p>
<dl class="method">
<dt id="matplotlib.widgets.RectangleSelector.update">
<code class="descname">update</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RectangleSelector.update" title="Permalink to this definition">¶</a></dt>
<dd><p>draw using newfangled blit or oldfangled draw depending on
useblit</p>
<dl class="method">
<dt id="matplotlib.widgets.RectangleSelector.update_background">
<code class="descname">update_background</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.RectangleSelector.update_background" title="Permalink to this definition">¶</a></dt>
<dd><p>force an update of the background</p>
<dl class="class">
<dt id="matplotlib.widgets.Slider">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">Slider</code><span class="sig-paren">(</span><em>ax</em>, <em>label</em>, <em>valmin</em>, <em>valmax</em>, <em>valinit=0.5</em>, <em>valfmt=u'%1.2f'</em>, <em>closedmin=True</em>, <em>closedmax=True</em>, <em>slidermin=None</em>, <em>slidermax=None</em>, <em>dragging=True</em>, <em>**kwargs</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Slider" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.AxesWidget" title="matplotlib.widgets.AxesWidget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.AxesWidget</span></code></a></p>
<p>A slider representing a floating point range.</p>
<p>For the slider
to remain responsive you must maintain a reference to it.</p>
<dl class="docutils">
<dt>The following attributes are defined</dt>
<dd><p class="first"><em>ax</em>        : the slider <a class="reference internal" href="axes_api.html#matplotlib.axes.Axes" title="matplotlib.axes.Axes"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.axes.Axes</span></code></a> instance</p>
<p><em>val</em>       : the current slider value</p>
<dl class="docutils">
<dt><em>vline</em> <span class="classifier-delimiter">:</span> <span class="classifier">a <a class="reference internal" href="lines_api.html#matplotlib.lines.Line2D" title="matplotlib.lines.Line2D"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.lines.Line2D</span></code></a> instance</span></dt>
<dd>representing the initial value of the slider</dd>
<dt><em>poly</em> <span class="classifier-delimiter">:</span> <span class="classifier">A <a class="reference internal" href="patches_api.html#matplotlib.patches.Polygon" title="matplotlib.patches.Polygon"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.patches.Polygon</span></code></a> instance</span></dt>
<dd>which is the slider knob</dd>
<p><em>valfmt</em>    : the format string for formatting the slider text</p>
<dl class="docutils">
<dt><em>label</em> <span class="classifier-delimiter">:</span> <span class="classifier">a <a class="reference internal" href="text_api.html#matplotlib.text.Text" title="matplotlib.text.Text"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.text.Text</span></code></a> instance</span></dt>
<dd>for the slider label</dd>
<p><em>closedmin</em> : whether the slider is closed on the minimum</p>
<p><em>closedmax</em> : whether the slider is closed on the maximum</p>
<dl class="docutils">
<dt><em>slidermin</em> <span class="classifier-delimiter">:</span> <span class="classifier">another slider - if not <em>None</em>, this slider must be</span></dt>
<dd>greater than <em>slidermin</em></dd>
<dt><em>slidermax</em> <span class="classifier-delimiter">:</span> <span class="classifier">another slider - if not <em>None</em>, this slider must be</span></dt>
<dd>less than <em>slidermax</em></dd>
<p class="last"><em>dragging</em>  : allow for mouse dragging on slider</p>
<p>Call <a class="reference internal" href="#matplotlib.widgets.Slider.on_changed" title="matplotlib.widgets.Slider.on_changed"><code class="xref py py-meth docutils literal"><span class="pre">on_changed()</span></code></a> to connect to the slider event</p>
<p>Create a slider from <em>valmin</em> to <em>valmax</em> in axes <em>ax</em>.</p>
<p>additional kwargs are passed on to <code class="docutils literal"><span class="pre">self.poly</span></code> which is the
<a class="reference internal" href="patches_api.html#matplotlib.patches.Rectangle" title="matplotlib.patches.Rectangle"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.patches.Rectangle</span></code></a> which draws the slider
knob.  See the <a class="reference internal" href="patches_api.html#matplotlib.patches.Rectangle" title="matplotlib.patches.Rectangle"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.patches.Rectangle</span></code></a> documentation
valid property names (e.g., <em>facecolor</em>, <em>edgecolor</em>, <em>alpha</em>, ...)</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><p class="first"><strong>ax</strong> : Axes</p>
<blockquote>
<div><p>The Axes to put the slider in</p>
</div></blockquote>
<p><strong>label</strong> : str</p>
<blockquote>
<div><p>Slider label</p>
</div></blockquote>
<p><strong>valmin</strong> : float</p>
<blockquote>
<div><p>The minimum value of the slider</p>
</div></blockquote>
<p><strong>valmax</strong> : float</p>
<blockquote>
<div><p>The maximum value of the slider</p>
</div></blockquote>
<p><strong>valinit</strong> : float</p>
<blockquote>
<div><p>The slider initial position</p>
</div></blockquote>
<p><strong>label</strong> : str</p>
<blockquote>
<div><p>The slider label</p>
</div></blockquote>
<p><strong>valfmt</strong> : str</p>
<blockquote>
<div><p>Used to format the slider value, fprint format string</p>
</div></blockquote>
<p><strong>closedmin</strong> : bool</p>
<blockquote>
<div><p>Indicate whether the slider interval is closed on the bottom</p>
</div></blockquote>
<p><strong>closedmax</strong> : bool</p>
<blockquote>
<div><p>Indicate whether the slider interval is closed on the top</p>
</div></blockquote>
<p><strong>slidermin</strong> : Slider or None</p>
<blockquote>
<div><p>Do not allow the current slider to have a value less than
<code class="xref py py-obj docutils literal"><span class="pre">slidermin</span></code></p>
</div></blockquote>
<p><strong>slidermax</strong> : Slider or None</p>
<blockquote>
<div><p>Do not allow the current slider to have a value greater than
<code class="xref py py-obj docutils literal"><span class="pre">slidermax</span></code></p>
</div></blockquote>
<p><strong>dragging</strong> : bool</p>
<blockquote class="last">
<div><p>if the slider can be dragged by the mouse</p>
</div></blockquote>
<dl class="method">
<dt id="matplotlib.widgets.Slider.disconnect">
<code class="descname">disconnect</code><span class="sig-paren">(</span><em>cid</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Slider.disconnect" title="Permalink to this definition">¶</a></dt>
<dd><p>remove the observer with connection id <em>cid</em></p>
<dl class="method">
<dt id="matplotlib.widgets.Slider.on_changed">
<code class="descname">on_changed</code><span class="sig-paren">(</span><em>func</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Slider.on_changed" title="Permalink to this definition">¶</a></dt>
<dd><p>When the slider value is changed, call <em>func</em> with the new
slider position</p>
<p>A connection id is returned which can be used to disconnect</p>
<dl class="method">
<dt id="matplotlib.widgets.Slider.reset">
<code class="descname">reset</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Slider.reset" title="Permalink to this definition">¶</a></dt>
<dd><p>reset the slider to the initial value if needed</p>
<dl class="method">
<dt id="matplotlib.widgets.Slider.set_val">
<code class="descname">set_val</code><span class="sig-paren">(</span><em>val</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.Slider.set_val" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="class">
<dt id="matplotlib.widgets.SpanSelector">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">SpanSelector</code><span class="sig-paren">(</span><em>ax</em>, <em>onselect</em>, <em>direction</em>, <em>minspan=None</em>, <em>useblit=False</em>, <em>rectprops=None</em>, <em>onmove_callback=None</em>, <em>span_stays=False</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SpanSelector" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.AxesWidget" title="matplotlib.widgets.AxesWidget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.AxesWidget</span></code></a></p>
<p>Select a min/max range of the x or y axes for a matplotlib Axes.</p>
<p>For the selector to remain responsive you much keep a reference to
<p>Example usage:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">ax</span> <span class="o">=</span> <span class="n">subplot</span><span class="p">(</span><span class="mi">111</span><span class="p">)</span>
<span class="n">ax</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">x</span><span class="p">,</span><span class="n">y</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">onselect</span><span class="p">(</span><span class="n">vmin</span><span class="p">,</span> <span class="n">vmax</span><span class="p">):</span>
    <span class="k">print</span> <span class="n">vmin</span><span class="p">,</span> <span class="n">vmax</span>
<span class="n">span</span> <span class="o">=</span> <span class="n">SpanSelector</span><span class="p">(</span><span class="n">ax</span><span class="p">,</span> <span class="n">onselect</span><span class="p">,</span> <span class="s">&#39;horizontal&#39;</span><span class="p">)</span>
</pre></div>
<dl class="docutils">
<dt><em>onmove_callback</em> is an optional callback that is called on mouse</dt>
<dd>move within the span range</dd>
<p>Create a span selector in <em>ax</em>.  When a selection is made, clear
the span and call <em>onselect</em> with:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">onselect</span><span class="p">(</span><span class="n">vmin</span><span class="p">,</span> <span class="n">vmax</span><span class="p">)</span>
</pre></div>
<p>and clear the span.</p>
<p><em>direction</em> must be &#8216;horizontal&#8217; or &#8216;vertical&#8217;</p>
<p>If <em>minspan</em> is not <em>None</em>, ignore events smaller than <em>minspan</em></p>
<dl class="docutils">
<dt>The span rectangle is drawn with <em>rectprops</em>; default::</dt>
<dd>rectprops = dict(facecolor=&#8217;red&#8217;, alpha=0.5)</dd>
<p>Set the visible attribute to <em>False</em> if you want to turn off
the functionality of the span selector</p>
<p>If <em>span_stays</em> is True, the span stays visble after making
a valid selection.</p>
<dl class="method">
<dt id="matplotlib.widgets.SpanSelector.ignore">
<code class="descname">ignore</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SpanSelector.ignore" title="Permalink to this definition">¶</a></dt>
<dd><p>return <em>True</em> if <em>event</em> should be ignored</p>
<dl class="method">
<dt id="matplotlib.widgets.SpanSelector.new_axes">
<code class="descname">new_axes</code><span class="sig-paren">(</span><em>ax</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SpanSelector.new_axes" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.SpanSelector.onmove">
<code class="descname">onmove</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SpanSelector.onmove" title="Permalink to this definition">¶</a></dt>
<dd><p>on motion notify event</p>
<dl class="method">
<dt id="matplotlib.widgets.SpanSelector.press">
<code class="descname">press</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SpanSelector.press" title="Permalink to this definition">¶</a></dt>
<dd><p>on button press event</p>
<dl class="method">
<dt id="matplotlib.widgets.SpanSelector.release">
<code class="descname">release</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SpanSelector.release" title="Permalink to this definition">¶</a></dt>
<dd><p>on button release event</p>
<dl class="method">
<dt id="matplotlib.widgets.SpanSelector.update">
<code class="descname">update</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SpanSelector.update" title="Permalink to this definition">¶</a></dt>
<dd><p>Draw using newfangled blit or oldfangled draw depending
on <em>useblit</em></p>
<dl class="method">
<dt id="matplotlib.widgets.SpanSelector.update_background">
<code class="descname">update_background</code><span class="sig-paren">(</span><em>event</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SpanSelector.update_background" title="Permalink to this definition">¶</a></dt>
<dd><p>force an update of the background</p>
<dl class="class">
<dt id="matplotlib.widgets.SubplotTool">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">SubplotTool</code><span class="sig-paren">(</span><em>targetfig</em>, <em>toolfig</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SubplotTool" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <a class="reference internal" href="#matplotlib.widgets.Widget" title="matplotlib.widgets.Widget"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.widgets.Widget</span></code></a></p>
<p>A tool to adjust to subplot params of a <a class="reference internal" href="figure_api.html#matplotlib.figure.Figure" title="matplotlib.figure.Figure"><code class="xref py py-class docutils literal"><span class="pre">matplotlib.figure.Figure</span></code></a></p>
<dl class="docutils">
<dt><em>targetfig</em></dt>
<dd>The figure instance to adjust</dd>
<dt><em>toolfig</em></dt>
<dd>The figure instance to embed the subplot tool into. If
None, a default figure will be created. If you are using
this from the GUI</dd>
<dl class="method">
<dt id="matplotlib.widgets.SubplotTool.funcbottom">
<code class="descname">funcbottom</code><span class="sig-paren">(</span><em>val</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SubplotTool.funcbottom" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.SubplotTool.funchspace">
<code class="descname">funchspace</code><span class="sig-paren">(</span><em>val</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SubplotTool.funchspace" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.SubplotTool.funcleft">
<code class="descname">funcleft</code><span class="sig-paren">(</span><em>val</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SubplotTool.funcleft" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.SubplotTool.funcright">
<code class="descname">funcright</code><span class="sig-paren">(</span><em>val</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SubplotTool.funcright" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.SubplotTool.functop">
<code class="descname">functop</code><span class="sig-paren">(</span><em>val</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SubplotTool.functop" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="method">
<dt id="matplotlib.widgets.SubplotTool.funcwspace">
<code class="descname">funcwspace</code><span class="sig-paren">(</span><em>val</em><span class="sig-paren">)</span><a class="headerlink" href="#matplotlib.widgets.SubplotTool.funcwspace" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="class">
<dt id="matplotlib.widgets.Widget">
<em class="property">class </em><code class="descclassname">matplotlib.widgets.</code><code class="descname">Widget</code><a class="headerlink" href="#matplotlib.widgets.Widget" title="Permalink to this definition">¶</a></dt>
<dd><p>Bases: <code class="xref py py-class docutils literal"><span class="pre">object</span></code></p>
<p>Abstract base class for GUI neutral widgets</p>
<dl class="attribute">
<dt id="matplotlib.widgets.Widget.drawon">
<code class="descname">drawon</code><em class="property"> = True</em><a class="headerlink" href="#matplotlib.widgets.Widget.drawon" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dl class="attribute">
<dt id="matplotlib.widgets.Widget.eventson">
<code class="descname">eventson</code><em class="property"> = True</em><a class="headerlink" href="#matplotlib.widgets.Widget.eventson" title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
          </div>
        </div>
      </div>
      <div class="clearer"></div>
    <div class="footer">
        &copy; Copyright 2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the matplotlib development team; 2012 - 2014 The matplotlib development team.
      Last updated on Oct 18, 2014.
      Created using <a
href="http://sphinx-doc.org/">Sphinx</a> 1.3b2.
Sunbelt Computer Software

PL/B Language Development and Support

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

widgets_api.html

Latest commit

History

widgets_api.html

File metadata and controls
