Update Sphinx documentation, commit 84eda66 [skip ci].

_sources/changelog.rst

@@ -3,7 +3,7 @@
 Changelog
 =========
 
-3.0.0 (unreleased)
+3.0.0 (2023-10-07)
 ------------------
 
 Changes

index.html

@@ -501,30 +501,30 @@ <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">3.0.0 (unreleased)</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#id6">0.21.8 (2023-07-03)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id7">0.21.7 (2023-02-16)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id10">0.20.0 (2022-12-18)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id14">0.19.0 (2022-09-19)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id17">0.18.0 (2022-05-11)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id21">0.17.0 (2022-01-25)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id25">0.16.0 (2021-11-20)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id28">0.15.1 (2021-10-10)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id30">0.15.0 (2021-09-28)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id34">0.14.0 (2021-08-03)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id37">0.12.0 (2021-07-23)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id40">0.11.0 (2021-07-06)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id43">0.10.0 (2021-06-09)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id46">0.9.0 (2021-05-25)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id49">0.8.0 (2021-04-28)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id52">0.7.0 (2021-04-22)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id55">0.6.1 (2021-04-08)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id58">0.6.0 (2021-04-06)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id62">0.5.0 (2021-02-25)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id65">0.4.0 (2021-02-20)</a></li>
-<li class="toctree-l2"><a class="reference internal" href="changelog.html#id68">0.3.0 (2021-02-13)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id2">3.0.0 (2023-10-07)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id3">2.0.0 (2023-09-22)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id4">1.0.0 (2023-08-11)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id7">0.21.8 (2023-07-03)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id8">0.21.7 (2023-02-16)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id11">0.20.0 (2022-12-18)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id15">0.19.0 (2022-09-19)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id18">0.18.0 (2022-05-11)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id22">0.17.0 (2022-01-25)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id26">0.16.0 (2021-11-20)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id29">0.15.1 (2021-10-10)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id31">0.15.0 (2021-09-28)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id35">0.14.0 (2021-08-03)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id38">0.12.0 (2021-07-23)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id41">0.11.0 (2021-07-06)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id44">0.10.0 (2021-06-09)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id47">0.9.0 (2021-05-25)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id50">0.8.0 (2021-04-28)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id53">0.7.0 (2021-04-22)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id56">0.6.1 (2021-04-08)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id59">0.6.0 (2021-04-06)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id63">0.5.0 (2021-02-25)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id66">0.4.0 (2021-02-20)</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changelog.html#id69">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/98bb0199ddd7c121aab6ae5b73fcd0eaf4401dcc530a1e6505b2d97b1d6d5681.png" src="../_images/98bb0199ddd7c121aab6ae5b73fcd0eaf4401dcc530a1e6505b2d97b1d6d5681.png" />
+<img alt="../_images/576fc5460baeab671c712015524dbba12c07a42a92e188b218ead3abbc33e1c3.png" src="../_images/576fc5460baeab671c712015524dbba12c07a42a92e188b218ead3abbc33e1c3.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.52 s, sys: 80.9 ms, total: 5.6 s
-Wall time: 5.6 s
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 6.23 s, sys: 62.3 ms, total: 6.29 s
+Wall time: 6.29 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 188 ms, sys: 0 ns, total: 188 ms
-Wall time: 188 ms
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 238 ms, sys: 7 µs, total: 238 ms
+Wall time: 237 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_13185/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_13156/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_13185/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_13156/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_13185/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_13156/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>--- 11.647816181182861 seconds --- to build the Taylor integrator
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 13.76629114151001 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.04867076873779297 seconds --- to propagate
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 0.05161547660827637 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 0x7f546e106d40&gt;
+<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>&lt;matplotlib.collections.PathCollection at 0x7f43cc116d70&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.04298961542530279, 0.0509245465559058],
+ State                   : [0.05274957217287761, 0.058994169278669774],
  &lt;taylor_outcome.time_limit: -4294967299&gt;,
- 0.20603822671494737,
- 0.2187179613751691,
- 95,
+ 0.19787796709340139,
+ 0.22023660740842543,
+ 98,
  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/aa7cab48116841a739527b50c37e6b6071602402f6f6bd0568547412fa3e5706.png" src="../_images/aa7cab48116841a739527b50c37e6b6071602402f6f6bd0568547412fa3e5706.png" />
+<img alt="../_images/fa978776a1c075026ee667abf2bc6072332a765e944e93bc28236e19049395bc.png" src="../_images/fa978776a1c075026ee667abf2bc6072332a765e944e93bc28236e19049395bc.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.7 ms, sys: 8.36 ms, total: 82.1 ms
-Wall time: 82.1 ms
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 77 ms, sys: 4.51 ms, total: 81.5 ms
+Wall time: 81.6 ms
 </pre></div>
 </div>
 </div>
@@ -455,7 +455,7 @@ <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 3.48 ms, sys: 0 ns, total: 3.48 ms
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 3.74 ms, sys: 0 ns, total: 3.74 ms
 Wall time: 2.87 ms
 </pre></div>
 </div>
@@ -471,7 +471,7 @@ <h1>JIT compilation and caching<a class="headerlink" href="#jit-compilation-and-
 </div>
 <div class="cell_output docutils container">
 <div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 15.5 ms, sys: 0 ns, total: 15.5 ms
-Wall time: 15.2 ms
+Wall time: 14.9 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.62 ms, sys: 0 ns, total: 1.62 ms
-Wall time: 1.09 ms
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 1.71 ms, sys: 0 ns, total: 1.71 ms
+Wall time: 1.11 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;,

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/e484929abc8ed016b5864331676d4aab4aa1f213f592d29f81ca35e3a6b47bf8.png" src="../_images/e484929abc8ed016b5864331676d4aab4aa1f213f592d29f81ca35e3a6b47bf8.png" />
+<img alt="../_images/31eaa409423dac75aa16fc84b918fca811b7e9bc694adb876acefba895cf755d.png" src="../_images/31eaa409423dac75aa16fc84b918fca811b7e9bc694adb876acefba895cf755d.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/c2aaed9bfa64a521efc74d749b130cd4ebaa04d642f67cc1520d5f9c2e719339.png" src="../_images/c2aaed9bfa64a521efc74d749b130cd4ebaa04d642f67cc1520d5f9c2e719339.png" />
+<img alt="../_images/cd0cd555d5e9d7cb09b9c10a9192e94eeef9c425b2ce01af18c74a7170557d29.png" src="../_images/cd0cd555d5e9d7cb09b9c10a9192e94eeef9c425b2ce01af18c74a7170557d29.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/e44d95178441654b1881e65949ddd3497b0088a85e30cc3009067bc4087d335b.png" src="../_images/e44d95178441654b1881e65949ddd3497b0088a85e30cc3009067bc4087d335b.png" />
+<img alt="../_images/caee1971c0c309d8ed677c7272a37a635271d98a4e5be290f84e48fae866c5d5.png" src="../_images/caee1971c0c309d8ed677c7272a37a635271d98a4e5be290f84e48fae866c5d5.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.45 s, sys: 14.7 ms, total: 2.46 s
-Wall time: 2.46 s
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 2.11 s, sys: 0 ns, total: 2.11 s
+Wall time: 2.11 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.36 s, sys: 0 ns, total: 2.36 s
-Wall time: 2.36 s
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 2.23 s, sys: 0 ns, total: 2.23 s
+Wall time: 2.23 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;,