Update coronary documentation

[alisonmarsden]

Problem

Suggestion from Vijay:

have a suggestion here. Apparently, Luke Timmins reached out to Gerard to implement coronary BC in FEBio and they used SimVascular documentation as a guideline along with the papers by Sethu (ABME 2012) and HJ Kim (ABME 2010). I helped Gerard understand some issues with the current documentation and some typos in these papers. There are some caveats in the coronary BC that are not adequately discussed in the documentation that need to be updated. For e.g., we don't mention much about the intramyocardial pressure P_im and the use of scale factors. We are also using the figure from Kim's paper with 'V' at the ground potential, but do not discuss these. Sethu's paper uses equations suggesting that all coronary outlets are connected to left atrium, but in fact it should be connected to the right atrium.

Solution

We need to go through the coronary documentation and

1. create a coronary example case by updating the prior example to run in svMultiPhysics
2. update the documentation to use current formats
3. address discrepancies and missing details as described above

Additional context

No response

Code of Conduct

• I agree to follow this project's Code of Conduct and Contributing Guidelines

[ktbolt]

@alisonmarsden By coronary documentation do you mean the Clinical Case Studies / Coronary documentation ?

If so then that documentation is for svSolver; svMultiPhysics does not have an implementation of a coronary outflow boundary condition so you would use the svZeroDSolver coronary boundary condition.

[alisonmarsden]

Yes that's what I mean. Good point and I agree. We will need to document how to set up a coupled simulation using a coronary model in svZeroDSolver. We will likely need to generate example files for this because we have yet to run a coronary simulation in svMultiPhysics to my knowledge. @menon-karthik do you have comments?

[menon-karthik]

@alisonmarsden @ktbolt My student and I have been running coronary simulations using svMultiPhysics coupled with svZeroDSolver. We usually run closed-loop BCs (which include coronary BCs), but we may have also run just coronary BCs.

If you want a test case to replace the current coronary tutorial, I can dig something up and send across the input files. I assume you would prefer just coronary BCs, and not closed-loop, since it's meant to be a relatively simple tutorial?

[alisonmarsden]

@menon-karthik that would be much appreciated! @ryanspilker is going to work on documentation and if you send over the files and a bit of explanation he can update the text. Yes I think open loop is a good place to start. Separate question: are you using a dirichlet BC on the aortic inlet? It seems the dirichlet BC option was not implemented for coupling with svZeroDSolver. There is an issue open for this.