An engine view that dynamically adapts the reaction network based on runtime conditions. More...

#include <engine_adaptive.h>

Inheritance diagram for gridfire::AdaptiveEngineView:

Classes
struct	ReactionFlow
	A struct to hold a reaction and its flow rate. More...

Public Member Functions
	AdaptiveEngineView (DynamicEngine &baseEngine)
	Constructs an AdaptiveEngineView.

void	update (const NetIn &netIn)
	Updates the active species and reactions based on the current conditions.

const std::vector< fourdst::atomic::Species > &	getNetworkSpecies () const override
	Gets the list of active species in the network.

StepDerivatives< double >	calculateRHSAndEnergy (const std::vector< double > &Y_culled, const double T9, const double rho) const override
	Calculates the right-hand side (dY/dt) and energy generation for the active species.

void	generateJacobianMatrix (const std::vector< double > &Y_culled, const double T9, const double rho) override
	Generates the Jacobian matrix for the active species.

double	getJacobianMatrixEntry (const int i_culled, const int j_culled) const override
	Gets an entry from the Jacobian matrix for the active species.

void	generateStoichiometryMatrix () override
	Generates the stoichiometry matrix for the active reactions and species.

int	getStoichiometryMatrixEntry (const int speciesIndex_culled, const int reactionIndex_culled) const override
	Gets an entry from the stoichiometry matrix for the active species and reactions.

double	calculateMolarReactionFlow (const reaction::Reaction &reaction, const std::vector< double > &Y_culled, double T9, double rho) const override
	Calculates the molar reaction flow for a given reaction in the active network.

const reaction::LogicalReactionSet &	getNetworkReactions () const override
	Gets the set of active logical reactions in the network.

std::unordered_map< fourdst::atomic::Species, double >	getSpeciesTimescales (const std::vector< double > &Y_culled, double T9, double rho) const override
	Computes timescales for all active species in the network.

const DynamicEngine &	getBaseEngine () const override
	Gets the base engine.

Public Member Functions inherited from gridfire::Engine
virtual	~Engine ()=default
	Virtual destructor.

Public Member Functions inherited from gridfire::EngineView< DynamicEngine >
virtual	~EngineView ()=default
	Virtual destructor.

Private Types
using	Config = fourdst::config::Config

using	LogManager = fourdst::logging::LogManager

Private Member Functions
std::vector< size_t >	constructSpeciesIndexMap () const
	Constructs the species index map.

std::vector< size_t >	constructReactionIndexMap () const
	Constructs the reaction index map.

std::vector< double >	mapCulledToFull (const std::vector< double > &culled) const
	Maps a vector of culled abundances to a vector of full abundances.

std::vector< double >	mapFullToCulled (const std::vector< double > &full) const
	Maps a vector of full abundances to a vector of culled abundances.

size_t	mapCulledToFullSpeciesIndex (size_t culledSpeciesIndex) const
	Maps a culled species index to a full species index.

size_t	mapCulledToFullReactionIndex (size_t culledReactionIndex) const
	Maps a culled reaction index to a full reaction index.

void	validateState () const
	Validates that the AdaptiveEngineView is not stale.

Private Attributes
Config &	m_config = Config::getInstance()

quill::Logger *	m_logger = LogManager::getInstance().getLogger("log")

DynamicEngine &	m_baseEngine

std::vector< fourdst::atomic::Species >	m_activeSpecies

reaction::LogicalReactionSet	m_activeReactions

std::vector< size_t >	m_speciesIndexMap

std::vector< size_t >	m_reactionIndexMap

bool	m_isStale = true

Detailed Description

An engine view that dynamically adapts the reaction network based on runtime conditions.

This class implements an EngineView that dynamically culls species and reactions from the full reaction network based on their reaction flow rates and connectivity. This allows for efficient simulation of reaction networks by focusing computational effort on the most important species and reactions.

The AdaptiveEngineView maintains a subset of "active" species and reactions, and maps between the full network indices and the active subset indices. This allows the base engine to operate on the full network data, while the AdaptiveEngineView provides a reduced view for external clients.

The adaptation process is driven by the update() method, which performs the following steps:

Reaction Flow Calculation: Calculates the molar reaction flow rate for each reaction in the full network based on the current temperature, density, and composition.
Reaction Culling: Culls reactions with flow rates below a threshold, determined by a relative culling threshold multiplied by the maximum flow rate.
Connectivity Analysis: Performs a connectivity analysis to identify species that are reachable from the initial fuel species through the culled reaction network.
Species Culling: Culls species that are not reachable from the initial fuel.
Index Map Construction: Constructs index maps to map between the full network indices and the active subset indices for species and reactions.

See also: engine_abstract.h; engine_view_abstract.h; AdaptiveEngineView::update()

Definition at line 45 of file engine_adaptive.h.

Member Typedef Documentation

◆ Config

using gridfire::AdaptiveEngineView::Config = fourdst::config::Config

private

Definition at line 226 of file engine_adaptive.h.

◆ LogManager

using gridfire::AdaptiveEngineView::LogManager = fourdst::logging::LogManager

private

Definition at line 227 of file engine_adaptive.h.

Constructor & Destructor Documentation

◆ AdaptiveEngineView()

gridfire::AdaptiveEngineView::AdaptiveEngineView ( DynamicEngine & baseEngine )

explicit

Constructs an AdaptiveEngineView.

Parameters

baseEngine The underlying DynamicEngine to which this view delegates calculations.

Initializes the active species and reactions to the full network, and constructs the initial index maps.

Definition at line 13 of file engine_adaptive.cpp.

Member Function Documentation

◆ calculateMolarReactionFlow()

double gridfire::AdaptiveEngineView::calculateMolarReactionFlow	(	const reaction::Reaction &	reaction,
		const std::vector< double > &	Y_culled,
		double	T9,
		double	rho ) const

overridevirtual

Calculates the molar reaction flow for a given reaction in the active network.

Parameters

reaction	The reaction for which to calculate the flow.
Y_culled	Vector of current abundances for the active species.
T9	Temperature in units of 10^9 K.
rho	Density in g/cm^3.

Returns: Molar flow rate for the reaction (e.g., mol/g/s).

This method maps the culled abundances to the full network abundances and calls the base engine to calculate the molar reaction flow.

Exceptions

std::runtime_error	If the AdaptiveEngineView is stale (i.e., `update()` has not been called).
std::runtime_error	If the reaction is not part of the active reactions in the adaptive engine view.

Implements gridfire::DynamicEngine.

Definition at line 278 of file engine_adaptive.cpp.

◆ calculateRHSAndEnergy()

StepDerivatives< double > gridfire::AdaptiveEngineView::calculateRHSAndEnergy	(	const std::vector< double > &	Y_culled,
		const double	T9,
		const double	rho ) const

overridevirtual

Calculates the right-hand side (dY/dt) and energy generation for the active species.

Parameters

Y_culled	A vector of abundances for the active species.
T9	The temperature in units of 10^9 K.
rho	The density in g/cm^3.

Returns: A StepDerivatives struct containing the derivatives of the active species and the nuclear energy generation rate.

This method maps the culled abundances to the full network abundances, calls the base engine to calculate the RHS and energy generation, and then maps the full network derivatives back to the culled derivatives.

Exceptions

std::runtime_error If the AdaptiveEngineView is stale (i.e., update() has not been called).

See also: AdaptiveEngineView::update()

Implements gridfire::Engine.

Definition at line 223 of file engine_adaptive.cpp.

◆ constructReactionIndexMap()

std::vector< size_t > gridfire::AdaptiveEngineView::constructReactionIndexMap ( ) const

private

Constructs the reaction index map.

Returns: A vector mapping culled reaction indices to full reaction indices.

This method creates a map from the indices of the active reactions to the indices of the corresponding reactions in the full network.

See also: AdaptiveEngineView::update()

Definition at line 53 of file engine_adaptive.cpp.

◆ constructSpeciesIndexMap()

std::vector< size_t > gridfire::AdaptiveEngineView::constructSpeciesIndexMap ( ) const

private

Constructs the species index map.

Returns: A vector mapping culled species indices to full species indices.

This method creates a map from the indices of the active species to the indices of the corresponding species in the full network.

See also: AdaptiveEngineView::update()

Definition at line 24 of file engine_adaptive.cpp.

◆ generateJacobianMatrix()

void gridfire::AdaptiveEngineView::generateJacobianMatrix	(	const std::vector< double > &	Y_culled,
		const double	T9,
		const double	rho )

overridevirtual

Generates the Jacobian matrix for the active species.

Parameters

Y_culled	A vector of abundances for the active species.
T9	The temperature in units of 10^9 K.
rho	The density in g/cm^3.

This method maps the culled abundances to the full network abundances and calls the base engine to generate the Jacobian matrix.

Exceptions

std::runtime_error If the AdaptiveEngineView is stale (i.e., update() has not been called).

See also: AdaptiveEngineView::update()

Implements gridfire::DynamicEngine.

Definition at line 241 of file engine_adaptive.cpp.

◆ generateStoichiometryMatrix()

void gridfire::AdaptiveEngineView::generateStoichiometryMatrix ( )

overridevirtual

Generates the stoichiometry matrix for the active reactions and species.

This method calls the base engine to generate the stoichiometry matrix.

Exceptions

std::runtime_error If the AdaptiveEngineView is stale (i.e., update() has not been called).

Note: The stoichiometry matrix generated by the base engine is assumed to be consistent with the active species and reactions in this view.

Implements gridfire::DynamicEngine.

Definition at line 263 of file engine_adaptive.cpp.

◆ getBaseEngine()

const DynamicEngine & gridfire::AdaptiveEngineView::getBaseEngine ( ) const

inlineoverridevirtual

Gets the base engine.

Returns: A const reference to the base engine.

Implements gridfire::EngineView< DynamicEngine >.

Definition at line 224 of file engine_adaptive.h.

◆ getJacobianMatrixEntry()

double gridfire::AdaptiveEngineView::getJacobianMatrixEntry	(	const int	i_culled,
		const int	j_culled ) const

overridevirtual

Gets an entry from the Jacobian matrix for the active species.

Parameters

i_culled	The row index (species index) in the culled matrix.
j_culled	The column index (species index) in the culled matrix.

Returns: The value of the Jacobian matrix at (i_culled, j_culled).

This method maps the culled indices to the full network indices and calls the base engine to get the Jacobian matrix entry.

Exceptions

std::runtime_error	If the AdaptiveEngineView is stale (i.e., `update()` has not been called).
std::out_of_range	If the culled index is out of bounds for the species index map.

See also: AdaptiveEngineView::update()

Implements gridfire::DynamicEngine.

Definition at line 252 of file engine_adaptive.cpp.

◆ getNetworkReactions()

const reaction::LogicalReactionSet & gridfire::AdaptiveEngineView::getNetworkReactions ( ) const

overridevirtual

Gets the set of active logical reactions in the network.

Returns: Reference to the LogicalReactionSet containing all active reactions.

Implements gridfire::DynamicEngine.

Definition at line 295 of file engine_adaptive.cpp.

◆ getNetworkSpecies()

const std::vector< Species > & gridfire::AdaptiveEngineView::getNetworkSpecies ( ) const

overridevirtual

Gets the list of active species in the network.

Returns: A const reference to the vector of active species.

Implements gridfire::Engine.

Definition at line 219 of file engine_adaptive.cpp.

◆ getSpeciesTimescales()

std::unordered_map< Species, double > gridfire::AdaptiveEngineView::getSpeciesTimescales	(	const std::vector< double > &	Y_culled,
		double	T9,
		double	rho ) const

overridevirtual

Computes timescales for all active species in the network.

Parameters

Y_culled	Vector of current abundances for the active species.
T9	Temperature in units of 10^9 K.
rho	Density in g/cm^3.

Returns: Map from Species to their characteristic timescales (s).

This method maps the culled abundances to the full network abundances and calls the base engine to compute the species timescales.

Exceptions

std::runtime_error If the AdaptiveEngineView is stale (i.e., update() has not been called).

Implements gridfire::DynamicEngine.

Definition at line 299 of file engine_adaptive.cpp.

◆ getStoichiometryMatrixEntry()

int gridfire::AdaptiveEngineView::getStoichiometryMatrixEntry	(	const int	speciesIndex_culled,
		const int	reactionIndex_culled ) const

overridevirtual

Gets an entry from the stoichiometry matrix for the active species and reactions.

Parameters

speciesIndex_culled	The index of the species in the culled species list.
reactionIndex_culled	The index of the reaction in the culled reaction list.

Returns: The stoichiometric coefficient for the given species and reaction.

This method maps the culled indices to the full network indices and calls the base engine to get the stoichiometry matrix entry.

Exceptions

std::runtime_error	If the AdaptiveEngineView is stale (i.e., `update()` has not been called).
std::out_of_range	If the culled index is out of bounds for the species or reaction index map.

See also: AdaptiveEngineView::update()

Implements gridfire::DynamicEngine.

Definition at line 268 of file engine_adaptive.cpp.

◆ mapCulledToFull()

std::vector< double > gridfire::AdaptiveEngineView::mapCulledToFull ( const std::vector< double > & culled ) const

private

Maps a vector of culled abundances to a vector of full abundances.

Parameters

culled A vector of abundances for the active species.

Returns: A vector of abundances for the full network, with the abundances of the active species copied from the culled vector.

Definition at line 319 of file engine_adaptive.cpp.

◆ mapCulledToFullReactionIndex()

size_t gridfire::AdaptiveEngineView::mapCulledToFullReactionIndex ( size_t culledReactionIndex ) const

private

Maps a culled reaction index to a full reaction index.

Parameters

culledReactionIndex The index of the reaction in the culled reaction list.

Returns: The index of the corresponding reaction in the full network.

Exceptions

std::out_of_range If the culled index is out of bounds for the reaction index map.

Definition at line 346 of file engine_adaptive.cpp.

◆ mapCulledToFullSpeciesIndex()

size_t gridfire::AdaptiveEngineView::mapCulledToFullSpeciesIndex ( size_t culledSpeciesIndex ) const

private

Maps a culled species index to a full species index.

Parameters

culledSpeciesIndex The index of the species in the culled species list.

Returns: The index of the corresponding species in the full network.

Exceptions

std::out_of_range If the culled index is out of bounds for the species index map.

Definition at line 337 of file engine_adaptive.cpp.

◆ mapFullToCulled()

std::vector< double > gridfire::AdaptiveEngineView::mapFullToCulled ( const std::vector< double > & full ) const

private

Maps a vector of full abundances to a vector of culled abundances.

Parameters

full	A vector of abundances for the full network.

Returns: A vector of abundances for the active species, with the abundances of the active species copied from the full vector.

Definition at line 328 of file engine_adaptive.cpp.

◆ update()

void gridfire::AdaptiveEngineView::update ( const NetIn & netIn )

Updates the active species and reactions based on the current conditions.

Parameters

netIn The current network input, containing temperature, density, and composition.

This method performs the reaction flow calculation, reaction culling, connectivity analysis, and index map construction steps described above.

The culling thresholds are read from the configuration using the following keys:

gridfire:AdaptiveEngineView:RelativeCullingThreshold (default: 1e-75)

Exceptions

std::runtime_error If there is a mismatch between the active reactions and the base engine.

Postcondition: The active species and reactions are updated, and the index maps are reconstructed.

See also: AdaptiveEngineView; AdaptiveEngineView::constructSpeciesIndexMap(); AdaptiveEngineView::constructReactionIndexMap()

Definition at line 85 of file engine_adaptive.cpp.

◆ validateState()

void gridfire::AdaptiveEngineView::validateState ( ) const

private

Validates that the AdaptiveEngineView is not stale.

Exceptions

std::runtime_error If the AdaptiveEngineView is stale (i.e., update() has not been called).

Definition at line 355 of file engine_adaptive.cpp.

Member Data Documentation

◆ m_activeReactions

reaction::LogicalReactionSet gridfire::AdaptiveEngineView::m_activeReactions

private

Definition at line 234 of file engine_adaptive.h.

◆ m_activeSpecies

std::vector<fourdst::atomic::Species> gridfire::AdaptiveEngineView::m_activeSpecies

private

Definition at line 233 of file engine_adaptive.h.

◆ m_baseEngine

DynamicEngine& gridfire::AdaptiveEngineView::m_baseEngine

private

Definition at line 231 of file engine_adaptive.h.

◆ m_config

Config& gridfire::AdaptiveEngineView::m_config = Config::getInstance()

private

Definition at line 228 of file engine_adaptive.h.

◆ m_isStale

bool gridfire::AdaptiveEngineView::m_isStale = true

private

Definition at line 239 of file engine_adaptive.h.

◆ m_logger

quill::Logger* gridfire::AdaptiveEngineView::m_logger = LogManager::getInstance().getLogger("log")

private

Definition at line 229 of file engine_adaptive.h.

◆ m_reactionIndexMap

std::vector<size_t> gridfire::AdaptiveEngineView::m_reactionIndexMap

private

Definition at line 237 of file engine_adaptive.h.

◆ m_speciesIndexMap

std::vector<size_t> gridfire::AdaptiveEngineView::m_speciesIndexMap

private

Definition at line 236 of file engine_adaptive.h.

The documentation for this class was generated from the following files:

src/network/include/gridfire/engine/engine_adaptive.h
src/network/lib/engine/engine_adaptive.cpp

Classes

Public Member Functions

Private Types

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ Config

◆ LogManager

Constructor & Destructor Documentation

◆ AdaptiveEngineView()

Member Function Documentation

◆ calculateMolarReactionFlow()

◆ calculateRHSAndEnergy()

◆ constructReactionIndexMap()

◆ constructSpeciesIndexMap()

◆ generateJacobianMatrix()

◆ generateStoichiometryMatrix()

◆ getBaseEngine()

◆ getJacobianMatrixEntry()

◆ getNetworkReactions()

◆ getNetworkSpecies()

◆ getSpeciesTimescales()

◆ getStoichiometryMatrixEntry()

◆ mapCulledToFull()

◆ mapCulledToFullReactionIndex()

◆ mapCulledToFullSpeciesIndex()

◆ mapFullToCulled()

◆ update()

◆ validateState()

Member Data Documentation

◆ m_activeReactions

◆ m_activeSpecies

◆ m_baseEngine

◆ m_config

◆ m_isStale

◆ m_logger

◆ m_reactionIndexMap

◆ m_speciesIndexMap