dynamic_engine_diagnostics.h File Reference

Diagnostics utilities for DynamicEngine instances. More...

#include "gridfire/engine/engine_abstract.h"
#include <vector>
#include <string>
#include "nlohmann/json.hpp"

Include dependency graph for dynamic_engine_diagnostics.h:

This graph shows which files directly or indirectly include this file:

Namespaces
namespace	gridfire
namespace	gridfire::engine
namespace	gridfire::engine::diagnostics

Functions
std::optional< nlohmann::json >	gridfire::engine::diagnostics::report_limiting_species (const DynamicEngine &engine, const std::vector< double > &Y_full, const std::vector< double > &E_full, double relTol, double absTol, size_t top_n=10, bool json=false)
	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.
std::optional< nlohmann::json >	gridfire::engine::diagnostics::inspect_species_balance (const DynamicEngine &engine, const std::string &species_name, const fourdst::composition::Composition &comp, double T9, double rho, bool json)
	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.
std::optional< nlohmann::json >	gridfire::engine::diagnostics::inspect_jacobian_stiffness (const DynamicEngine &engine, const fourdst::composition::Composition &comp, double T9, double rho, bool json)
	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.
void	gridfire::engine::diagnostics::save_jacobian_to_file (const NetworkJacobian &jacobian, const std::string &filename)
	Save the Jacobian matrix to a file for external analysis.

Detailed Description

Diagnostics utilities for DynamicEngine instances.

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.

Functions

• report_limiting_species: Identifies species that are limiting the accuracy of the integration based on specified tolerances.
• inspect_species_balance: Analyzes the production and destruction rates of a specified species to identify imbalances.
• inspect_jacobian_stiffness: Evaluates the stiffness of the Jacobian matrix to identify potential numerical issues.
• save_jacobian_to_file: Saves the Jacobian matrix to a file for external analysis.

Note

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 json parameter is set then the output will be formatted as JSON; otherwise, it will be printed to standard output and std::nullopt will be returned.