Update Sphinx documentation, commit c65f760 [skip ci].

_sources/changelog.rst

@@ -3,7 +3,7 @@
 Changelog
 =========
 
-2.0.0 (unreleased)
+2.0.0 (2023-09-22)
 ------------------
 
 New

index.html

@@ -501,29 +501,29 @@ <h1>heyoka.py<a class="headerlink" href="#heyoka-py" title="Permalink to this he
 </li>
 <li class="toctree-l1"><a class="reference internal" href="benchmarks.html">Benchmarks</a></li>
 <li class="toctree-l1"><a class="reference internal" href="changelog.html">Changelog</a><ul>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#unreleased">2.0.0 (unreleased)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id2">1.0.0 (2023-08-11)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id4">0.21.8 (2023-07-03)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id5">0.21.7 (2023-02-16)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id8">0.20.0 (2022-12-18)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id12">0.19.0 (2022-09-19)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id15">0.18.0 (2022-05-11)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id19">0.17.0 (2022-01-25)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id23">0.16.0 (2021-11-20)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id26">0.15.1 (2021-10-10)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id28">0.15.0 (2021-09-28)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id32">0.14.0 (2021-08-03)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id35">0.12.0 (2021-07-23)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id38">0.11.0 (2021-07-06)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id41">0.10.0 (2021-06-09)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id44">0.9.0 (2021-05-25)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id47">0.8.0 (2021-04-28)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id50">0.7.0 (2021-04-22)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id53">0.6.1 (2021-04-08)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id56">0.6.0 (2021-04-06)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id60">0.5.0 (2021-02-25)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id63">0.4.0 (2021-02-20)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id66">0.3.0 (2021-02-13)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id2">2.0.0 (2023-09-22)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id3">1.0.0 (2023-08-11)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id5">0.21.8 (2023-07-03)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id6">0.21.7 (2023-02-16)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id9">0.20.0 (2022-12-18)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id13">0.19.0 (2022-09-19)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id16">0.18.0 (2022-05-11)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id20">0.17.0 (2022-01-25)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id24">0.16.0 (2021-11-20)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id27">0.15.1 (2021-10-10)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id29">0.15.0 (2021-09-28)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id33">0.14.0 (2021-08-03)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id36">0.12.0 (2021-07-23)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id39">0.11.0 (2021-07-06)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id42">0.10.0 (2021-06-09)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id45">0.9.0 (2021-05-25)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id48">0.8.0 (2021-04-28)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id51">0.7.0 (2021-04-22)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id54">0.6.1 (2021-04-08)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id57">0.6.0 (2021-04-06)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id61">0.5.0 (2021-02-25)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id64">0.4.0 (2021-02-20)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id67">0.3.0 (2021-02-13)</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="breaking_changes.html">Breaking changes</a><ul>

notebooks/Batch mode overview.html

@@ -1320,7 +1320,7 @@ <h2>Ensemble propagations<a class="headerlink" href="#ensemble-propagations" tit
 </div>
 </div>
 <div class="cell_output docutils container">
-<img alt="../_images/ab9cf267083977ccd7107c853dea5c2e731cdef3d156b96cf500018f2ec86ca0.png" src="../_images/ab9cf267083977ccd7107c853dea5c2e731cdef3d156b96cf500018f2ec86ca0.png" />
+<img alt="../_images/3a4a05c74bc4043529729351017f028a38badf20d4325f2dc0447549805c24d0.png" src="../_images/3a4a05c74bc4043529729351017f028a38badf20d4325f2dc0447549805c24d0.png" />
 </div>
 </div>
 </section>

notebooks/Customising the adaptive integrator.html

@@ -574,8 +574,8 @@ <h2>Compact mode<a class="headerlink" href="#compact-mode" title="Permalink to t
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 5.37 s, sys: 87.1 ms, total: 5.46 s
-Wall time: 5.46 s
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 6.01 s, sys: 58.2 ms, total: 6.07 s
+Wall time: 6.08 s
 </pre></div>
 </div>
 </div>
@@ -590,8 +590,8 @@ <h2>Compact mode<a class="headerlink" href="#compact-mode" title="Permalink to t
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 189 ms, sys: 7.65 ms, total: 197 ms
-Wall time: 196 ms
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 201 ms, sys: 0 ns, total: 201 ms
+Wall time: 200 ms
 </pre></div>
 </div>
 </div>

notebooks/Optimal Control of the Lotka-Volterra equations.html

@@ -1036,9 +1036,9 @@ <h2>Implementing a single shooting method<a class="headerlink" href="#implementi
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stderr highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>/tmp/ipykernel_13118/2332358995.py:11: DeprecationWarning: Conversion of an array with ndim &gt; 0 to a scalar is deprecated, and will error in future. Ensure you extract a single element from your array before performing this operation. (Deprecated NumPy 1.25.)
+<div class="output stderr highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>/tmp/ipykernel_13138/2332358995.py:11: DeprecationWarning: Conversion of an array with ndim &gt; 0 to a scalar is deprecated, and will error in future. Ensure you extract a single element from your array before performing this operation. (Deprecated NumPy 1.25.)
   ta.pars[6] = np.heaviside(switching_function(x_0,y_0,lx_0,ly_0, ps), 1.)
-/tmp/ipykernel_13118/2332358995.py:14: DeprecationWarning: Conversion of an array with ndim &gt; 0 to a scalar is deprecated, and will error in future. Ensure you extract a single element from your array before performing this operation. (Deprecated NumPy 1.25.)
+/tmp/ipykernel_13138/2332358995.py:14: DeprecationWarning: Conversion of an array with ndim &gt; 0 to a scalar is deprecated, and will error in future. Ensure you extract a single element from your array before performing this operation. (Deprecated NumPy 1.25.)
   ta.state[0] = x_0; ta.state[1] = y_0; ta.state[2] = lx_0; ta.state[3] = ly_0
 </pre></div>
 </div>
@@ -1080,7 +1080,7 @@ <h2>Implementing a single shooting method<a class="headerlink" href="#implementi
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stderr highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>/tmp/ipykernel_13118/685660463.py:12: DeprecationWarning: Conversion of an array with ndim &gt; 0 to a scalar is deprecated, and will error in future. Ensure you extract a single element from your array before performing this operation. (Deprecated NumPy 1.25.)
+<div class="output stderr highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>/tmp/ipykernel_13138/685660463.py:12: DeprecationWarning: Conversion of an array with ndim &gt; 0 to a scalar is deprecated, and will error in future. Ensure you extract a single element from your array before performing this operation. (Deprecated NumPy 1.25.)
   ta.pars[6] = np.heaviside(switching_function(x_0,y_0,lx_0,ly_0, ps), 1.)
 </pre></div>
 </div>

notebooks/Periodic orbits in the CR3BP.html

@@ -675,7 +675,7 @@ <h2>Putting all together and integrating some initial conditions<a class="header
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 10.38841199874878 seconds --- to build the Taylor integrator
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 12.622141122817993 seconds --- to build the Taylor integrator
 </pre></div>
 </div>
 </div>
@@ -706,7 +706,7 @@ <h2>Putting all together and integrating some initial conditions<a class="header
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 0.052178144454956055 seconds --- to propagate
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 0.04988574981689453 seconds --- to propagate
 </pre></div>
 </div>
 </div>
@@ -764,7 +764,7 @@ <h2>Putting all together and integrating some initial conditions<a class="header
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>&lt;matplotlib.collections.PathCollection at 0x7f62a96b69b0&gt;
+<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>&lt;matplotlib.collections.PathCollection at 0x7fdf7bb66ad0&gt;
 </pre></div>
 </div>
 <img alt="../_images/9980640d13156b473c62a3e3b7e03a3e55926a455c595779849b49a9c3082370.png" src="../_images/9980640d13156b473c62a3e3b7e03a3e55926a455c595779849b49a9c3082370.png" />

notebooks/ensemble_mode.html

@@ -575,11 +575,11 @@ <h2>A simple example<a class="headerlink" href="#a-simple-example" title="Permal
  Taylor order            : 20
  Dimension               : 2
  Time                    : 20
- State                   : [0.05099169342796565, 0.07278139612705842],
+ State                   : [0.040367886243124665, 0.06360052340125145],
  &lt;taylor_outcome.time_limit: -4294967299&gt;,
- 0.19785083591164193,
- 0.2204070479568287,
- 98,
+ 0.2067278685113556,
+ 0.21962740668412822,
+ 95,
  None)
 </pre></div>
 </div>
@@ -630,7 +630,7 @@ <h2>A simple example<a class="headerlink" href="#a-simple-example" title="Permal
 </div>
 </div>
 <div class="cell_output docutils container">
-<img alt="../_images/7d9ef3a53116ccf3f778be73cdacdc67f97a4e5c65cd4bd674cb0a27f1bacdfc.png" src="../_images/7d9ef3a53116ccf3f778be73cdacdc67f97a4e5c65cd4bd674cb0a27f1bacdfc.png" />
+<img alt="../_images/826e0972f02858a49d01fc12d1c18392f1dd79aaecdd3069977f6ba694bbdc40.png" src="../_images/826e0972f02858a49d01fc12d1c18392f1dd79aaecdd3069977f6ba694bbdc40.png" />
 </div>
 </div>
 </section>

notebooks/jit_caching.html

@@ -441,8 +441,8 @@ <h1>JIT compilation and caching<a class="headerlink" href="#jit-compilation-and-
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 73.1 ms, sys: 2.16 ms, total: 75.3 ms
-Wall time: 75.3 ms
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 78.2 ms, sys: 56 µs, total: 78.3 ms
+Wall time: 78.3 ms
 </pre></div>
 </div>
 </div>
@@ -455,8 +455,8 @@ <h1>JIT compilation and caching<a class="headerlink" href="#jit-compilation-and-
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 2.65 ms, sys: 0 ns, total: 2.65 ms
-Wall time: 2.29 ms
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 3.26 ms, sys: 0 ns, total: 3.26 ms
+Wall time: 2.68 ms
 </pre></div>
 </div>
 </div>
@@ -470,8 +470,8 @@ <h1>JIT compilation and caching<a class="headerlink" href="#jit-compilation-and-
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 13.3 ms, sys: 975 µs, total: 14.2 ms
-Wall time: 14.1 ms
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 15.9 ms, sys: 0 ns, total: 15.9 ms
+Wall time: 15.6 ms
 </pre></div>
 </div>
 <div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>(&lt;taylor_outcome.time_limit: -4294967299&gt;,
@@ -498,8 +498,8 @@ <h1>JIT compilation and caching<a class="headerlink" href="#jit-compilation-and-
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 1.2 ms, sys: 0 ns, total: 1.2 ms
-Wall time: 797 µs
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 1.57 ms, sys: 0 ns, total: 1.57 ms
+Wall time: 994 µs
 </pre></div>
 </div>
 <div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>(&lt;taylor_outcome.time_limit: -4294967299&gt;,

notebooks/second_integral.html

@@ -609,7 +609,7 @@ <h2>Running the experiments<a class="headerlink" href="#running-the-experiments"
 </div>
 </div>
 <div class="cell_output docutils container">
-<img alt="../_images/2f8b4217b9ebd946344ecb5eaa79d9a498a519fa9a1a11de6eb3dd83e3896c67.png" src="../_images/2f8b4217b9ebd946344ecb5eaa79d9a498a519fa9a1a11de6eb3dd83e3896c67.png" />
+<img alt="../_images/ac2ca3060b60209bae135f1c448764fb940e4b5e3f41e6d4c7faf20d76a1c9f0.png" src="../_images/ac2ca3060b60209bae135f1c448764fb940e4b5e3f41e6d4c7faf20d76a1c9f0.png" />
 </div>
 </div>
 <p>This Poincare’ section is suggesting that the integral of motion <span class="math notranslate nohighlight">\(\mathcal{C}\)</span> does indeed exist, because the intersections of all random orbits are clearly tracing curves on the <span class="math notranslate nohighlight">\(x=0\)</span> plane.</p>
@@ -624,7 +624,7 @@ <h2>Running the experiments<a class="headerlink" href="#running-the-experiments"
 </div>
 </div>
 <div class="cell_output docutils container">
-<img alt="../_images/14e9be604e4071a9a3785536791035fd64a730c01bd03dcc3ffddf10fc993ec6.png" src="../_images/14e9be604e4071a9a3785536791035fd64a730c01bd03dcc3ffddf10fc993ec6.png" />
+<img alt="../_images/f8f5d3b503bef6f2d31ac3b01b55177303bd0a2843aa0fce920f3d4de90e2f0d.png" src="../_images/f8f5d3b503bef6f2d31ac3b01b55177303bd0a2843aa0fce920f3d4de90e2f0d.png" />
 </div>
 </div>
 <p>The qualitative picture is now radically different. Although islands of stable motion persist, now most trajectories seem to be densely filling the plane, rather than tracing curves on it. Let us further increase the energy level:</p>
@@ -635,7 +635,7 @@ <h2>Running the experiments<a class="headerlink" href="#running-the-experiments"
 </div>
 </div>
 <div class="cell_output docutils container">
-<img alt="../_images/3db30ca1a9b030f92ba1adf0e8145f0ef8f3afa0a9ef85f3b148545484949e38.png" src="../_images/3db30ca1a9b030f92ba1adf0e8145f0ef8f3afa0a9ef85f3b148545484949e38.png" />
+<img alt="../_images/633f4bdb3f8046319771a6fcff092098c13293d2f5e7c00dbd9f1a65ae9a6478.png" src="../_images/633f4bdb3f8046319771a6fcff092098c13293d2f5e7c00dbd9f1a65ae9a6478.png" />
 </div>
 </div>
 <p>At higher energies, the densely-filling behaviour (which Henon and Heiles call <em>ergodic</em>) is even more prevalent than before.</p>

notebooks/sympy_interop.html

@@ -598,8 +598,8 @@ <h1>Interoperability with SymPy<a class="headerlink" href="#interoperability-wit
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 2.16 s, sys: 1.43 ms, total: 2.16 s
-Wall time: 2.16 s
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 2.65 s, sys: 2.05 ms, total: 2.65 s
+Wall time: 2.65 s
 </pre></div>
 </div>
 <div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>(&lt;taylor_outcome.time_limit: -4294967299&gt;,
@@ -618,8 +618,8 @@ <h1>Interoperability with SymPy<a class="headerlink" href="#interoperability-wit
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 2.17 s, sys: 4.45 ms, total: 2.18 s
-Wall time: 2.17 s
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 2.78 s, sys: 0 ns, total: 2.78 s
+Wall time: 2.78 s
 </pre></div>
 </div>
 <div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>(&lt;taylor_outcome.time_limit: -4294967299&gt;,