Axel Loewe requested to merge openCARP_DREAM into master Jul 17, 2024

Implementation of the DREAM in openCARP

Summary

This merge request introduces the DREAM (Diffusion Reaction Eikonal Alternant Model) into the openCARP framework, as described by Barrios Espinosa et al. (2024) arXiv:2406.18619. The DREAM model offers a novel method for simulating reentries in cardiac electrophysiology using an eikonal-based approach.

Implementation Details

Added Files

physics/Eikonal.h: Header file for the Eikonal solver class.
physics/Eikonal.cc: Implementation file for the Eikonal solver class.

Modified Files

simulator/sim_utils.cc: Updated simulate() function to alternate between eikonal and reaction-diffusion (RD) models.
physics/Electrics.cc: Modified Electrics::compute_step() to incorporate Idiff in the computation of transmembrane voltage (v_m).
simulator/openCARP.prm: Introduced new DREAM parameters, clearly marked in the descriptions.
A brief description of the model was added to chapter 3 of the manual

Testing

A new branch of the experiments repository, called Experiments_DREAM, has been created to add a test assessing the DREAM model. This branch will be merged into the master branch of Experiments through a subsequent merge request. Currently, all CI tests, including autotester tests with the newly added DREAM test, pass, except for test-autotester-ginkgo, which also fails in the master branch.

Timing is not affected (35s for ecg-long test in both branches).

Thank you for reviewing this merge request. Your feedback and suggestions are highly appreciated.

Adding Diffusion Reaction Alternant Model (DREAM) to openCARP