<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<title>Textbox &mdash; Matplotlib 3.0.2 documentation</title>

<link rel="stylesheet" href="../../_static/mpl.css"

type="text/css" />

<link rel="stylesheet" href="../../_static/pygments.css"

type="text/css" />

<link rel="stylesheet" href="../../_static/graphviz.css" type="text/css" />

<link rel="stylesheet" href="../../_static/gallery.css" type="text/css" />

<script type="text/javascript" id="documentation_options" data-url_root="../../" src="../../_static/documentation_options.js"></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>

<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>

<link rel="search" type="application/opensearchdescription+xml"

title="Search within Matplotlib 3.0.2 documentation"

href="../../_static/opensearch.xml"/>

<link rel="shortcut icon" href="../../_static/favicon.ico"/>

<link rel="index" title="Index" href="../../genindex.html"

<link rel="search" title="Search" href="../../search.html"

<link rel="top" title="Matplotlib 3.0.2 documentation" href="../../index.html" />

<link rel="canonical" href="https://matplotlib.org/stable/gallery/widgets/textbox.html" />

<script data-domain="matplotlib.org" defer="defer" src="https://views.scientific-python.org/js/script.js"></script>

</head>

<body>

<div id="unreleased-message"> You are reading an old version of the documentation (v3.0.2). For the latest version see <a href="https://matplotlib.org/stable/gallery/widgets/textbox.html">https://matplotlib.org/stable/gallery/widgets/textbox.html</a></div>

<div style="background-color: white; text-align: left; padding: 10px 10px 15px 15px; position: relative;">

<a href="../../index.html">

<div style="float: left; position: absolute; width: 496px; bottom: 0; padding-bottom: 24px"><span style="float: right; color: #789; background: white">Version 3.0.2</span></div>

<img src="../../_static/logo2.png" height="125px" border="0" alt="matplotlib"/></a>

<div id="forkongithub"><a href="https://github.com/matplotlib/matplotlib">Fork me on GitHub</a></div>

<div class="related">

<h3>Navigation</h3>

<ul>

<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><a href="../../index.html">home</a>|&nbsp;</li>

<li><a href="../index.html">examples</a>|&nbsp;</li>

<li><a href="../../tutorials/index.html">tutorials</a>|&nbsp;</li>

<li><a href="../../api/api_overview.html">API</a>|&nbsp;</li>

<li><a href="../../contents.html">docs</a> &raquo;</li>

</ul>

</div>

<div class="sphinxsidebar">

<div class="sphinxsidebarwrapper">

<div id="searchbox" style="display: none" role="search">

<h3>Quick search</h3>

<div class="searchformwrapper">

<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>

</div>

<script type="text/javascript">$('#searchbox').show(0);</script><div class="relations">

<h3>Related Topics</h3>

<li><a href="../../contents.html">Documentation overview</a><ul>

</ul></li>

<div id="sidebar-pagesource" role="note" aria-label="source link"

style="margin-top: 1.5em; padding-top: 0.1em; border-top: 1px solid #86989b">

<a href="../../_sources/gallery/widgets/textbox.rst.txt"

style="color: #c0c0c0" rel="nofollow">Show Page Source</a>

</div>

</div>

</div>

<div class="document">

<div class="documentwrapper">

<div class="bodywrapper">

<div class="body">

<div class="sphx-glr-download-link-note admonition note">

<p class="first admonition-title">Note</p>

<p class="last">Click <a class="reference internal" href="#sphx-glr-download-gallery-widgets-textbox-py"><span class="std std-ref">here</span></a> to download the full example code</p>

<div class="sphx-glr-example-title section" id="textbox">

<span id="sphx-glr-gallery-widgets-textbox-py"></span><h1>Textbox<a class="headerlink" href="#textbox" title="Permalink to this headline">¶</a></h1>

<p>Allowing text input with the Textbox widget.</p>

<p>You can use the Textbox widget to let users provide any text that needs to be

displayed, including formulas. You can use a submit button to create plots

with the given input.</p>

<img alt="../../_images/sphx_glr_textbox_001.png" class="sphx-glr-single-img" src="../../_images/sphx_glr_textbox_001.png" />

<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">numpy</span> <span class="kn">as</span> <span class="nn">np</span>

<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="kn">as</span> <span class="nn">plt</span>

<span class="kn">from</span> <span class="nn">matplotlib.widgets</span> <span class="kn">import</span> <a href="../../api/widgets_api.html#matplotlib.widgets.TextBox" title="View documentation for matplotlib.widgets.TextBox"><span class="n">TextBox</span></a>

<span class="n">fig</span><span class="p">,</span> <span class="n">ax</span> <span class="o">=</span> <a href="../../api/_as_gen/matplotlib.pyplot.subplots.html#matplotlib.pyplot.subplots" title="View documentation for matplotlib.pyplot.subplots"><span class="n">plt</span><span class="o">.</span><span class="n">subplots</span></a><span class="p">()</span>

<a href="../../api/_as_gen/matplotlib.pyplot.subplots_adjust.html#matplotlib.pyplot.subplots_adjust" title="View documentation for matplotlib.pyplot.subplots_adjust"><span class="n">plt</span><span class="o">.</span><span class="n">subplots_adjust</span></a><span class="p">(</span><span class="n">bottom</span><span class="o">=</span><span class="mf">0.2</span><span class="p">)</span>

<span class="n">t</span> <span class="o">=</span> <a href="https://docs.scipy.org/doc/numpy/reference/generated/numpy.arange.html#numpy.arange" title="View documentation for numpy.arange"><span class="n">np</span><span class="o">.</span><span class="n">arange</span></a><span class="p">(</span><span class="o">-</span><span class="mf">2.0</span><span class="p">,</span> <span class="mf">2.0</span><span class="p">,</span> <span class="mf">0.001</span><span class="p">)</span>

<span class="n">s</span> <span class="o">=</span> <span class="n">t</span> <span class="o">**</span> <span class="mi">2</span>

<span class="n">initial_text</span> <span class="o">=</span> <span class="s2">&quot;t ** 2&quot;</span>

<span class="n">l</span><span class="p">,</span> <span class="o">=</span> <a href="../../api/_as_gen/matplotlib.pyplot.plot.html#matplotlib.pyplot.plot" title="View documentation for matplotlib.pyplot.plot"><span class="n">plt</span><span class="o">.</span><span class="n">plot</span></a><span class="p">(</span><span class="n">t</span><span class="p">,</span> <span class="n">s</span><span class="p">,</span> <span class="n">lw</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>

<span class="k">def</span> <span class="nf">submit</span><span class="p">(</span><span class="n">text</span><span class="p">):</span>

<span class="n">ydata</span> <span class="o">=</span> <span class="nb">eval</span><span class="p">(</span><span class="n">text</span><span class="p">)</span>

<span class="n">l</span><span class="o">.</span><span class="n">set_ydata</span><span class="p">(</span><span class="n">ydata</span><span class="p">)</span>

<span class="n">ax</span><span class="o">.</span><span class="n">set_ylim</span><span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">min</span><span class="p">(</span><span class="n">ydata</span><span class="p">),</span> <span class="n">np</span><span class="o">.</span><span class="n">max</span><span class="p">(</span><span class="n">ydata</span><span class="p">))</span>

<a href="../../api/_as_gen/matplotlib.pyplot.draw.html#matplotlib.pyplot.draw" title="View documentation for matplotlib.pyplot.draw"><span class="n">plt</span><span class="o">.</span><span class="n">draw</span></a><span class="p">()</span>

<span class="n">axbox</span> <span class="o">=</span> <a href="../../api/_as_gen/matplotlib.pyplot.axes.html#matplotlib.pyplot.axes" title="View documentation for matplotlib.pyplot.axes"><span class="n">plt</span><span class="o">.</span><span class="n">axes</span></a><span class="p">([</span><span class="mf">0.1</span><span class="p">,</span> <span class="mf">0.05</span><span class="p">,</span> <span class="mf">0.8</span><span class="p">,</span> <span class="mf">0.075</span><span class="p">])</span>

<span class="n">text_box</span> <span class="o">=</span> <a href="../../api/widgets_api.html#matplotlib.widgets.TextBox" title="View documentation for matplotlib.widgets.TextBox"><span class="n">TextBox</span></a><span class="p">(</span><span class="n">axbox</span><span class="p">,</span> <span class="s1">&#39;Evaluate&#39;</span><span class="p">,</span> <span class="n">initial</span><span class="o">=</span><span class="n">initial_text</span><span class="p">)</span>

<span class="n">text_box</span><span class="o">.</span><span class="n">on_submit</span><span class="p">(</span><span class="n">submit</span><span class="p">)</span>

<a href="../../api/_as_gen/matplotlib.pyplot.show.html#matplotlib.pyplot.show" title="View documentation for matplotlib.pyplot.show"><span class="n">plt</span><span class="o">.</span><span class="n">show</span></a><span class="p">()</span>

<div class="sphx-glr-footer class sphx-glr-footer-example docutils container" id="sphx-glr-download-gallery-widgets-textbox-py">

<div class="sphx-glr-download docutils container">

<a class="reference download internal" download="" href="../../_downloads/a753e330492c04b337c1c2a3362e25f2/textbox.py"><code class="xref download docutils literal notranslate"><span class="pre">Download</span> <span class="pre">Python</span> <span class="pre">source</span> <span class="pre">code:</span> <span class="pre">textbox.py</span></code></a></div>

<div class="sphx-glr-download docutils container">

<a class="reference download internal" download="" href="../../_downloads/165eca6dc5ec864c4f4175ac2c4ec0e2/textbox.ipynb"><code class="xref download docutils literal notranslate"><span class="pre">Download</span> <span class="pre">Jupyter</span> <span class="pre">notebook:</span> <span class="pre">textbox.ipynb</span></code></a></div>

<p class="sphx-glr-signature">Keywords: matplotlib code example, codex, python plot, pyplot

<a class="reference external" href="https://sphinx-gallery.readthedocs.io">Gallery generated by Sphinx-Gallery</a></p>

</div>

</div>

</div>

<div class="clearer"></div>

</div>

<div class="footer">

&copy; Copyright 2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the Matplotlib development team; 2012 - 2018 The Matplotlib development team.

<br />

Last updated on Nov 11, 2018.

Created using

<a href="http://sphinx-doc.org/">Sphinx</a> 1.8.1.

Doc version v3.0.2-2-g91e2d00a8.

</div>