LivePlot.html 41 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646
  1. <!DOCTYPE html>
  2. <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
  3. <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
  4. <head>
  5. <meta charset="utf-8">
  6. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  7. <title>Live Plotting of Data During the Simulation &mdash; CBD Simulation Development Kit documentation</title>
  8. <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
  9. <!-- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> -->
  10. <link rel="stylesheet" href="../_static/style.css" type="text/css" />
  11. <link rel="index" title="Index" href="../genindex.html" />
  12. <link rel="search" title="Search" href="../search.html" />
  13. <link rel="next" title="CBD package" href="../CBD.html" />
  14. <link rel="prev" title="Realtime Simulation" href="RealTime.html" />
  15. <script async src="https://www.googletagmanager.com/gtag/js?id=UA-167094275-1"></script>
  16. <script src="../_static/js/googleanalytics.min.js"></script>
  17. <script src="../_static/js/modernizr.min.js"></script>
  18. <!-- Preload the theme fonts -->
  19. <link rel="preload" href="../_static/fonts/FreightSans/freight-sans-book.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  20. <link rel="preload" href="../_static/fonts/FreightSans/freight-sans-medium.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  21. <link rel="preload" href="../_static/fonts/IBMPlexMono/IBMPlexMono-Medium.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  22. <link rel="preload" href="../_static/fonts/FreightSans/freight-sans-bold.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  23. <link rel="preload" href="../_static/fonts/FreightSans/freight-sans-medium-italic.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  24. <link rel="preload" href="../_static/fonts/IBMPlexMono/IBMPlexMono-SemiBold.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  25. <!-- Preload the katex fonts -->
  26. <link rel="preload" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/fonts/KaTeX_Math-Italic.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  27. <link rel="preload" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/fonts/KaTeX_Main-Regular.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  28. <link rel="preload" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/fonts/KaTeX_Main-Bold.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  29. <link rel="preload" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/fonts/KaTeX_Size1-Regular.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  30. <link rel="preload" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/fonts/KaTeX_Size4-Regular.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  31. <link rel="preload" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/fonts/KaTeX_Size2-Regular.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  32. <link rel="preload" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/fonts/KaTeX_Size3-Regular.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  33. <link rel="preload" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/fonts/KaTeX_Caligraphic-Regular.woff2" as="font" type="font/woff2" crossorigin="anonymous">
  34. </head>
  35. <div class="container-fluid header-holder tutorials-header" id="header-holder">
  36. <div class="container">
  37. <div class="header-container">
  38. <a class="header-logo" href="https://catalyst-team.com/" aria-label="Catalyst"></a>
  39. <div class="main-menu">
  40. <ul>
  41. <li>
  42. <div class="ecosystem-dropdown">
  43. <a id="dropdownMenuButtonEcosystem" data-toggle="ecosystem-dropdown">
  44. Ecosystem
  45. </a>
  46. <div class="ecosystem-dropdown-menu">
  47. <a class="nav-dropdown-item" href="https://alchemy.host">
  48. <span class=dropdown-title>Alchemy</span>
  49. <p>Experiments logging & visualization</p>
  50. </a>
  51. <a class="nav-dropdown-item" href="https://github.com/catalyst-team/catalyst">
  52. <span class=dropdown-title>Catalyst</span>
  53. <p>Accelerated deep learning R&D</p>
  54. </a>
  55. <a class="nav-dropdown-item" href="https://github.com/catalyst-team/reaction">
  56. <span class=dropdown-title>Reaction</span>
  57. <p>Convenient deep learning models serving</p>
  58. </a>
  59. </div>
  60. </div>
  61. </li>
  62. <li>
  63. <div class="projects-dropdown">
  64. <a id="dropdownMenuButtonProjects" data-toggle="projects-dropdown">
  65. Projects
  66. </a>
  67. <div class="projects-dropdown-menu">
  68. <a class="nav-dropdown-item" href="https://github.com/catalyst-team/codestyle">
  69. <span class=dropdown-title>Codestyle</span>
  70. <p>Joint R&D codestyle</p>
  71. </a>
  72. <a class="nav-dropdown-item" href="https://github.com/catalyst-team/neuro">
  73. <span class=dropdown-title>Catalyst.Neuro</span>
  74. <p>Catalyst.Team and TReNDS collaborative project</p>
  75. </a>
  76. <a class="nav-dropdown-item" href="https://github.com/catalyst-team/classification">
  77. <span class=dropdown-title>Classification</span>
  78. <p>Image classification pipeline with transfer learning</p>
  79. </a>
  80. <a class="nav-dropdown-item" href="https://github.com/catalyst-team/detection">
  81. <span class=dropdown-title>Detection</span>
  82. <p>Object detection pipeline</p>
  83. </a>
  84. <a class="nav-dropdown-item" href="https://github.com/catalyst-team/segmentation">
  85. <span class=dropdown-title>Segmentation</span>
  86. <p>Image semantic segmentation pipeline</p>
  87. </a>
  88. <a class="nav-dropdown-item" href="https://github.com/catalyst-team/gan">
  89. <span class=dropdown-title>Catalyst.GAN</span>
  90. <p>GAN pipelines</p>
  91. </a>
  92. </div>
  93. </div>
  94. </li>
  95. <li>
  96. <a href="https://github.com/catalyst-team/dl-course">Deep learning course</a>
  97. </li>
  98. </ul>
  99. </div>
  100. <a class="main-menu-open-button" href="#" data-behavior="open-mobile-menu"></a>
  101. </div>
  102. </div>
  103. </div>
  104. <body class="catalyst-body">
  105. <div class="table-of-contents-link-wrapper">
  106. <span>Table of Contents</span>
  107. <a href="#" class="toggle-table-of-contents" data-behavior="toggle-table-of-contents"></a>
  108. </div>
  109. <nav data-toggle="wy-nav-shift" class="catalyst-left-menu" id="catalyst-left-menu">
  110. <div class="catalyst-side-scroll">
  111. <div class="catalyst-menu catalyst-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
  112. <div class="catalyst-left-menu-search">
  113. <div role="search">
  114. <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
  115. <input type="text" name="q" placeholder="Search Docs" />
  116. <input type="hidden" name="check_keywords" value="yes" />
  117. <input type="hidden" name="area" value="default" />
  118. </form>
  119. </div>
  120. </div>
  121. <p class="caption"><span class="caption-text">Setup</span></p>
  122. <ul>
  123. <li class="toctree-l1"><a class="reference internal" href="../install.html">How to install the CBD framework?</a></li>
  124. <li class="toctree-l1"><a class="reference internal" href="../running.html">How to run a CBD simulation?</a></li>
  125. <li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
  126. </ul>
  127. <p class="caption"><span class="caption-text">Simple Examples</span></p>
  128. <ul>
  129. <li class="toctree-l1"><a class="reference internal" href="SinGen.html">Sine Generator</a></li>
  130. <li class="toctree-l1"><a class="reference internal" href="EvenNumberGen.html">Hierarchical Even Number Generator</a></li>
  131. <li class="toctree-l1"><a class="reference internal" href="Fibonacci.html">Fibonacci Sequence Generator</a></li>
  132. <li class="toctree-l1"><a class="reference internal" href="LCG.html">Linear Congruential Generator</a></li>
  133. </ul>
  134. <p class="caption"><span class="caption-text">Advanced Examples</span></p>
  135. <ul class="current">
  136. <li class="toctree-l1"><a class="reference internal" href="RealTime.html">Realtime Simulation</a></li>
  137. <li class="toctree-l1 current"><a class="current reference internal" href="#">Live Plotting of Data During the Simulation</a></li>
  138. </ul>
  139. <p class="caption"><span class="caption-text">Internal Documentation</span></p>
  140. <ul>
  141. <li class="toctree-l1"><a class="reference internal" href="../CBD.html">CBD package</a></li>
  142. </ul>
  143. </div>
  144. </div>
  145. </nav>
  146. <div class="catalyst-container">
  147. <div class="catalyst-page-level-bar" id="catalyst-page-level-bar">
  148. <div class="catalyst-breadcrumbs-wrapper">
  149. <div role="navigation" aria-label="breadcrumbs navigation">
  150. <ul class="catalyst-breadcrumbs">
  151. <li>
  152. <a href="../index.html">
  153. Docs
  154. </a> &gt;
  155. </li>
  156. <li>Live Plotting of Data During the Simulation</li>
  157. <li class="catalyst-breadcrumbs-aside">
  158. </li>
  159. </ul>
  160. </div>
  161. </div>
  162. <div class="catalyst-shortcuts-wrapper" id="catalyst-shortcuts-wrapper">
  163. Shortcuts
  164. </div>
  165. </div>
  166. <section data-toggle="wy-nav-shift" id="catalyst-content-wrap" class="catalyst-content-wrap">
  167. <div class="catalyst-content-left">
  168. <div class="rst-content">
  169. <div role="main" class="main-content" itemscope="itemscope" itemtype="http://schema.org/Article">
  170. <article itemprop="articleBody" id="catalyst-article" class="catalyst-article">
  171. <div class="section" id="live-plotting-of-data-during-the-simulation">
  172. <h1>Live Plotting of Data During the Simulation<a class="headerlink" href="#live-plotting-of-data-during-the-simulation" title="Permalink to this headline">¶</a></h1>
  173. <p>During a (realtime) simulation, often you would like to show some data that’s being sent over a
  174. certain connection. This can be intermediary data (i.e. the individual components of a computation),
  175. system data (battery life, sensor information…) or output information (results, actuator inputs…).</p>
  176. <p>Luckily, the CBD framework provides this functionality in a clean and efficient manner.</p>
  177. <div class="admonition attention">
  178. <p class="first admonition-title">Attention</p>
  179. <p class="last">In the future, <cite>Seaborn</cite>, <cite>Jupyter</cite> and <cite>ggplot</cite> will also be added and described. For now, only
  180. <cite>MatPlotLib</cite> and <cite>Bokeh</cite> are possible.</p>
  181. </div>
  182. <p>To allow for “live” plotting of data, make use of the <a class="reference internal" href="../CBD.realtime.plotting.html#CBD.realtime.plotting.PlotManager" title="CBD.realtime.plotting.PlotManager"><code class="xref py py-class docutils literal notranslate"><span class="pre">CBD.realtime.plotting.PlotManager</span></code></a> class,
  183. which is a wrapper for tracking multiple realtime plots. Internally, it will keep track of multiple
  184. <a class="reference internal" href="../CBD.realtime.plotting.html#CBD.realtime.plotting.PlotHandler" title="CBD.realtime.plotting.PlotHandler"><code class="xref py py-class docutils literal notranslate"><span class="pre">CBD.realtime.plotting.PlotHandler</span></code></a> instances to reduce code-overhead.</p>
  185. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">CBD.realtime.plotting</span> <span class="kn">import</span> <span class="n">PlotManager</span><span class="p">,</span> <span class="n">ScatterPlot</span>
  186. <span class="n">manager</span> <span class="o">=</span> <span class="n">PlotManager</span><span class="p">()</span>
  187. <span class="c1"># Register a scatter plot handler with name &quot;myHandler&quot;, which listens to</span>
  188. <span class="c1"># the data of the block &quot;myBlock&quot;.</span>
  189. <span class="n">manager</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="s2">&quot;myHandler&quot;</span><span class="p">,</span> <span class="n">MyBlock</span><span class="p">(</span><span class="s1">&#39;myBlock&#39;</span><span class="p">),</span> <span class="n">figure</span><span class="p">,</span> <span class="n">ScatterPlot</span><span class="p">())</span>
  190. </pre></div>
  191. </div>
  192. <p>Notice you also need a block that stores the data. For plotting a single signal, it’s best to use the
  193. <a class="reference internal" href="../CBD.lib.interface.endpoints.html#CBD.lib.interface.endpoints.SignalCollectorBlock" title="CBD.lib.interface.endpoints.SignalCollectorBlock"><code class="xref py py-class docutils literal notranslate"><span class="pre">CBD.lib.interface.endpoints.SignalCollectorBlock</span></code></a>. Alternatively, to plot XY-pairs, the
  194. <a class="reference internal" href="../CBD.lib.interface.endpoints.html#CBD.lib.interface.endpoints.PositionCollectorBlock" title="CBD.lib.interface.endpoints.PositionCollectorBlock"><code class="xref py py-class docutils literal notranslate"><span class="pre">CBD.lib.interface.endpoints.PositionCollectorBlock</span></code></a> can be used.</p>
  195. <div class="section" id="example-model">
  196. <h2>Example Model<a class="headerlink" href="#example-model" title="Permalink to this headline">¶</a></h2>
  197. <p>The examples below show how you can display a live plot for the <a class="reference internal" href="SinGen.html"><span class="doc">Sine Generator</span></a>, plotted in realtime.
  198. The output of this block is removed and changed to a <code class="code docutils literal notranslate"><span class="pre">SignalCollectorBlock</span></code>:</p>
  199. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">CBD.CBD</span> <span class="kn">import</span> <span class="n">CBD</span>
  200. <span class="kn">from</span> <span class="nn">CBD.lib.std</span> <span class="kn">import</span> <span class="n">TimeBlock</span><span class="p">,</span> <span class="n">GenericBlock</span>
  201. <span class="kn">from</span> <span class="nn">CBD.lib.interface.endpoints</span> <span class="kn">import</span> <span class="n">SignalCollectorBlock</span>
  202. <span class="k">class</span> <span class="nc">SinGen</span><span class="p">(</span><span class="n">CBD</span><span class="p">):</span>
  203. <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s2">&quot;SinGen&quot;</span><span class="p">):</span>
  204. <span class="n">CBD</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">input_ports</span><span class="o">=</span><span class="p">[],</span> <span class="n">output_ports</span><span class="o">=</span><span class="p">[])</span>
  205. <span class="c1"># Create the blocks</span>
  206. <span class="bp">self</span><span class="o">.</span><span class="n">addBlock</span><span class="p">(</span><span class="n">TimeBlock</span><span class="p">(</span><span class="s2">&quot;time&quot;</span><span class="p">))</span>
  207. <span class="bp">self</span><span class="o">.</span><span class="n">addBlock</span><span class="p">(</span><span class="n">GenericBlock</span><span class="p">(</span><span class="s2">&quot;sin&quot;</span><span class="p">,</span> <span class="n">block_operator</span><span class="o">=</span><span class="s2">&quot;sin&quot;</span><span class="p">))</span>
  208. <span class="bp">self</span><span class="o">.</span><span class="n">addBlock</span><span class="p">(</span><span class="n">SignalCollectorBlock</span><span class="p">(</span><span class="s2">&quot;collector&quot;</span><span class="p">))</span>
  209. <span class="c1"># Connect the blocks</span>
  210. <span class="bp">self</span><span class="o">.</span><span class="n">addConnection</span><span class="p">(</span><span class="s2">&quot;time&quot;</span><span class="p">,</span> <span class="s2">&quot;sin&quot;</span><span class="p">)</span>
  211. <span class="bp">self</span><span class="o">.</span><span class="n">addConnection</span><span class="p">(</span><span class="s2">&quot;sin&quot;</span><span class="p">,</span> <span class="s2">&quot;collector&quot;</span><span class="p">)</span>
  212. <span class="n">sinGen</span> <span class="o">=</span> <span class="n">SinGen</span><span class="p">(</span><span class="s2">&quot;SinGen&quot;</span><span class="p">)</span>
  213. </pre></div>
  214. </div>
  215. </div>
  216. <div class="section" id="using-matplotlib">
  217. <h2>Using MatPlotLib<a class="headerlink" href="#using-matplotlib" title="Permalink to this headline">¶</a></h2>
  218. <p>The most common plotting framework for Python is <a class="reference external" href="https://matplotlib.org/">MatPlotLib</a>. It provides
  219. a lot of additional features and functionalities, but we will keep it simple. For more complexity, please
  220. refer to their documentation.</p>
  221. <div class="admonition note">
  222. <p class="first admonition-title">Note</p>
  223. <p class="last">While there are other plotting frameworks, <cite>MatPlotLib</cite> is by far the easiest to get live plotting
  224. to work.</p>
  225. </div>
  226. <div class="section" id="default">
  227. <h3>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h3>
  228. <p>If we’re not concerned about a window manager in our system, we can easily make use of <cite>MatPlotLib</cite>’s
  229. builtin plotting window.</p>
  230. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">CBD.realtime.plotting</span> <span class="kn">import</span> <span class="n">PlotManager</span><span class="p">,</span> <span class="n">LinePlot</span><span class="p">,</span> <span class="n">follow</span>
  231. <span class="kn">from</span> <span class="nn">CBD.simulator</span> <span class="kn">import</span> <span class="n">Simulator</span>
  232. <span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
  233. <span class="n">fig</span> <span class="o">=</span> <span class="n">plt</span><span class="o">.</span><span class="n">figure</span><span class="p">(</span><span class="n">figsize</span><span class="o">=</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span> <span class="mi">5</span><span class="p">),</span> <span class="n">dpi</span><span class="o">=</span><span class="mi">100</span><span class="p">)</span>
  234. <span class="n">ax</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">111</span><span class="p">)</span>
  235. <span class="n">ax</span><span class="o">.</span><span class="n">set_ylim</span><span class="p">((</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">))</span> <span class="c1"># The sine wave never exceeds this range</span>
  236. <span class="n">manager</span> <span class="o">=</span> <span class="n">PlotManager</span><span class="p">()</span>
  237. <span class="n">manager</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="s2">&quot;sin&quot;</span><span class="p">,</span> <span class="n">sinGen</span><span class="o">.</span><span class="n">findBlock</span><span class="p">(</span><span class="s1">&#39;collector&#39;</span><span class="p">)[</span><span class="mi">0</span><span class="p">],</span> <span class="p">(</span><span class="n">fig</span><span class="p">,</span> <span class="n">ax</span><span class="p">),</span> <span class="n">LinePlot</span><span class="p">(</span><span class="n">color</span><span class="o">=</span><span class="s1">&#39;red&#39;</span><span class="p">))</span>
  238. <span class="n">manager</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="s1">&#39;sin&#39;</span><span class="p">,</span> <span class="s1">&#39;update_event&#39;</span><span class="p">,</span> <span class="k">lambda</span> <span class="n">d</span><span class="p">,</span> <span class="n">axis</span><span class="o">=</span><span class="n">ax</span><span class="p">:</span> <span class="n">axis</span><span class="o">.</span><span class="n">set_xlim</span><span class="p">(</span><span class="n">follow</span><span class="p">(</span><span class="n">d</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="mf">10.0</span><span class="p">,</span> <span class="n">lower_bound</span><span class="o">=</span><span class="mf">0.0</span><span class="p">)))</span>
  239. <span class="n">sim</span> <span class="o">=</span> <span class="n">Simulator</span><span class="p">(</span><span class="n">sinGen</span><span class="p">)</span>
  240. <span class="n">sim</span><span class="o">.</span><span class="n">setRealTime</span><span class="p">()</span>
  241. <span class="n">sim</span><span class="o">.</span><span class="n">setDeltaT</span><span class="p">(</span><span class="mf">0.1</span><span class="p">)</span>
  242. <span class="n">sim</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="mf">20.0</span><span class="p">)</span>
  243. <span class="n">plt</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
  244. </pre></div>
  245. </div>
  246. <div class="figure">
  247. <a class="reference internal image-reference" href="../_images/sine-wave-mpl.gif"><img alt="../_images/sine-wave-mpl.gif" src="../_images/sine-wave-mpl.gif" style="width: 400px;" /></a>
  248. </div>
  249. </div>
  250. <div class="section" id="tkinter">
  251. <h3>TkInter<a class="headerlink" href="#tkinter" title="Permalink to this headline">¶</a></h3>
  252. <p>Now, as mentioned in <a class="reference internal" href="RealTime.html"><span class="doc">Realtime Simulation</span></a>, there is also a <code class="code docutils literal notranslate"><span class="pre">TkInter</span></code> platform to run the realtime
  253. simulation on. This can be useful for creating graphical user interfaces (GUIs). Sometimes, such a
  254. GUI might be in need of a plot of the data.</p>
  255. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">CBD.realtime.plotting</span> <span class="kn">import</span> <span class="n">PlotManager</span><span class="p">,</span> <span class="n">LinePlot</span><span class="p">,</span> <span class="n">follow</span>
  256. <span class="kn">from</span> <span class="nn">CBD.simulator</span> <span class="kn">import</span> <span class="n">Simulator</span>
  257. <span class="kn">import</span> <span class="nn">tkinter</span> <span class="k">as</span> <span class="nn">tk</span>
  258. <span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
  259. <span class="kn">from</span> <span class="nn">matplotlib.backends.backend_tkagg</span> <span class="kn">import</span> <span class="n">FigureCanvasTkAgg</span>
  260. <span class="n">fig</span> <span class="o">=</span> <span class="n">plt</span><span class="o">.</span><span class="n">figure</span><span class="p">(</span><span class="n">figsize</span><span class="o">=</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span> <span class="mi">5</span><span class="p">),</span> <span class="n">dpi</span><span class="o">=</span><span class="mi">100</span><span class="p">)</span>
  261. <span class="n">ax</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">111</span><span class="p">)</span>
  262. <span class="n">ax</span><span class="o">.</span><span class="n">set_ylim</span><span class="p">((</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">))</span> <span class="c1"># The sine wave never exceeds this range</span>
  263. <span class="n">root</span> <span class="o">=</span> <span class="n">tk</span><span class="o">.</span><span class="n">Tk</span><span class="p">()</span>
  264. <span class="c1"># Create a canvas to draw the plot on</span>
  265. <span class="n">canvas</span> <span class="o">=</span> <span class="n">FigureCanvasTkAgg</span><span class="p">(</span><span class="n">fig</span><span class="p">,</span> <span class="n">master</span><span class="o">=</span><span class="n">root</span><span class="p">)</span> <span class="c1"># A Tk DrawingArea</span>
  266. <span class="n">canvas</span><span class="o">.</span><span class="n">draw</span><span class="p">()</span>
  267. <span class="n">canvas</span><span class="o">.</span><span class="n">get_tk_widget</span><span class="p">()</span><span class="o">.</span><span class="n">grid</span><span class="p">(</span><span class="n">column</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">row</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
  268. <span class="n">manager</span> <span class="o">=</span> <span class="n">PlotManager</span><span class="p">()</span>
  269. <span class="n">manager</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="s2">&quot;sin&quot;</span><span class="p">,</span> <span class="n">sinGen</span><span class="o">.</span><span class="n">findBlock</span><span class="p">(</span><span class="s1">&#39;collector&#39;</span><span class="p">)[</span><span class="mi">0</span><span class="p">],</span> <span class="p">(</span><span class="n">fig</span><span class="p">,</span> <span class="n">ax</span><span class="p">),</span> <span class="n">LinePlot</span><span class="p">(</span><span class="n">color</span><span class="o">=</span><span class="s1">&#39;red&#39;</span><span class="p">))</span>
  270. <span class="n">manager</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="s1">&#39;sin&#39;</span><span class="p">,</span> <span class="s1">&#39;update_event&#39;</span><span class="p">,</span> <span class="k">lambda</span> <span class="n">d</span><span class="p">,</span> <span class="n">axis</span><span class="o">=</span><span class="n">ax</span><span class="p">:</span> <span class="n">axis</span><span class="o">.</span><span class="n">set_xlim</span><span class="p">(</span><span class="n">follow</span><span class="p">(</span><span class="n">d</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="mf">10.0</span><span class="p">,</span> <span class="n">lower_bound</span><span class="o">=</span><span class="mf">0.0</span><span class="p">)))</span>
  271. <span class="n">sim</span> <span class="o">=</span> <span class="n">Simulator</span><span class="p">(</span><span class="n">sinGen</span><span class="p">)</span>
  272. <span class="n">sim</span><span class="o">.</span><span class="n">setRealTime</span><span class="p">()</span>
  273. <span class="n">sim</span><span class="o">.</span><span class="n">setRealTimePlatformTk</span><span class="p">(</span><span class="n">root</span><span class="p">)</span>
  274. <span class="n">sim</span><span class="o">.</span><span class="n">setDeltaT</span><span class="p">(</span><span class="mf">0.1</span><span class="p">)</span>
  275. <span class="n">sim</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="mf">20.0</span><span class="p">)</span>
  276. <span class="n">root</span><span class="o">.</span><span class="n">mainloop</span><span class="p">()</span>
  277. </pre></div>
  278. </div>
  279. <p>The plot will look exactly like the one for the default platform, except that it is inside a <code class="code docutils literal notranslate"><span class="pre">TkInter</span></code> window
  280. now.</p>
  281. </div>
  282. </div>
  283. <div class="section" id="using-bokeh">
  284. <h2>Using Bokeh<a class="headerlink" href="#using-bokeh" title="Permalink to this headline">¶</a></h2>
  285. <p>As an alternative for <cite>MatPlotLib</cite>, <a class="reference external" href="https://docs.bokeh.org/en/latest/index.html">Bokeh</a> kan be used. However, as
  286. you will see, this will require a little bit more “managing” code.</p>
  287. <div class="admonition warning">
  288. <p class="first admonition-title">Warning</p>
  289. <p>In order to get this plotting framework to show live plots, you need to start a <cite>Bokeh</cite> server via the command:</p>
  290. <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>bokeh serve
  291. </pre></div>
  292. </div>
  293. <div class="last line-block">
  294. <div class="line"><br /></div>
  295. </div>
  296. </div>
  297. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span> <span class="nn">CBD.realtime.plotting</span> <span class="kn">import</span> <span class="n">PlotManager</span><span class="p">,</span> <span class="n">Backend</span><span class="p">,</span> <span class="n">LinePlot</span><span class="p">,</span> <span class="n">follow</span>
  298. <span class="kn">from</span> <span class="nn">CBD.simulator</span> <span class="kn">import</span> <span class="n">Simulator</span>
  299. <span class="kn">from</span> <span class="nn">bokeh.plotting</span> <span class="kn">import</span> <span class="n">figure</span><span class="p">,</span> <span class="n">curdoc</span>
  300. <span class="kn">from</span> <span class="nn">bokeh.client</span> <span class="kn">import</span> <span class="n">push_session</span>
  301. <span class="n">fig</span> <span class="o">=</span> <span class="n">figure</span><span class="p">(</span><span class="n">plot_width</span><span class="o">=</span><span class="mi">500</span><span class="p">,</span> <span class="n">plot_height</span><span class="o">=</span><span class="mi">500</span><span class="p">,</span> <span class="n">y_range</span><span class="o">=</span><span class="p">(</span><span class="o">-</span><span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">))</span>
  302. <span class="n">curdoc</span><span class="p">()</span><span class="o">.</span><span class="n">add_root</span><span class="p">(</span><span class="n">fig</span><span class="p">)</span>
  303. <span class="c1"># Use the Bokeh Backend</span>
  304. <span class="n">manager</span> <span class="o">=</span> <span class="n">PlotManager</span><span class="p">(</span><span class="n">Backend</span><span class="o">.</span><span class="n">BOKEH</span><span class="p">)</span>
  305. <span class="n">manager</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="s2">&quot;sin&quot;</span><span class="p">,</span> <span class="n">sinGen</span><span class="o">.</span><span class="n">findBlock</span><span class="p">(</span><span class="s1">&#39;collector&#39;</span><span class="p">)[</span><span class="mi">0</span><span class="p">],</span> <span class="n">fig</span><span class="p">,</span> <span class="n">LinePlot</span><span class="p">(</span><span class="n">color</span><span class="o">=</span><span class="s1">&#39;red&#39;</span><span class="p">))</span>
  306. <span class="k">def</span> <span class="nf">set_xlim</span><span class="p">(</span><span class="n">limits</span><span class="p">):</span>
  307. <span class="n">lower</span><span class="p">,</span> <span class="n">upper</span> <span class="o">=</span> <span class="n">limits</span>
  308. <span class="n">fig</span><span class="o">.</span><span class="n">x_range</span><span class="o">.</span><span class="n">start</span> <span class="o">=</span> <span class="n">lower</span>
  309. <span class="n">fig</span><span class="o">.</span><span class="n">x_range</span><span class="o">.</span><span class="n">end</span> <span class="o">=</span> <span class="n">upper</span>
  310. <span class="n">manager</span><span class="o">.</span><span class="n">connect</span><span class="p">(</span><span class="s1">&#39;sin&#39;</span><span class="p">,</span> <span class="s1">&#39;update_event&#39;</span><span class="p">,</span> <span class="k">lambda</span> <span class="n">d</span><span class="p">:</span> <span class="n">set_xlim</span><span class="p">(</span><span class="n">follow</span><span class="p">(</span><span class="n">d</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="mf">10.0</span><span class="p">,</span> <span class="n">lower_bound</span><span class="o">=</span><span class="mf">0.0</span><span class="p">)))</span>
  311. <span class="n">session</span> <span class="o">=</span> <span class="n">push_session</span><span class="p">(</span><span class="n">curdoc</span><span class="p">())</span>
  312. <span class="n">session</span><span class="o">.</span><span class="n">show</span><span class="p">()</span>
  313. <span class="n">sim</span> <span class="o">=</span> <span class="n">Simulator</span><span class="p">(</span><span class="n">sinGen</span><span class="p">)</span>
  314. <span class="n">sim</span><span class="o">.</span><span class="n">setRealTime</span><span class="p">()</span>
  315. <span class="n">sim</span><span class="o">.</span><span class="n">setDeltaT</span><span class="p">(</span><span class="mf">0.1</span><span class="p">)</span>
  316. <span class="n">sim</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="mf">20.0</span><span class="p">)</span>
  317. <span class="c1"># NOTE: currently, there can be &#39;flickering&#39; of the plot</span>
  318. <span class="kn">import</span> <span class="nn">time</span>
  319. <span class="k">while</span> <span class="n">manager</span><span class="o">.</span><span class="n">is_opened</span><span class="p">():</span>
  320. <span class="n">session</span><span class="o">.</span><span class="n">push</span><span class="p">()</span>
  321. <span class="n">time</span><span class="o">.</span><span class="n">sleep</span><span class="p">(</span><span class="mf">0.1</span><span class="p">)</span>
  322. </pre></div>
  323. </div>
  324. <div class="figure">
  325. <a class="reference internal image-reference" href="../_images/sine-wave-bokeh.gif"><img alt="../_images/sine-wave-bokeh.gif" src="../_images/sine-wave-bokeh.gif" style="width: 400px;" /></a>
  326. </div>
  327. <div class="admonition note">
  328. <p class="first admonition-title">Note</p>
  329. <p class="last">Currenly, there is a lot of “flickering” of the plot. There has not yet been found a solution
  330. for this problem.</p>
  331. </div>
  332. </div>
  333. </div>
  334. </article>
  335. </div>
  336. <footer>
  337. <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
  338. <a href="../CBD.html" class="btn btn-neutral float-right" title="CBD package" accesskey="n" rel="next">Next <img src="../_static/images/chevron-right-orange.svg" class="next-page"></a>
  339. <a href="RealTime.html" class="btn btn-neutral" title="Realtime Simulation" accesskey="p" rel="prev"><img src="../_static/images/chevron-right-orange.svg" class="previous-page"> Previous</a>
  340. </div>
  341. <hr>
  342. <div role="contentinfo">
  343. <p>
  344. &copy; Copyright 2020, Randy Paredis.
  345. </p>
  346. </div>
  347. <div>
  348. Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
  349. </div>
  350. </footer>
  351. </div>
  352. </div>
  353. <div class="catalyst-content-right" id="catalyst-content-right">
  354. <div class="catalyst-right-menu" id="catalyst-right-menu">
  355. <div class="catalyst-side-scroll" id="catalyst-side-scroll-right">
  356. <ul>
  357. <li><a class="reference internal" href="#">Live Plotting of Data During the Simulation</a><ul>
  358. <li><a class="reference internal" href="#example-model">Example Model</a></li>
  359. <li><a class="reference internal" href="#using-matplotlib">Using MatPlotLib</a><ul>
  360. <li><a class="reference internal" href="#default">Default</a></li>
  361. <li><a class="reference internal" href="#tkinter">TkInter</a></li>
  362. </ul>
  363. </li>
  364. <li><a class="reference internal" href="#using-bokeh">Using Bokeh</a></li>
  365. </ul>
  366. </li>
  367. </ul>
  368. </div>
  369. </div>
  370. </div>
  371. </section>
  372. </div>
  373. <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
  374. <script type="text/javascript" src="../_static/jquery.js"></script>
  375. <script type="text/javascript" src="../_static/underscore.js"></script>
  376. <script type="text/javascript" src="../_static/doctools.js"></script>
  377. <script type="text/javascript" src="../_static/language_data.js"></script>
  378. <script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
  379. <script type="text/javascript" src="../_static/js/vendor/popper.min.js"></script>
  380. <script type="text/javascript" src="../_static/js/vendor/bootstrap.min.js"></script>
  381. <script type="text/javascript" src="../_static/js/theme.js"></script>
  382. <script type="text/javascript">
  383. jQuery(function () {
  384. SphinxRtdTheme.Navigation.enable(true);
  385. });
  386. </script>
  387. <!-- Begin Footer -->
  388. <footer class="site-footer" id="site-footer">
  389. <div class="container footer-container">
  390. <div class="footer-logo-wrapper">
  391. <a href="https://catalyst-team.com/" class="footer-logo"></a>
  392. </div>
  393. <div class="footer-links-wrapper">
  394. <div class="footer-links-col">
  395. <ul>
  396. <li class="list-title"><a href="https://github.com/catalyst-team">Ecosystem</a></li>
  397. <li><a class="nav-dropdown-item" href="https://alchemy.host">Alchemy</a></li>
  398. <li><a class="nav-dropdown-item" href="https://github.com/catalyst-team/catalyst">Catalyst</a></li>
  399. <li><a class="nav-dropdown-item" href="https://github.com/catalyst-team/reaction">Reaction</a></li>
  400. </ul>
  401. </div>
  402. <div class="footer-links-col">
  403. <ul>
  404. <li class="list-title"><a href="https://github.com/catalyst-team">Projects</a></li>
  405. <li><a class="nav-dropdown-item" href="https://github.com/catalyst-team/codestyle">Codestyle</a></li>
  406. <li><a class="nav-dropdown-item" href="https://github.com/catalyst-team/neuro">Catalyst.Neuro</a></li>
  407. <li><a class="nav-dropdown-item" href="https://github.com/catalyst-team/classification">Classification</a></li>
  408. <li><a class="nav-dropdown-item" href="https://github.com/catalyst-team/detection">Detection</a></li>
  409. <li><a class="nav-dropdown-item" href="https://github.com/catalyst-team/segmentation">Segmentation</a></li>
  410. <li><a class="nav-dropdown-item" href="https://github.com/catalyst-team/gan">Catalyst.GAN</a></li>
  411. </ul>
  412. </div>
  413. <div class="footer-links-col">
  414. <ul>
  415. <li class="list-title"><a href="https://catalyst-team.com/">Support</a></li>
  416. <li><a href="https://github.com/catalyst-team/catalyst/issues" target="_blank">Github Issues</a></li>
  417. <li><a href="https://github.com/catalyst-team/catalyst/blob/master/CONTRIBUTING.md" target="_blank">Contributing</a></li>
  418. <li><a href="https://www.patreon.com/catalyst_team" target="_blank">Patreon</a></li>
  419. </ul>
  420. </div>
  421. <div class="footer-links-col follow-us-col">
  422. <div class="footer-social-icons">
  423. <a href="https://t.me/catalyst_team" target="_blank" class="telegram"></a>
  424. <a href="https://twitter.com/catalyst_core" target="_blank" class="twitter"></a>
  425. <a href="https://join.slack.com/t/catalyst-team-core/shared_invite/zt-d9miirnn-z86oKDzFMKlMG4fgFdZafw" target="_blank" class="ods"></a>
  426. </div>
  427. </div>
  428. </div>
  429. </div>
  430. </footer>
  431. <!-- End Footer -->
  432. <!-- Begin Mobile Menu -->
  433. <div class="mobile-main-menu">
  434. <div class="container-fluid">
  435. <div class="container">
  436. <div class="mobile-main-menu-header-container">
  437. <a class="header-logo" href="https://catalyst-team.com/" aria-label="Catalyst"></a>
  438. <a class="main-menu-close-button" href="#" data-behavior="close-mobile-menu"></a>
  439. </div>
  440. </div>
  441. </div>
  442. <div class="mobile-main-menu-links-container">
  443. <div class="main-menu">
  444. <ul>
  445. <li>
  446. <a href="">Get Started</a>
  447. </li>
  448. <li>
  449. <a href="https://github.com/catalyst-team/catalyst">Github</a>
  450. </li>
  451. </ul>
  452. </div>
  453. </div>
  454. </div>
  455. <!-- End Mobile Menu -->
  456. <script type="text/javascript" src="../_static/js/vendor/anchor.min.js"></script>
  457. <script type="text/javascript">
  458. $(document).ready(function() {
  459. mobileMenu.bind();
  460. mobileTOC.bind();
  461. catalystAnchors.bind();
  462. sideMenus.bind();
  463. scrollToAnchor.bind();
  464. highlightNavigation.bind();
  465. mainMenuDropdown.bind();
  466. // Add class to links that have code blocks, since we cannot create links in code blocks
  467. $("article.catalyst-article a span.pre").each(function(e) {
  468. $(this).closest("a").addClass("has-code");
  469. });
  470. })
  471. </script>
  472. </body>
  473. </html>