Include dependency graph for dynamic_engine_diagnostics.h:</div>
<divclass="dyncontent">
<divclass="center"><divclass="zoom"><iframescrolling="no"frameborder="0"src="dynamic__engine__diagnostics_8h__incl.svg"width="100%"height="600"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe></div></div>
<divclass="center"><divclass="zoom"><iframescrolling="no"frameborder="0"src="dynamic__engine__diagnostics_8h__dep__incl.svg"width="100%"height="549"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe></div></div>
<trclass="memdesc:ad792baf3c6720fce34a5161c0ade3fc4"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Report the species that are limiting the accuracy of the integration. This is useful for identifying species that may be limiting the timestepping due to their high relative errors compared to the specified tolerances. <br/></td></tr>
<trclass="memdesc:aac2570f6bc58b8825674f60f1634149b"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Inspect the production and destruction balance of a specific species in the reaction network. This function analyzes the reactions that create and destroy the specified species, providing insights into potential imbalances that may affect the accuracy of the simulation. <br/></td></tr>
<trclass="memdesc:a8a42702b787f12988ae8fc7e1e6d8186"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Inspect the stiffness of the Jacobian matrix for the reaction network at the given temperature and density. This function evaluates the diagonal and off-diagonal elements of the Jacobian to identify potential numerical issues related to stiffness. <br/></td></tr>
<trclass="memdesc:ab247fdf00c23cf857d9131a3462d41ae"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Save the Jacobian matrix to a file for external analysis. <br/></td></tr>
<divclass="textblock"><p>Diagnostics utilities for DynamicEngine instances. </p>
<p>These free functions provide diagnostic tools for analyzing and reporting on the behavior of DynamicEngine instances in GridFire. They include functions for identifying limiting species, inspecting species balance, and evaluating Jacobian stiffness. Generally these functions are expensive to call and should be avoided in performance-critical code paths or during large simulations. These are primarily intended for debugging and analysis during development.</p>
<h1><aclass="anchor"id="Functions"></a>
Functions</h1>
<ul>
<li>report_limiting_species: Identifies species that are limiting the accuracy of the integration based on specified tolerances.</li>
<li>inspect_species_balance: Analyzes the production and destruction rates of a specified species to identify imbalances.</li>
<li>inspect_jacobian_stiffness: Evaluates the stiffness of the Jacobian matrix to identify potential numerical issues.</li>
<li>save_jacobian_to_file: Saves the Jacobian matrix to a file for external analysis.</li>
</ul>
<dlclass="section note"><dt>Note</dt><dd>Each of these functions, aside from save_jacobian_to_file, may return results in JSON format for easy integration with other tools and workflows. If the <code>json</code> parameter is set then the output will be formatted as JSON; otherwise, it will be printed to standard output and <code>std::nullopt</code> will be returned. </dd></dl>
<liclass="footer">Generated by <ahref="https://www.doxygen.org/index.html"><imgclass="footer"src="doxygen.svg"width="104"height="31"alt="doxygen"/></a> 1.13.2 </li>
