Update Sphinx documentation, commit 1bf5483 [skip ci].

_sources/changelog.rst

@@ -3,12 +3,17 @@
 Changelog
 =========
 
-3.2.0 (unreleased)
+3.2.0 (2023-11-29)
 ------------------
 
 New
 ~~~
 
+- New example on a differentiable atmosphere model via
+  neural networks
+  (`#151 <https://github.com/bluescarni/heyoka.py/pull/151>`__).
+- New example on interfacing pytorch and heyoka.py
+  (`#151 <https://github.com/bluescarni/heyoka.py/pull/151>`__).
 - Add wheels for Python 3.12
   (`#150 <https://github.com/bluescarni/heyoka.py/pull/150>`__).
 - Add support for single-precision computations

notebooks/Batch mode overview.html

@@ -1349,7 +1349,7 @@ <h2>Ensemble propagations<a class="headerlink" href="#ensemble-propagations" tit
 </div>
 </div>
 <div class="cell_output docutils container">
-<img alt="../_images/9f470eb8e84a7af2ec66bc83d36fcd4b5af158ccbed86c4845dbb8b7c2f24956.png" src="../_images/9f470eb8e84a7af2ec66bc83d36fcd4b5af158ccbed86c4845dbb8b7c2f24956.png" />
+<img alt="../_images/a0a411857385701f87ecb52c5f6207dd8a526701b3f7834ebd3eec4f1dc1f3f9.png" src="../_images/a0a411857385701f87ecb52c5f6207dd8a526701b3f7834ebd3eec4f1dc1f3f9.png" />
 </div>
 </div>
 </section>

notebooks/Customising the adaptive integrator.html

@@ -601,8 +601,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.51 s, sys: 74.9 ms, total: 5.58 s
-Wall time: 5.58 s
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 5.01 s, sys: 70.1 ms, total: 5.08 s
+Wall time: 5.07 s
 </pre></div>
 </div>
 </div>
@@ -617,8 +617,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 192 ms, sys: 33 µs, total: 192 ms
-Wall time: 191 ms
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>CPU times: user 183 ms, sys: 412 µs, total: 184 ms
+Wall time: 183 ms
 </pre></div>
 </div>
 </div>

notebooks/NeuralHamiltonianODEs.html

@@ -601,10 +601,10 @@ <h1>Neural Hamiltonian ODEs<a class="headerlink" href="#neural-hamiltonian-odes"
 </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.lines.Line2D at 0x7f7d4e4168c0&gt;]
+<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>[&lt;matplotlib.lines.Line2D at 0x7f8baf672950&gt;]
 </pre></div>
 </div>
-<img alt="../_images/6efcc58bc7714d77b6db17e6ae89ae9809edb2feef7fde3fcc46f2be85ef82a3.png" src="../_images/6efcc58bc7714d77b6db17e6ae89ae9809edb2feef7fde3fcc46f2be85ef82a3.png" />
+<img alt="../_images/74dec9b92c49e3b3398b121c9eaf8791e292e861b102c54b16339e680a4eda95.png" src="../_images/74dec9b92c49e3b3398b121c9eaf8791e292e861b102c54b16339e680a4eda95.png" />
 </div>
 </div>
 <p>Clearly, the power and interest of this technique, applied to Hamiltonian systems, lies in the possibility to define some good training for the FFNN weights and biases so that the final system converges to something useful</p>

notebooks/NeuralODEs.html

@@ -659,7 +659,7 @@ <h3>Taylor Integrator<a class="headerlink" href="#taylor-integrator" title="Perm
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 0.5606160163879395 seconds --- to build (jit) the Taylor integrator
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 0.4279334545135498 seconds --- to build (jit) the Taylor integrator
 </pre></div>
 </div>
 </div>
@@ -700,7 +700,7 @@ <h3>Taylor Integrator<a class="headerlink" href="#taylor-integrator" title="Perm
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 0.00020503997802734375 seconds --- to propagate using the Taylor scheme
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 0.00024175643920898438 seconds --- to propagate using the Taylor scheme
 </pre></div>
 </div>
 </div>
@@ -719,7 +719,7 @@ <h3>Taylor Integrator<a class="headerlink" href="#taylor-integrator" title="Perm
 </div>
 </div>
 <div class="cell_output docutils container">
-<img alt="../_images/9e49248c2d207ca2cf0e0022aa98c13053fa9743e742c5b01cf8bde628cf0b25.png" src="../_images/9e49248c2d207ca2cf0e0022aa98c13053fa9743e742c5b01cf8bde628cf0b25.png" />
+<img alt="../_images/8700c903600cfc193e178baa28653b7fabb5fb0cf3a232a0a6acf194814d7fc1.png" src="../_images/8700c903600cfc193e178baa28653b7fabb5fb0cf3a232a0a6acf194814d7fc1.png" />
 </div>
 </div>
 </section>
@@ -758,7 +758,7 @@ <h3>Scipy Counterpart<a class="headerlink" href="#scipy-counterpart" title="Perm
 </div>
 </div>
 <div class="cell_output docutils container">
-<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 0.0015060901641845703 seconds --- to propagate
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 0.0012469291687011719 seconds --- to propagate
 </pre></div>
 </div>
 </div>
@@ -773,7 +773,7 @@ <h3>Scipy Counterpart<a class="headerlink" href="#scipy-counterpart" title="Perm
 </div>
 </div>
 <div class="cell_output docutils container">
-<img alt="../_images/d8c39aec0f572261a9a940017c22201d35c7b30fa4f3a013b6fd350a80acd38c.png" src="../_images/d8c39aec0f572261a9a940017c22201d35c7b30fa4f3a013b6fd350a80acd38c.png" />
+<img alt="../_images/315c29e49ecbe09b6da02fa01caefcda899bc2d93eb68143b6edfaee785890ad.png" src="../_images/315c29e49ecbe09b6da02fa01caefcda899bc2d93eb68143b6edfaee785890ad.png" />
 </div>
 </div>
 <p>We see a net advantage in timings using the Taylor integration scheme. Note we are here not using batch propagation, which would add an additional 2-4 factor speedup in performances.</p>

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

@@ -1064,9 +1064,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_8055/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_8065/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_8055/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_8065/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>
@@ -1108,7 +1108,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_8055/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_8065/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

@@ -700,7 +700,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>--- 14.616575002670288 seconds --- to build the Taylor integrator
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 10.396462678909302 seconds --- to build the Taylor integrator
 </pre></div>
 </div>
 </div>
@@ -731,7 +731,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.049108028411865234 seconds --- to propagate
+<div class="output stream highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>--- 0.04820895195007324 seconds --- to propagate
 </pre></div>
 </div>
 </div>
@@ -789,7 +789,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 0x7f3fb1e42980&gt;
+<div class="output text_plain highlight-myst-ansi notranslate"><div class="highlight"><pre><span></span>&lt;matplotlib.collections.PathCollection at 0x7f260ea8eb30&gt;
 </pre></div>
 </div>
 <img alt="../_images/de0d9b784e67d433c81e1c6d68b5b937452559993089914853f0e1f45dbc1669.png" src="../_images/de0d9b784e67d433c81e1c6d68b5b937452559993089914853f0e1f45dbc1669.png" />

notebooks/ensemble_mode.html

@@ -601,11 +601,11 @@ <h2>A simple example<a class="headerlink" href="#a-simple-example" title="Permal
  Taylor order            : 20
  Dimension               : 2
  Time                    : 20
- State                   : [0.039696638417868337, 0.05841228959927792],
+ State                   : [0.04686299719362717, 0.06182433934285067],
  &lt;taylor_outcome.time_limit: -4294967299&gt;,
- 0.20793283495984896,
- 0.22091997547606892,
- 94,
+ 0.20187502011109634,
+ 0.21827916068353387,
+ 97,
  None)
 </pre></div>
 </div>
@@ -656,7 +656,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/2f56128cca1c592d9ce01add8ed0836d1d52392901a3636ed7e57658f8577528.png" src="../_images/2f56128cca1c592d9ce01add8ed0836d1d52392901a3636ed7e57658f8577528.png" />
+<img alt="../_images/c6e543557f8c8b78735bd88167927437e8bfdd1a0a55a4e346c72f10cf80b565.png" src="../_images/c6e543557f8c8b78735bd88167927437e8bfdd1a0a55a4e346c72f10cf80b565.png" />
 </div>
 </div>
 </section>