docs(docs): rebuilt docs with loads more detail for triggers and weak reactions

This commit is contained in:
2025-10-08 11:17:09 -04:00
parent 8a0b5b2c36
commit 274c566726
600 changed files with 39207 additions and 9125 deletions

View File

@@ -117,9 +117,10 @@ Inheritance diagram for gridfire::screening::ScreeningModel:</div>
<div class="center">
<img src="classgridfire_1_1screening_1_1_screening_model.png" usemap="#gridfire::screening::ScreeningModel_map" alt=""/>
<map id="gridfire::screening::ScreeningModel_map" name="gridfire::screening::ScreeningModel_map">
<area href="class_py_screening.html" alt="PyScreening" shape="rect" coords="0,56,245,80"/>
<area href="classgridfire_1_1screening_1_1_bare_screening_model.html" title="A screening model that applies no screening effect." alt="gridfire::screening::BareScreeningModel" shape="rect" coords="255,56,500,80"/>
<area href="classgridfire_1_1screening_1_1_weak_screening_model.html" title="Implements the weak screening model based on the Debye-Hückel approximation." alt="gridfire::screening::WeakScreeningModel" shape="rect" coords="510,56,755,80"/>
<area href="class_py_screening.html" alt="PyScreening" shape="rect" coords="0,56,282,80"/>
<area href="classgridfire_1_1screening_1_1_bare_screening_model.html" title="A screening model that applies no screening effect." alt="gridfire::screening::BareScreeningModel" shape="rect" coords="292,56,574,80"/>
<area href="classgridfire_1_1screening_1_1_intermediate_screening_model.html" alt="gridfire::screening::IntermediateScreeningModel" shape="rect" coords="584,56,866,80"/>
<area href="classgridfire_1_1screening_1_1_weak_screening_model.html" title="Implements the weak screening model based on the Debye-Hückel approximation." alt="gridfire::screening::WeakScreeningModel" shape="rect" coords="876,56,1158,80"/>
</map>
</div></div>
<table class="memberdecls">
@@ -134,12 +135,12 @@ Public Member Functions</h2></td></tr>
<tr class="memitem:adef175acdbd911527f56a1f1592579a7" id="r_adef175acdbd911527f56a1f1592579a7"><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#adef175acdbd911527f56a1f1592579a7">~ScreeningModel</a> ()=default</td></tr>
<tr class="memdesc:adef175acdbd911527f56a1f1592579a7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Virtual destructor. <br /></td></tr>
<tr class="separator:adef175acdbd911527f56a1f1592579a7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aaec9184d80c86a2d8674e395dad81bde" id="r_aaec9184d80c86a2d8674e395dad81bde"><td class="memItemLeft" align="right" valign="top">virtual std::vector&lt; double &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#aaec9184d80c86a2d8674e395dad81bde">calculateScreeningFactors</a> (const <a class="el" href="namespacegridfire_1_1reaction.html#aa86f08712565f278adacc7cd2361eb31">reaction::LogicalReactionSet</a> &amp;reactions, const std::vector&lt; fourdst::atomic::Species &gt; &amp;species, const std::vector&lt; double &gt; &amp;Y, const double T9, const double rho) const =0</td></tr>
<tr class="memdesc:aaec9184d80c86a2d8674e395dad81bde"><td class="mdescLeft">&#160;</td><td class="mdescRight">Calculates screening factors for a set of reactions. <br /></td></tr>
<tr class="separator:aaec9184d80c86a2d8674e395dad81bde"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a6c381a823cb9c1680d3e9c846da4ae22" id="r_a6c381a823cb9c1680d3e9c846da4ae22"><td class="memItemLeft" align="right" valign="top">virtual std::vector&lt; <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a6c381a823cb9c1680d3e9c846da4ae22">calculateScreeningFactors</a> (const <a class="el" href="namespacegridfire_1_1reaction.html#aa86f08712565f278adacc7cd2361eb31">reaction::LogicalReactionSet</a> &amp;reactions, const std::vector&lt; fourdst::atomic::Species &gt; &amp;species, const std::vector&lt; <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a> &gt; &amp;Y, const <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a> T9, const <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a> rho) const =0</td></tr>
<tr class="memdesc:a6c381a823cb9c1680d3e9c846da4ae22"><td class="mdescLeft">&#160;</td><td class="mdescRight">Calculates screening factors using CppAD types for automatic differentiation. <br /></td></tr>
<tr class="separator:a6c381a823cb9c1680d3e9c846da4ae22"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab08c4490f9da18254a7c6f29be1f62ce" id="r_ab08c4490f9da18254a7c6f29be1f62ce"><td class="memItemLeft" align="right" valign="top">virtual std::vector&lt; double &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#ab08c4490f9da18254a7c6f29be1f62ce">calculateScreeningFactors</a> (const <a class="el" href="classgridfire_1_1reaction_1_1_reaction_set.html">reaction::ReactionSet</a> &amp;reactions, const std::vector&lt; fourdst::atomic::Species &gt; &amp;species, const std::vector&lt; double &gt; &amp;Y, double T9, double rho) const =0</td></tr>
<tr class="memdesc:ab08c4490f9da18254a7c6f29be1f62ce"><td class="mdescLeft">&#160;</td><td class="mdescRight">Calculates screening factors for a set of reactions. <br /></td></tr>
<tr class="separator:ab08c4490f9da18254a7c6f29be1f62ce"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a1da8242c7591ab32453d1e0109999d6c" id="r_a1da8242c7591ab32453d1e0109999d6c"><td class="memItemLeft" align="right" valign="top">virtual std::vector&lt; <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="#a1da8242c7591ab32453d1e0109999d6c">calculateScreeningFactors</a> (const <a class="el" href="classgridfire_1_1reaction_1_1_reaction_set.html">reaction::ReactionSet</a> &amp;reactions, const std::vector&lt; fourdst::atomic::Species &gt; &amp;species, const std::vector&lt; CppAD::AD&lt; double &gt; &gt; &amp;Y, <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a> T9, <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a> rho) const =0</td></tr>
<tr class="memdesc:a1da8242c7591ab32453d1e0109999d6c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Calculates screening factors using CppAD types for automatic differentiation. <br /></td></tr>
<tr class="separator:a1da8242c7591ab32453d1e0109999d6c"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>An abstract base class for plasma screening models. </p>
@@ -192,8 +193,8 @@ Public Member Functions</h2></td></tr>
</div>
</div>
<h2 class="groupheader">Member Function Documentation</h2>
<a id="a6c381a823cb9c1680d3e9c846da4ae22" name="a6c381a823cb9c1680d3e9c846da4ae22"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a6c381a823cb9c1680d3e9c846da4ae22">&#9670;&#160;</a></span>calculateScreeningFactors() <span class="overload">[1/2]</span></h2>
<a id="a1da8242c7591ab32453d1e0109999d6c" name="a1da8242c7591ab32453d1e0109999d6c"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a1da8242c7591ab32453d1e0109999d6c">&#9670;&#160;</a></span>calculateScreeningFactors() <span class="overload">[1/2]</span></h2>
<div class="memitem">
<div class="memproto">
@@ -204,7 +205,7 @@ Public Member Functions</h2></td></tr>
<tr>
<td class="memname">virtual std::vector&lt; <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a> &gt; gridfire::screening::ScreeningModel::calculateScreeningFactors </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="namespacegridfire_1_1reaction.html#aa86f08712565f278adacc7cd2361eb31">reaction::LogicalReactionSet</a> &amp;</td> <td class="paramname"><span class="paramname"><em>reactions</em></span>, </td>
<td class="paramtype">const <a class="el" href="classgridfire_1_1reaction_1_1_reaction_set.html">reaction::ReactionSet</a> &amp;</td> <td class="paramname"><span class="paramname"><em>reactions</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
@@ -214,22 +215,22 @@ Public Member Functions</h2></td></tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::vector&lt; <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a> &gt; &amp;</td> <td class="paramname"><span class="paramname"><em>Y</em></span>, </td>
<td class="paramtype">const std::vector&lt; CppAD::AD&lt; double &gt; &gt; &amp;</td> <td class="paramname"><span class="paramname"><em>Y</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a></td> <td class="paramname"><span class="paramname"><em>T9</em></span>, </td>
<td class="paramtype"><a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a></td> <td class="paramname"><span class="paramname"><em>T9</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a></td> <td class="paramname"><span class="paramname"><em>rho</em></span>&#160;) const</td>
<td class="paramtype"><a class="el" href="#a107ff2897f040d6f27f69d56a0bdd28d">ADDouble</a></td> <td class="paramname"><span class="paramname"><em>rho</em></span>&#160;) const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel pure-virtual">pure virtual</span></span> </td>
<span class="mlabels"><span class="mlabel nodiscard">nodiscard</span><span class="mlabel pure-virtual">pure virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
@@ -240,7 +241,7 @@ Public Member Functions</h2></td></tr>
<table class="params">
<tr><td class="paramname">reactions</td><td>The set of logical reactions in the network. </td></tr>
<tr><td class="paramname">species</td><td>A vector of all atomic species involved in the network. </td></tr>
<tr><td class="paramname">Y</td><td>A vector of the molar abundances (mol/g) for each species, as AD types. </td></tr>
<tr><td class="paramname">Y</td><td>The current composition, providing molar abundances (mol/g) for each species. </td></tr>
<tr><td class="paramname">T9</td><td>The temperature in units of 10^9 K, as an AD type. </td></tr>
<tr><td class="paramname">rho</td><td>The plasma density in g/cm^3, as an AD type. </td></tr>
</table>
@@ -249,12 +250,12 @@ Public Member Functions</h2></td></tr>
<dl class="section return"><dt>Returns</dt><dd>A vector of screening factors (dimensionless), as AD types.</dd></dl>
<p><b>Note</b> This method is essential for including the effects of screening in the Jacobian matrix of the reaction network. </p>
<p>Implemented in <a class="el" href="classgridfire_1_1screening_1_1_bare_screening_model.html#ac5647d633cd5bbd7cb5136b7fa4cad99">gridfire::screening::BareScreeningModel</a>, <a class="el" href="classgridfire_1_1screening_1_1_weak_screening_model.html#ac6bc78769670a460af1ff88284cb8ad4">gridfire::screening::WeakScreeningModel</a>, and <a class="el" href="class_py_screening.html#a5539d59311c778cf7f0006acc8f84ade">PyScreening</a>.</p>
<p>Implemented in <a class="el" href="classgridfire_1_1screening_1_1_bare_screening_model.html#a0ac3685a90c1e65a84e03cfb2fed29e5">gridfire::screening::BareScreeningModel</a>, <a class="el" href="classgridfire_1_1screening_1_1_intermediate_screening_model.html#a765e369256282f0f25e66e13c33dcbd9">gridfire::screening::IntermediateScreeningModel</a>, <a class="el" href="classgridfire_1_1screening_1_1_weak_screening_model.html#a8b0590814e7058b4ff3f0cd6f4124773">gridfire::screening::WeakScreeningModel</a>, and <a class="el" href="class_py_screening.html#a68a126de903e1a87a1d7d1cfec8add0f">PyScreening</a>.</p>
</div>
</div>
<a id="aaec9184d80c86a2d8674e395dad81bde" name="aaec9184d80c86a2d8674e395dad81bde"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aaec9184d80c86a2d8674e395dad81bde">&#9670;&#160;</a></span>calculateScreeningFactors() <span class="overload">[2/2]</span></h2>
<a id="ab08c4490f9da18254a7c6f29be1f62ce" name="ab08c4490f9da18254a7c6f29be1f62ce"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ab08c4490f9da18254a7c6f29be1f62ce">&#9670;&#160;</a></span>calculateScreeningFactors() <span class="overload">[2/2]</span></h2>
<div class="memitem">
<div class="memproto">
@@ -265,7 +266,7 @@ Public Member Functions</h2></td></tr>
<tr>
<td class="memname">virtual std::vector&lt; double &gt; gridfire::screening::ScreeningModel::calculateScreeningFactors </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="namespacegridfire_1_1reaction.html#aa86f08712565f278adacc7cd2361eb31">reaction::LogicalReactionSet</a> &amp;</td> <td class="paramname"><span class="paramname"><em>reactions</em></span>, </td>
<td class="paramtype">const <a class="el" href="classgridfire_1_1reaction_1_1_reaction_set.html">reaction::ReactionSet</a> &amp;</td> <td class="paramname"><span class="paramname"><em>reactions</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
@@ -280,17 +281,17 @@ Public Member Functions</h2></td></tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const double</td> <td class="paramname"><span class="paramname"><em>T9</em></span>, </td>
<td class="paramtype">double</td> <td class="paramname"><span class="paramname"><em>T9</em></span>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const double</td> <td class="paramname"><span class="paramname"><em>rho</em></span>&#160;) const</td>
<td class="paramtype">double</td> <td class="paramname"><span class="paramname"><em>rho</em></span>&#160;) const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel pure-virtual">pure virtual</span></span> </td>
<span class="mlabels"><span class="mlabel nodiscard">nodiscard</span><span class="mlabel pure-virtual">pure virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
@@ -301,7 +302,7 @@ Public Member Functions</h2></td></tr>
<table class="params">
<tr><td class="paramname">reactions</td><td>The set of logical reactions in the network. </td></tr>
<tr><td class="paramname">species</td><td>A vector of all atomic species involved in the network. </td></tr>
<tr><td class="paramname">Y</td><td>A vector of the molar abundances (mol/g) for each species. </td></tr>
<tr><td class="paramname">Y</td><td>The current composition, providing molar abundances (mol/g) for each species. </td></tr>
<tr><td class="paramname">T9</td><td>The temperature in units of 10^9 K. </td></tr>
<tr><td class="paramname">rho</td><td>The plasma density in g/cm^3. </td></tr>
</table>
@@ -325,7 +326,7 @@ Public Member Functions</h2></td></tr>
<div class="line"> <span class="comment">// ... use screening_factors[i] ...</span></div>
<div class="line">}</div>
</div><!-- fragment -->
<p>Implemented in <a class="el" href="classgridfire_1_1screening_1_1_bare_screening_model.html#ac35ad34c5da7e1b5087552aa5c83fe60">gridfire::screening::BareScreeningModel</a>, <a class="el" href="classgridfire_1_1screening_1_1_weak_screening_model.html#afbaeaefe6b3ab3ecf81889ddc1cff76c">gridfire::screening::WeakScreeningModel</a>, and <a class="el" href="class_py_screening.html#a2b8756c197eb89e77cb6dd231c979315">PyScreening</a>.</p>
<p>Implemented in <a class="el" href="classgridfire_1_1screening_1_1_bare_screening_model.html#ad252ce1de82401bab24747aabf0c8a3a">gridfire::screening::BareScreeningModel</a>, <a class="el" href="classgridfire_1_1screening_1_1_intermediate_screening_model.html#a86a218ce82306ed582296cbeb3de0250">gridfire::screening::IntermediateScreeningModel</a>, <a class="el" href="classgridfire_1_1screening_1_1_weak_screening_model.html#a6a215d082b0d05126fb2b19fd1983446">gridfire::screening::WeakScreeningModel</a>, and <a class="el" href="class_py_screening.html#aa67b5f0528006d9c742033b8c5ab3a05">PyScreening</a>.</p>
</div>
</div>