rebuilt html docs for version 2.8.0-dev0 from branch develop with sph…

…inx at d8b12ab

2.8.0-dev0/examples/constructing_universe.html

@@ -717,7 +717,7 @@ <h2>Adding a new segment<a class="headerlink" href="#Adding-a-new-segment" title
 <li><p>NMP: residues 30-59 (blue)</p></li>
 <li><p>LID: residues 122-159 (yellow)</p></li>
 </ul>
-<p><img alt="4bd9191607774db5abefbc0ba7eecd1a" src="https://github.com/MDAnalysis/MDAnalysisTutorial/blob/master/doc/sphinx/figs/angle_defs.png?raw=true" /></p>
+<p><img alt="3b6b2cc4a2a741fca976eeb250ca1c56" src="https://github.com/MDAnalysis/MDAnalysisTutorial/blob/master/doc/sphinx/figs/angle_defs.png?raw=true" /></p>
 <div class="nbinput docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[26]:
 </pre></div>

2.8.0-dev0/formats/auxiliary.html

@@ -263,7 +263,7 @@ <h2>Reading data directly<a class="headerlink" href="#reading-data-directly" tit
 <span class="gp">In [3]: </span><span class="n">aux</span> <span class="o">=</span> <span class="n">mda</span><span class="o">.</span><span class="n">auxiliary</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">auxreader</span><span class="p">(</span><span class="n">XVG_BZ2</span><span class="p">)</span>
 
 <span class="gp">In [4]: </span><span class="n">aux</span>
-<span class="gh">Out[4]: </span><span class="go">&lt;MDAnalysis.auxiliary.XVG.XVGReader at 0x7fcf18a013a0&gt;</span>
+<span class="gh">Out[4]: </span><span class="go">&lt;MDAnalysis.auxiliary.XVG.XVGReader at 0x7f2a8b7a4e20&gt;</span>
 </pre></div>
 </div>
 <p>In stand-alone use, an auxiliary reader allows you to iterate over each step in a set of auxiliary data.</p>
@@ -462,7 +462,7 @@ <h2>Recreating auxiliaries<a class="headerlink" href="#recreating-auxiliaries" t
 <span class="gp">In [30]: </span><span class="k">del</span> <span class="n">aux</span>
 
 <span class="gp">In [31]: </span><span class="n">mda</span><span class="o">.</span><span class="n">auxiliary</span><span class="o">.</span><span class="n">core</span><span class="o">.</span><span class="n">auxreader</span><span class="p">(</span><span class="o">**</span><span class="n">description</span><span class="p">)</span>
-<span class="gh">Out[31]: </span><span class="go">&lt;MDAnalysis.auxiliary.XVG.XVGReader at 0x7fcf0bf7d4f0&gt;</span>
+<span class="gh">Out[31]: </span><span class="go">&lt;MDAnalysis.auxiliary.XVG.XVGReader at 0x7f2a8bf9ea60&gt;</span>
 </pre></div>
 </div>
 <p>The ‘description’ of any or all the auxiliaries added to a trajectory can be
@@ -577,7 +577,7 @@ <h2>Standalone Usage<a class="headerlink" href="#standalone-usage" title="Link t
 <div class="highlight-ipython notranslate"><div class="highlight"><pre><span></span><span class="gp">In [45]: </span><span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
 
 <span class="gp">In [46]: </span><span class="n">plt</span><span class="o">.</span><span class="n">plot</span><span class="p">(</span><span class="n">temp</span><span class="p">[</span><span class="s2">&quot;Time&quot;</span><span class="p">],</span> <span class="n">temp</span><span class="p">[</span><span class="s2">&quot;Temperature&quot;</span><span class="p">])</span>
-<span class="gh">Out[46]: </span><span class="go">[&lt;matplotlib.lines.Line2D at 0x7fcf0baffdf0&gt;]</span>
+<span class="gh">Out[46]: </span><span class="go">[&lt;matplotlib.lines.Line2D at 0x7f2a98b12880&gt;]</span>
 
 <span class="gp">In [47]: </span><span class="n">plt</span><span class="o">.</span><span class="n">ylabel</span><span class="p">(</span><span class="s2">&quot;Temperature [K]&quot;</span><span class="p">)</span>
 <span class="gh">Out[47]: </span><span class="go">Text(0, 0.5, &#39;Temperature [K]&#39;)</span>

2.8.0-dev0/index.html

@@ -192,7 +192,7 @@
   <section id="welcome-to-mdanalysis-user-guide-s-documentation">
 <h1>Welcome to MDAnalysis User Guide’s documentation!<a class="headerlink" href="#welcome-to-mdanalysis-user-guide-s-documentation" title="Link to this heading"></a></h1>
 <p><strong>MDAnalysis version:</strong> 2.8.0-dev0</p>
-<p><strong>Last updated:</strong> Jan 15, 2024</p>
+<p><strong>Last updated:</strong> Jan 16, 2024</p>
 <p><strong>MDAnalysis</strong> (<a class="reference external" href="https://www.mdanalysis.org">www.mdanalysis.org</a>) is a Python
 toolkit to analyse molecular dynamics files and trajectories in <a class="reference internal" href="formats/index.html#formats"><span class="std std-ref">many popular formats</span></a>. MDAnalysis can write
 most of these formats, too, together with atom selections for use in <a class="reference internal" href="formats/selection_exporters.html#selection-exporters"><span class="std std-ref">visualisation tools or other analysis programs</span></a>.

2.8.0-dev0/reading_and_writing.html

@@ -322,27 +322,27 @@ <h4>Building trajectories in memory<a class="headerlink" href="#building-traject
 
 <span class="gp">In [16]: </span><span class="n">universe</span><span class="o">.</span><span class="n">atoms</span><span class="o">.</span><span class="n">positions</span>
 <span class="gh">Out[16]: </span>
-<span class="go">array([[0.16334425, 0.35365617, 0.3041469 ],</span>
-<span class="go">       [0.23549876, 0.79972136, 0.9351121 ],</span>
-<span class="go">       [0.3551765 , 0.01570895, 0.897949  ],</span>
+<span class="go">array([[0.69863194, 0.7931903 , 0.26419258],</span>
+<span class="go">       [0.23055398, 0.8485887 , 0.11530653],</span>
+<span class="go">       [0.94495815, 0.8734189 , 0.21584748],</span>
 <span class="go">       ...,</span>
-<span class="go">       [0.29806215, 0.8027643 , 0.47449347],</span>
-<span class="go">       [0.6593098 , 0.26233506, 0.55839175],</span>
-<span class="go">       [0.74026114, 0.76931435, 0.49984944]], dtype=float32)</span>
+<span class="go">       [0.1981499 , 0.09389573, 0.5227543 ],</span>
+<span class="go">       [0.3713325 , 0.15770493, 0.35249415],</span>
+<span class="go">       [0.9173709 , 0.23113845, 0.9348365 ]], dtype=float32)</span>
 </pre></div>
 </div>
 <p>or they can be directly passed in when creating a Universe.</p>
 <div class="highlight-ipython notranslate"><div class="highlight"><pre><span></span><span class="gp">In [17]: </span><span class="n">universe2</span> <span class="o">=</span> <span class="n">mda</span><span class="o">.</span><span class="n">Universe</span><span class="p">(</span><span class="n">PDB</span><span class="p">,</span> <span class="n">coordinates</span><span class="p">,</span> <span class="nb">format</span><span class="o">=</span><span class="n">MemoryReader</span><span class="p">)</span>
 
 <span class="gp">In [18]: </span><span class="n">universe2</span><span class="o">.</span><span class="n">atoms</span><span class="o">.</span><span class="n">positions</span>
 <span class="gh">Out[18]: </span>
-<span class="go">array([[0.16334425, 0.35365617, 0.3041469 ],</span>
-<span class="go">       [0.23549876, 0.79972136, 0.9351121 ],</span>
-<span class="go">       [0.3551765 , 0.01570895, 0.897949  ],</span>
+<span class="go">array([[0.69863194, 0.7931903 , 0.26419258],</span>
+<span class="go">       [0.23055398, 0.8485887 , 0.11530653],</span>
+<span class="go">       [0.94495815, 0.8734189 , 0.21584748],</span>
 <span class="go">       ...,</span>
-<span class="go">       [0.29806215, 0.8027643 , 0.47449347],</span>
-<span class="go">       [0.6593098 , 0.26233506, 0.55839175],</span>
-<span class="go">       [0.74026114, 0.76931435, 0.49984944]], dtype=float32)</span>
+<span class="go">       [0.1981499 , 0.09389573, 0.5227543 ],</span>
+<span class="go">       [0.3713325 , 0.15770493, 0.35249415],</span>
+<span class="go">       [0.9173709 , 0.23113845, 0.9348365 ]], dtype=float32)</span>
 </pre></div>
 </div>
 </section>

2.8.0-dev0/standard_selections.html

@@ -334,10 +334,10 @@ <h3>Protein backbone<a class="headerlink" href="#protein-backbone" title="Link t
 <p>Protein backbone atoms in MDAnalysis belong to a recognised protein residue and have the atom names:</p>
 <table class="docutils align-default">
 <tbody>
-<tr class="row-odd"><td><p>C</p></td>
-<td><p>CA</p></td>
-<td><p>O</p></td>
+<tr class="row-odd"><td><p>O</p></td>
 <td><p>N</p></td>
+<td><p>CA</p></td>
+<td><p>C</p></td>
 </tr>
 </tbody>
 </table>
@@ -349,44 +349,44 @@ <h3>Protein backbone<a class="headerlink" href="#protein-backbone" title="Link t
 <p>The below names are drawn from largely from the CHARMM force field.</p>
 <table class="docutils align-default">
 <tbody>
-<tr class="row-odd"><td><p>DT</p></td>
-<td><p>RG</p></td>
-<td><p>DC3</p></td>
-<td><p>T</p></td>
-<td><p>RA</p></td>
-<td><p>RC5</p></td>
+<tr class="row-odd"><td><p>DG</p></td>
+<td><p>DA3</p></td>
+<td><p>CYT</p></td>
 <td><p>GUA</p></td>
-<td><p>DG5</p></td>
-</tr>
-<tr class="row-even"><td><p>G</p></td>
-<td><p>ADE</p></td>
-<td><p>C</p></td>
 <td><p>DT5</p></td>
-<td><p>THY</p></td>
-<td><p>DT3</p></td>
-<td><p>URA</p></td>
-<td><p>A</p></td>
-</tr>
-<tr class="row-odd"><td><p>DA</p></td>
-<td><p>RU5</p></td>
-<td><p>DA3</p></td>
-<td><p>RU3</p></td>
-<td><p>U</p></td>
+<td><p>DA</p></td>
 <td><p>RA3</p></td>
-<td><p>DC5</p></td>
-<td><p>DG</p></td>
+<td><p>U</p></td>
 </tr>
-<tr class="row-even"><td><p>DA5</p></td>
+<tr class="row-even"><td><p>RA5</p></td>
+<td><p>A</p></td>
+<td><p>DC</p></td>
+<td><p>RG3</p></td>
+<td><p>DC3</p></td>
+<td><p>C</p></td>
+<td><p>RC</p></td>
+<td><p>DT</p></td>
+</tr>
+<tr class="row-odd"><td><p>DG5</p></td>
+<td><p>RC3</p></td>
+<td><p>DA5</p></td>
 <td><p>RG5</p></td>
-<td><p>CYT</p></td>
+<td><p>RA</p></td>
 <td><p>RU</p></td>
-<td><p>RC3</p></td>
-<td><p>DC</p></td>
+<td><p>RC5</p></td>
+<td><p>RU3</p></td>
+</tr>
+<tr class="row-even"><td><p>T</p></td>
+<td><p>RU5</p></td>
+<td><p>URA</p></td>
 <td><p>DG3</p></td>
-<td><p>RC</p></td>
+<td><p>DT3</p></td>
+<td><p>ADE</p></td>
+<td><p>DC5</p></td>
+<td><p>RG</p></td>
 </tr>
-<tr class="row-odd"><td><p>RG3</p></td>
-<td><p>RA5</p></td>
+<tr class="row-odd"><td><p>G</p></td>
+<td><p>THY</p></td>
 <td></td>
 <td></td>
 <td></td>
@@ -401,11 +401,11 @@ <h3>Nucleic backbone<a class="headerlink" href="#nucleic-backbone" title="Link t
 <p>Nucleic backbone atoms in MDAnalysis belong to a recognised nucleic acid residue and have the atom names:</p>
 <table class="docutils align-default">
 <tbody>
-<tr class="row-odd"><td><p>P</p></td>
+<tr class="row-odd"><td><p>C3’</p></td>
 <td><p>C5’</p></td>
+<td><p>P</p></td>
 <td><p>O3’</p></td>
 <td><p>O5’</p></td>
-<td><p>C3’</p></td>
 </tr>
 </tbody>
 </table>
@@ -415,22 +415,22 @@ <h3>Nucleic backbone<a class="headerlink" href="#nucleic-backbone" title="Link t
 <p>Nucleobase atoms from nucleic acid residues are recognised based on their names in CHARMM.</p>
 <table class="docutils align-default">
 <tbody>
-<tr class="row-odd"><td><p>C5</p></td>
-<td><p>C5M</p></td>
-<td><p>N6</p></td>
+<tr class="row-odd"><td><p>O2</p></td>
+<td><p>N4</p></td>
 <td><p>C2</p></td>
+<td><p>C5M</p></td>
+<td><p>O6</p></td>
 <td><p>N2</p></td>
-<td><p>C6</p></td>
+<td><p>N6</p></td>
 <td><p>N1</p></td>
-<td><p>N7</p></td>
 </tr>
-<tr class="row-even"><td><p>O2</p></td>
+<tr class="row-even"><td><p>C6</p></td>
 <td><p>C4</p></td>
-<td><p>O6</p></td>
+<td><p>C8</p></td>
+<td><p>N7</p></td>
+<td><p>C5</p></td>
 <td><p>O4</p></td>
-<td><p>N4</p></td>
 <td><p>N9</p></td>
-<td><p>C8</p></td>
 <td><p>N3</p></td>
 </tr>
 </tbody>
@@ -441,11 +441,11 @@ <h3>Nucleic sugars<a class="headerlink" href="#nucleic-sugars" title="Link to th
 <p>Nucleic sugar atoms from nucleic acid residues are recognised by MDAnalysis if they have the atom names:</p>
 <table class="docutils align-default">
 <tbody>
-<tr class="row-odd"><td><p>O4’</p></td>
+<tr class="row-odd"><td><p>C2’</p></td>
+<td><p>C3’</p></td>
+<td><p>O4’</p></td>
 <td><p>C4’</p></td>
-<td><p>C2’</p></td>
 <td><p>C1’</p></td>
-<td><p>C3’</p></td>
 </tr>
 </tbody>
 </table>

2.8.0-dev0/testing.html

@@ -435,13 +435,13 @@ <h4>Testing exceptions and warnings<a class="headerlink" href="#testing-exceptio
 </section>
 <section id="failing-tests">
 <h4>Failing tests<a class="headerlink" href="#failing-tests" title="Link to this heading"></a></h4>
-<p>To mark an expected failure, use <a class="reference external" href="https://docs.pytest.org/en/latest/reference/reference.html#pytest.mark.xfail" title="(in pytest v8.1.0.dev65+g9af6d46)"><code class="xref py py-func docutils literal notranslate"><span class="pre">pytest.mark.xfail()</span></code></a> decorator:</p>
+<p>To mark an expected failure, use <a class="reference external" href="https://docs.pytest.org/en/latest/reference/reference.html#pytest.mark.xfail" title="(in pytest v8.1.0.dev66+g348e6de)"><code class="xref py py-func docutils literal notranslate"><span class="pre">pytest.mark.xfail()</span></code></a> decorator:</p>
 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="nd">@pytest</span><span class="o">.</span><span class="n">mark</span><span class="o">.</span><span class="n">xfail</span>
 <span class="k">def</span> <span class="nf">tested_expected_failure</span><span class="p">():</span>
     <span class="k">assert</span> <span class="mi">1</span> <span class="o">==</span> <span class="mi">2</span>
 </pre></div>
 </div>
-<p>To manually fail a test, make a call to <a class="reference external" href="https://docs.pytest.org/en/latest/reference/reference.html#pytest.fail" title="(in pytest v8.1.0.dev65+g9af6d46)"><code class="xref py py-func docutils literal notranslate"><span class="pre">pytest.fail()</span></code></a>:</p>
+<p>To manually fail a test, make a call to <a class="reference external" href="https://docs.pytest.org/en/latest/reference/reference.html#pytest.fail" title="(in pytest v8.1.0.dev66+g348e6de)"><code class="xref py py-func docutils literal notranslate"><span class="pre">pytest.fail()</span></code></a>:</p>
 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">test_open</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">tmpdir</span><span class="p">):</span>
     <span class="n">outfile</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">tmpdir</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="s1">&#39;lammps-writer-test.dcd&#39;</span><span class="p">))</span>
     <span class="k">try</span><span class="p">:</span>
@@ -454,7 +454,7 @@ <h4>Failing tests<a class="headerlink" href="#failing-tests" title="Link to this
 </section>
 <section id="skipping-tests">
 <h4>Skipping tests<a class="headerlink" href="#skipping-tests" title="Link to this heading"></a></h4>
-<p>To skip tests based on a condition, use <a class="reference external" href="https://docs.pytest.org/en/latest/reference/reference.html#pytest.mark.skipif" title="(in pytest v8.1.0.dev65+g9af6d46)"><code class="xref py py-func docutils literal notranslate"><span class="pre">pytest.mark.skipif(condition)</span></code></a> decorator:</p>
+<p>To skip tests based on a condition, use <a class="reference external" href="https://docs.pytest.org/en/latest/reference/reference.html#pytest.mark.skipif" title="(in pytest v8.1.0.dev66+g348e6de)"><code class="xref py py-func docutils literal notranslate"><span class="pre">pytest.mark.skipif(condition)</span></code></a> decorator:</p>
 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
 <span class="k">try</span><span class="p">:</span>
     <span class="kn">from</span> <span class="nn">numpy</span> <span class="kn">import</span> <span class="n">shares_memory</span>
@@ -469,7 +469,7 @@ <h4>Skipping tests<a class="headerlink" href="#skipping-tests" title="Link to th
     <span class="k">assert</span> <span class="ow">not</span> <span class="n">np</span><span class="o">.</span><span class="n">shares_memory</span><span class="p">(</span><span class="n">original</span><span class="o">.</span><span class="n">ts</span><span class="o">.</span><span class="n">positions</span><span class="p">,</span> <span class="n">copy</span><span class="o">.</span><span class="n">ts</span><span class="o">.</span><span class="n">positions</span><span class="p">)</span>
 </pre></div>
 </div>
-<p>To skip a test if a module is not available for importing, use <a class="reference external" href="https://docs.pytest.org/en/latest/reference/reference.html#pytest.importorskip" title="(in pytest v8.1.0.dev65+g9af6d46)"><code class="xref py py-func docutils literal notranslate"><span class="pre">pytest.importorskip('module_name')</span></code></a></p>
+<p>To skip a test if a module is not available for importing, use <a class="reference external" href="https://docs.pytest.org/en/latest/reference/reference.html#pytest.importorskip" title="(in pytest v8.1.0.dev66+g348e6de)"><code class="xref py py-func docutils literal notranslate"><span class="pre">pytest.importorskip('module_name')</span></code></a></p>
 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">test_write_trajectory_netCDF4</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">universe</span><span class="p">,</span> <span class="n">outfile</span><span class="p">):</span>
     <span class="n">pytest</span><span class="o">.</span><span class="n">importorskip</span><span class="p">(</span><span class="s2">&quot;netCDF4&quot;</span><span class="p">)</span>
     <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_test_write_trajectory</span><span class="p">(</span><span class="n">universe</span><span class="p">,</span> <span class="n">outfile</span><span class="p">)</span>
@@ -479,7 +479,7 @@ <h4>Skipping tests<a class="headerlink" href="#skipping-tests" title="Link to th
 </section>
 <section id="fixtures">
 <h3>Fixtures<a class="headerlink" href="#fixtures" title="Link to this heading"></a></h3>
-<p>Use <a class="reference external" href="https://docs.pytest.org/en/latest/fixture.html">fixtures</a> as much as possible to reuse “resources” between test methods/functions. Pytest fixtures are functions that run before each test function that uses that fixture. A fixture is typically set up with the <a class="reference external" href="https://docs.pytest.org/en/latest/reference/reference.html#pytest.fixture" title="(in pytest v8.1.0.dev65+g9af6d46)"><code class="xref py py-func docutils literal notranslate"><span class="pre">pytest.fixture()</span></code></a> decorator, over a function that returns the object you need:</p>
+<p>Use <a class="reference external" href="https://docs.pytest.org/en/latest/fixture.html">fixtures</a> as much as possible to reuse “resources” between test methods/functions. Pytest fixtures are functions that run before each test function that uses that fixture. A fixture is typically set up with the <a class="reference external" href="https://docs.pytest.org/en/latest/reference/reference.html#pytest.fixture" title="(in pytest v8.1.0.dev66+g348e6de)"><code class="xref py py-func docutils literal notranslate"><span class="pre">pytest.fixture()</span></code></a> decorator, over a function that returns the object you need:</p>
 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="nd">@pytest</span><span class="o">.</span><span class="n">fixture</span>
 <span class="k">def</span> <span class="nf">universe</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
     <span class="k">return</span> <span class="n">mda</span><span class="o">.</span><span class="n">Universe</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">ref_filename</span><span class="p">)</span>