Chaste
Release::3.4
|
#include <CardiacElectroMechanicsProblem.hpp>
Public Member Functions | |
CardiacElectroMechanicsProblem (CompressibilityType compressibilityType, ElectricsProblemType electricsProblemType, TetrahedralMesh< DIM, DIM > *pElectricsMesh, QuadraticMesh< DIM > *pMechanicsMesh, AbstractCardiacCellFactory< DIM > *pCellFactory, ElectroMechanicsProblemDefinition< DIM > *pProblemDefinition, std::string outputDirectory) | |
virtual | ~CardiacElectroMechanicsProblem () |
void | Initialise () |
void | Solve () |
double | Max (std::vector< double > &vec) |
void | SetNoElectricsOutput () |
void | SetWatchedPosition (c_vector< double, DIM > watchedLocation) |
void | SetOutputDeformationGradientsAndStress (double timestep) |
std::vector< c_vector< double, DIM > > & | rGetDeformedPosition () |
c_matrix< double, DIM, DIM > & | rCalculateModifiedConductivityTensor (unsigned elementIndex, const c_matrix< double, DIM, DIM > &rOriginalConductivity, unsigned domainIndex) |
virtual void | PrepareForSolve () |
virtual void | OnEndOfTimeStep (unsigned counter) |
AbstractNonlinearElasticitySolver < DIM > * | GetMechanicsSolver () |
Public Member Functions inherited from AbstractConductivityModifier< DIM, DIM > | |
virtual | ~AbstractConductivityModifier () |
c_matrix< double, SPACE_DIM, SPACE_DIM > & | rGetModifiedConductivityTensor (unsigned elementIndex, const c_matrix< double, SPACE_DIM, SPACE_DIM > &rOriginalConductivity, unsigned domainIndex) |
virtual c_matrix< double, SPACE_DIM, SPACE_DIM > & | rCalculateModifiedConductivityTensor (unsigned elementIndex, const c_matrix< double, SPACE_DIM, SPACE_DIM > &rOriginalConductivity, unsigned domainIndex)=0 |
Protected Member Functions | |
void | DetermineWatchedNodes () |
void | WriteWatchedLocationData (double time, Vec voltage) |
Static Protected Attributes | |
static const int | WRITE_EVERY_NTH_TIME = 1 |
Friends | |
class | TestAbstractContractionCellFactory |
class | TestCardiacElectroMechanicsProblem |
class | TestCardiacElectroMechanicsFurtherFunctionality |
class | TestElectroMechanicsExactSolution |
CardiacElectroMechanicsProblem
For solving full electro-mechanical problems.
Solves a monodomain problem (diffusion plus cell models) on a (fine) electrics mesh, and a mechanics problem (finite elasticity plus contraction model) on a coarse mesh. An implicit scheme (Jon Whiteley's algorithm) be be used.
For solving problems on regular grids use CardiacElectroMechProbRegularGeom
The implicit algorithm:
Store the position in the electrics mesh of each quad point in the mechanics mesh For every time: Solve the monodomain problem (ie integrate ODEs, solve PDE) Get intracellular [Ca] at each electrics node and interpolate on each mechanics quad point Set [Ca] on each contraction model (one for each point) Solve static finite elasticity problem implicity
Definition at line 94 of file CardiacElectroMechanicsProblem.hpp.
CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::CardiacElectroMechanicsProblem | ( | CompressibilityType | compressibilityType, |
ElectricsProblemType | electricsProblemType, | ||
TetrahedralMesh< DIM, DIM > * | pElectricsMesh, | ||
QuadraticMesh< DIM > * | pMechanicsMesh, | ||
AbstractCardiacCellFactory< DIM > * | pCellFactory, | ||
ElectroMechanicsProblemDefinition< DIM > * | pProblemDefinition, | ||
std::string | outputDirectory | ||
) |
Constructor.
compressibilityType | Should be either INCOMPRESSIBLE or COMPRESSIBLE |
electricsProblemType | the type of electrics problem (MONODOMAIN or BIDOMAIN) |
pElectricsMesh | Mesh on which to solve electrics (Monodomain) |
pMechanicsMesh | Mesh (2nd order) on which to solve mechanics |
pCellFactory | factory to use to create cells |
pProblemDefinition | electro-mechanics problem definition |
outputDirectory | the output directory |
Definition at line 256 of file CardiacElectroMechanicsProblem.cpp.
References GenericEventHandler< 7, MechanicsEventHandler >::BeginEvent(), CreateElectricsProblem< DIM, PROBLEM_DIM >::Create(), GenericEventHandler< 16, HeartEventHandler >::Disable(), HeartConfig::Instance(), CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::mDeformationOutputDirectory, CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::mHasBath, CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::mOutputDirectory, CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::mpElectricsProblem, CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::mWriteOutput, GenericEventHandler< 7, MechanicsEventHandler >::Reset(), HeartConfig::SetOutputDirectory(), and HeartConfig::SetOutputFilenamePrefix().
|
virtual |
Delete allocated memory and close the watched location file
NOTE if SetWatchedLocation but not Initialise has been called, mpWatchedLocationFile will be uninitialised and using it will cause a seg fault. Hence the mpMechanicsMesh!=NULL it is true if Initialise has been called.
Definition at line 327 of file CardiacElectroMechanicsProblem.cpp.
References LogFile::Close().
|
protected |
Determine which node is closest to the watched location
Definition at line 60 of file CardiacElectroMechanicsProblem.cpp.
References NEVER_REACHED, OutputFileHandler::OpenOutputFile(), and UNSIGNED_UNSET.
|
inline |
Get the mechanics solver used in the solve. Only call after a solve.
Definition at line 300 of file CardiacElectroMechanicsProblem.hpp.
void CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::Initialise | ( | ) |
Initialise the class. Initialises the MonodomainProblem and sets up the electrics mesh to mechanics mesh data.
Definition at line 345 of file CardiacElectroMechanicsProblem.cpp.
References EXCEPTION, HeartConfig::GetPdeTimeStep(), LogFile::Instance(), HeartConfig::Instance(), NEVER_REACHED, LogFile::Set(), FineCoarseMeshPair< DIM >::SetUpBoxesOnFineMesh(), AbstractTetrahedralMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteFilesUsingMesh(), and LogFile::WriteHeader().
double CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::Max | ( | std::vector< double > & | vec | ) |
Short helper function
vec | a vector of doubles |
Definition at line 950 of file CardiacElectroMechanicsProblem.cpp.
|
inlinevirtual |
Called in Solve() at the end of every time step
counter | time step |
Definition at line 291 of file CardiacElectroMechanicsProblem.hpp.
|
inlinevirtual |
Called in Solve() before the time loop
Definition at line 285 of file CardiacElectroMechanicsProblem.hpp.
c_matrix< double, DIM, DIM > & CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::rCalculateModifiedConductivityTensor | ( | unsigned | elementIndex, |
const c_matrix< double, DIM, DIM > & | rOriginalConductivity, | ||
unsigned | domainIndex | ||
) |
The implementation of the pure method defined in the base class AbstractConductivityModifier. The tissue class will call this method.
elementIndex | Index of current element |
rOriginalConductivity | Reference to the original (for example, undeformed) conductivity tensor |
domainIndex | Used to tailor modification to the domain. 0 = intracellular, 1 = extracellular, 2 = second intracellular (tridomain) |
Definition at line 169 of file CardiacElectroMechanicsProblem.cpp.
References Inverse().
std::vector< c_vector< double, DIM > > & CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::rGetDeformedPosition | ( | ) |
Definition at line 985 of file CardiacElectroMechanicsProblem.cpp.
void CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::SetNoElectricsOutput | ( | ) |
Call to not write out voltages
Definition at line 961 of file CardiacElectroMechanicsProblem.cpp.
void CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::SetOutputDeformationGradientsAndStress | ( | double | timestep | ) |
Call this for a files containing the deformation gradients (F), evaluated at the centroids of element, and the 2nd PK stress for each element (averaged over the values at the quadrature points of that element), to be written,
timestep | how often to write this. Must be a multiple of the mechanics timestep. |
Definition at line 974 of file CardiacElectroMechanicsProblem.cpp.
References EXCEPTION.
void CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::SetWatchedPosition | ( | c_vector< double, DIM > | watchedLocation | ) |
Set a location to be watched - for which lots of output is given. Should correspond to nodes in both meshes.
The watched file will have rows that look like: time x_pos y_pos [z_pos] voltage Ca_i_conc.
NOTE: for the Calcium - assumes LUO_RUDY IS USED
watchedLocation | location (x,y,z) in space. Watched node is the closest to this point. |
Definition at line 967 of file CardiacElectroMechanicsProblem.cpp.
void CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::Solve | ( | ) |
Solve the electromechanics problem
Definition at line 488 of file CardiacElectroMechanicsProblem.cpp.
References PetscTools::Barrier(), GenericEventHandler< 7, MechanicsEventHandler >::BeginEvent(), RelativeTo::ChasteTestOutput, PetscTools::Destroy(), GenericEventHandler< 7, MechanicsEventHandler >::EndEvent(), AbstractElement< ELEMENT_DIM, SPACE_DIM >::GetNodeGlobalIndex(), AbstractElement< ELEMENT_DIM, SPACE_DIM >::GetNumNodes(), HeartConfig::GetOutputDirectory(), HeartConfig::GetPdeTimeStep(), CommandLineArguments::Instance(), LogFile::Instance(), HeartConfig::Instance(), CommandLineArguments::OptionExists(), HeartConfig::Reset(), AbstractDynamicLinearPdeSolver< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::SetInitialCondition(), AbstractDynamicLinearPdeSolver< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::SetMatrixIsNotAssembled(), HeartConfig::SetOutputDirectory(), HeartConfig::SetPrintingTimeStep(), AbstractDynamicLinearPdeSolver< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::SetTimes(), AbstractDynamicLinearPdeSolver< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::SetTimeStep(), AbstractDynamicLinearPdeSolver< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::Solve(), UNSIGNED_UNSET, and LogFile::WriteElapsedTime().
|
protected |
Write info (x, y, [z], V) for the watched node.
time | Time-step now, to write out |
voltage | Vm vector (this is Monodomain) |
Definition at line 144 of file CardiacElectroMechanicsProblem.cpp.
|
protected |
Either COMPRESSIBLE or INCOMPRESSIBLE
Definition at line 105 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
A vector of deformation gradients (each entry a matrix), one for each element in the mechanics mesh
Definition at line 175 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
Deformation output-sub-directory
Definition at line 149 of file CardiacElectroMechanicsProblem.hpp.
Referenced by CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::CardiacElectroMechanicsProblem().
|
protected |
Whether the mesh has a bath (non-active) region or not. False by default.
Definition at line 141 of file CardiacElectroMechanicsProblem.hpp.
Referenced by CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::CardiacElectroMechanicsProblem().
|
protected |
A cache for the interpolated calcium concentrations from electrics to mechanics mesh. Memory is allocated within Initialise(). Filled in during Solve() and passed on to the mechanics solver
Definition at line 124 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
A cache for the interpolated voltages from electrics to mechanics mesh. Memory is allocated within Initialise(). Filled in during Solve() and passed on to the mechanics solver
Definition at line 130 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
Whether any location has been set to be watched (lots of output for that location
Definition at line 159 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
Somewhere to store the modified conductivity tensor
Definition at line 178 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
Whether to not write out voltages
Definition at line 153 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
The number of electrics timesteps per mechanics timestep
Definition at line 118 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
How often to print the deformation gradients and stress to file (if ever)
Definition at line 170 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
Output directory, relative to TEST_OUTPUT
Definition at line 147 of file CardiacElectroMechanicsProblem.hpp.
Referenced by CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::CardiacElectroMechanicsProblem().
|
protected |
The mechanics solver - a pointer to the part that sees the cardiac mechanics interface bit. (Object pointed to is the same as with mpMechanicsSolver)
Definition at line 112 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
The mesh for the electrics
Definition at line 133 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
The cardiac problem class
Definition at line 108 of file CardiacElectroMechanicsProblem.hpp.
Referenced by CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::CardiacElectroMechanicsProblem().
|
protected |
The mesh for the mechanics
Definition at line 135 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
The mechanics solver - a pointer to the part that sees the solid mechanics solver (Object pointed to is the same as with mpCardiacMechSolver)
Definition at line 115 of file CardiacElectroMechanicsProblem.hpp.
Referenced by CardiacElectroMechanicsProblem< DIM >::GetMechanicsSolver().
|
protected |
Class wrapping both meshes, useful for transferring information
Definition at line 144 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
Object containing information about the problem to be solved
Definition at line 138 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
File where watched location info is written
Definition at line 167 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
A vector of stretches (in the fibre direction), one for each element in the mechanics mesh
Definition at line 173 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
The node in the electrics mesh corresponding to the watched location
Definition at line 163 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
The watched location if there is one
Definition at line 161 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
The node in the mechanics mesh corresponding to the watched location
Definition at line 165 of file CardiacElectroMechanicsProblem.hpp.
|
protected |
Whether to write any output
Definition at line 151 of file CardiacElectroMechanicsProblem.hpp.
Referenced by CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::CardiacElectroMechanicsProblem().
|
staticprotected |
when to write output
Definition at line 156 of file CardiacElectroMechanicsProblem.hpp.