Chaste  Release::2024.1
VertexBasedCellPopulation< DIM > Class Template Reference

#include <VertexBasedCellPopulation.hpp>

+ Inheritance diagram for VertexBasedCellPopulation< DIM >:
+ Collaboration diagram for VertexBasedCellPopulation< DIM >:

Public Member Functions

 VertexBasedCellPopulation (MutableVertexMesh< DIM, DIM > &rMesh, std::vector< CellPtr > &rCells, bool deleteMesh=false, bool validate=true, const std::vector< unsigned > locationIndices=std::vector< unsigned >())
 
 VertexBasedCellPopulation (MutableVertexMesh< DIM, DIM > &rMesh)
 
virtual ~VertexBasedCellPopulation ()
 
double GetDampingConstant (unsigned nodeIndex)
 
MutableVertexMesh< DIM, DIM > & rGetMesh ()
 
const MutableVertexMesh< DIM, DIM > & rGetMesh () const
 
VertexElement< DIM, DIM > * GetElement (unsigned elementIndex)
 
unsigned GetNumElements ()
 
unsigned GetNumNodes ()
 
c_vector< double, DIM > GetLocationOfCellCentre (CellPtr pCell)
 
Node< DIM > * GetNode (unsigned index)
 
std::set< unsignedGetNeighbouringLocationIndices (CellPtr pCell)
 
unsigned AddNode (Node< DIM > *pNewNode)
 
virtual void CheckForStepSizeException (unsigned nodeIndex, c_vector< double, DIM > &rDisplacement, double dt)
 
void SetNode (unsigned index, ChastePoint< DIM > &rNewLocation)
 
VertexElement< DIM, DIM > * GetElementCorrespondingToCell (CellPtr pCell)
 
CellPtr AddCell (CellPtr pNewCell, CellPtr pParentCell=CellPtr())
 
unsigned RemoveDeadCells ()
 
bool IsCellAssociatedWithADeletedLocation (CellPtr pCell)
 
void Update (bool hasHadBirthsOrDeaths=true)
 
virtual void OpenWritersFiles (OutputFileHandler &rOutputFileHandler)
 
virtual void AcceptPopulationWriter (boost::shared_ptr< AbstractCellPopulationWriter< DIM, DIM > > pPopulationWriter)
 
virtual void AcceptPopulationCountWriter (boost::shared_ptr< AbstractCellPopulationCountWriter< DIM, DIM > > pPopulationCountWriter)
 
virtual void AcceptCellWriter (boost::shared_ptr< AbstractCellWriter< DIM, DIM > > pCellWriter, CellPtr pCell)
 
unsigned GetRosetteRankOfCell (CellPtr pCell)
 
double GetVolumeOfCell (CellPtr pCell)
 
std::vector< c_vector< double, DIM > > GetLocationsOfT2Swaps ()
 
std::vector< unsignedGetCellIdsOfT2Swaps ()
 
void AddLocationOfT2Swap (c_vector< double, DIM > locationOfT2Swap)
 
void AddCellIdOfT2Swap (unsigned idOfT2Swap)
 
void ClearLocationsAndCellIdsOfT2Swaps ()
 
bool GetOutputCellRearrangementLocations ()
 
void SetOutputCellRearrangementLocations (bool outputCellRearrangementLocations)
 
void OutputCellPopulationParameters (out_stream &rParamsFile)
 
double GetWidth (const unsigned &rDimension)
 
std::set< unsignedGetNeighbouringNodeIndices (unsigned index)
 
virtual TetrahedralMesh< DIM, DIM > * GetTetrahedralMeshForPdeModifier ()
 
virtual bool IsPdeNodeAssociatedWithNonApoptoticCell (unsigned pdeNodeIndex)
 
virtual double GetCellDataItemAtPdeNode (unsigned pdeNodeIndex, std::string &rVariableName, bool dirichletBoundaryConditionApplies=false, double dirichletBoundaryValue=0.0)
 
boost::shared_ptr< AbstractVertexBasedDivisionRule< DIM > > GetVertexBasedDivisionRule ()
 
void SetVertexBasedDivisionRule (boost::shared_ptr< AbstractVertexBasedDivisionRule< DIM > > pVertexBasedDivisionRule)
 
virtual double GetDefaultTimeStep ()
 
virtual void WriteDataToVisualizerSetupFile (out_stream &pVizSetupFile)
 
virtual void SimulationSetupHook (AbstractCellBasedSimulation< DIM, DIM > *pSimulation)
 
bool GetRestrictVertexMovementBoolean ()
 
void SetRestrictVertexMovementBoolean (bool restrictVertexMovement)
 
- Public Member Functions inherited from AbstractOffLatticeCellPopulation< DIM >
 AbstractOffLatticeCellPopulation (AbstractMesh< ELEMENT_DIM, ELEMENT_DIM > &rMesh, std::vector< CellPtr > &rCells, const std::vector< unsigned > locationIndices=std::vector< unsigned >())
 
virtual unsigned AddNode (Node< ELEMENT_DIM > *pNewNode)=0
 
virtual void SetNode (unsigned nodeIndex, ChastePoint< ELEMENT_DIM > &rNewLocation)=0
 
virtual void UpdateNodeLocations (double dt)
 
virtual void CheckForStepSizeException (unsigned nodeIndex, c_vector< double, ELEMENT_DIM > &rDisplacement, double dt)=0
 
void SetDampingConstantNormal (double dampingConstantNormal)
 
void SetDampingConstantMutant (double dampingConstantMutant)
 
void SetAbsoluteMovementThreshold (double absoluteMovementThreshold)
 
double GetAbsoluteMovementThreshold ()
 
double GetDampingConstantNormal ()
 
double GetDampingConstantMutant ()
 
- Public Member Functions inherited from AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >
 AbstractCellPopulation (AbstractMesh< ELEMENT_DIM, SPACE_DIM > &rMesh, std::vector< CellPtr > &rCells, const std::vector< unsigned > locationIndices=std::vector< unsigned >())
 
virtual ~AbstractCellPopulation ()
 
void InitialiseCells ()
 
void SetDataOnAllCells (const std::string &rDataName, double dataValue)
 
AbstractMesh< ELEMENT_DIM, SPACE_DIM > & rGetMesh ()
 
std::list< CellPtr > & rGetCells ()
 
virtual void SetNode (unsigned nodeIndex, ChastePoint< SPACE_DIM > &rNewLocation)=0
 
std::vector< unsignedGetCellMutationStateCount ()
 
std::vector< unsignedGetCellProliferativeTypeCount ()
 
std::vector< unsignedGetCellCyclePhaseCount ()
 
unsigned GetNumRealCells ()
 
unsigned GetNumAllCells ()
 
void SetCellAncestorsToLocationIndices ()
 
std::set< unsignedGetCellAncestors ()
 
virtual CellPtr GetCellUsingLocationIndex (unsigned index)
 
std::set< CellPtr > GetCellsUsingLocationIndex (unsigned index)
 
virtual bool IsCellAttachedToLocationIndex (unsigned index)
 
void SetCellUsingLocationIndex (unsigned index, CellPtr pCell)
 
virtual void AddCellUsingLocationIndex (unsigned index, CellPtr pCell)
 
virtual void RemoveCellUsingLocationIndex (unsigned index, CellPtr pCell)
 
void MoveCellInLocationMap (CellPtr pCell, unsigned old_index, unsigned new_index)
 
unsigned GetLocationIndexUsingCell (CellPtr pCell)
 
boost::shared_ptr< CellPropertyRegistryGetCellPropertyRegistry ()
 
void SetDefaultCellMutationStateAndProliferativeTypeOrdering ()
 
c_vector< double, SPACE_DIM > GetCentroidOfCellPopulation ()
 
virtual void UpdateCellProcessLocation ()
 
void CloseWritersFiles ()
 
virtual void WriteResultsToFiles (const std::string &rDirectory)
 
virtual void AcceptPopulationWriter (boost::shared_ptr< AbstractCellPopulationWriter< ELEMENT_DIM, SPACE_DIM > > pPopulationWriter)=0
 
virtual void AcceptPopulationCountWriter (boost::shared_ptr< AbstractCellPopulationCountWriter< ELEMENT_DIM, SPACE_DIM > > pPopulationCountWriter)=0
 
virtual void AcceptCellWriter (boost::shared_ptr< AbstractCellWriter< ELEMENT_DIM, SPACE_DIM > > pCellWriter, CellPtr pCell)=0
 
void OutputCellPopulationInfo (out_stream &rParamsFile)
 
virtual void SimulationSetupHook (AbstractCellBasedSimulation< ELEMENT_DIM, SPACE_DIM > *pSimulation)
 
bool GetOutputResultsForChasteVisualizer ()
 
void AddPopulationWriter ()
 
void AddPopulationWriter (boost::shared_ptr< AbstractCellPopulationWriter< ELEMENT_DIM, SPACE_DIM > > pPopulationWriter)
 
void AddCellWriter ()
 
void AddCellWriter (boost::shared_ptr< AbstractCellWriter< ELEMENT_DIM, SPACE_DIM > > pCellWriter)
 
void AddCellPopulationCountWriter ()
 
void AddCellPopulationCountWriter (boost::shared_ptr< AbstractCellPopulationCountWriter< ELEMENT_DIM, SPACE_DIM > > pCellPopulationCountWriter)
 
bool HasWriter () const
 
void SetOutputResultsForChasteVisualizer (bool outputResultsForChasteVisualizer)
 
c_vector< double, SPACE_DIM > GetSizeOfCellPopulation ()
 
virtual bool IsRoomToDivide (CellPtr pCell)
 
std::pair< unsigned, unsignedCreateOrderedPair (unsigned index1, unsigned index2)
 
Iterator Begin ()
 
Iterator End ()
 
- Public Member Functions inherited from Identifiable
virtual ~Identifiable ()
 
std::string GetIdentifier () const
 

Private Member Functions

virtual void WriteVtkResultsToFile (const std::string &rDirectory)
 
template<class Archive >
void serialize (Archive &archive, const unsigned int version)
 
void Validate ()
 

Private Attributes

bool mDeleteMesh
 
MutableVertexMesh< DIM, DIM > * mpMutableVertexMesh
 
bool mOutputCellRearrangementLocations
 
boost::shared_ptr< AbstractVertexBasedDivisionRule< DIM > > mpVertexBasedDivisionRule
 
std::vector< c_vector< double, DIM > > mLocationsOfT2Swaps
 
std::vector< unsignedmCellIdsOfT2Swaps
 
bool mRestrictVertexMovement
 
bool mThrowStepSizeException = true
 

Friends

class TestVertexBasedDivisionRules
 
class boost::serialization::access
 

Additional Inherited Members

- Protected Member Functions inherited from AbstractOffLatticeCellPopulation< DIM >
 AbstractOffLatticeCellPopulation (AbstractMesh< ELEMENT_DIM, ELEMENT_DIM > &rMesh)
 
- Protected Member Functions inherited from AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >
 AbstractCellPopulation (AbstractMesh< ELEMENT_DIM, SPACE_DIM > &rMesh)
 
virtual void AcceptCellWritersAcrossPopulation ()
 
- Protected Attributes inherited from AbstractOffLatticeCellPopulation< DIM >
double mDampingConstantNormal
 
double mDampingConstantMutant
 
double mAbsoluteMovementThreshold
 
- Protected Attributes inherited from AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >
std::map< unsigned, std::set< CellPtr > > mLocationCellMap
 
std::map< Cell *, unsignedmCellLocationMap
 
AbstractMesh< ELEMENT_DIM, SPACE_DIM > & mrMesh
 
std::list< CellPtr > mCells
 
c_vector< double, SPACE_DIM > mCentroid
 
out_stream mpVtkMetaFile
 
boost::shared_ptr< CellPropertyRegistrympCellPropertyRegistry
 
bool mOutputResultsForChasteVisualizer
 
std::vector< boost::shared_ptr< AbstractCellWriter< ELEMENT_DIM, SPACE_DIM > > > mCellWriters
 
std::vector< boost::shared_ptr< AbstractCellPopulationWriter< ELEMENT_DIM, SPACE_DIM > > > mCellPopulationWriters
 
std::vector< boost::shared_ptr< AbstractCellPopulationCountWriter< ELEMENT_DIM, SPACE_DIM > > > mCellPopulationCountWriters
 

Detailed Description

template<unsigned DIM>
class VertexBasedCellPopulation< DIM >

A facade class encapsulating a vertex-based cell population.

Contains a group of cells and maintains the associations between CellPtrs and elements in the MutableVertexMesh.

Definition at line 47 of file FixedVertexBasedDivisionRule.hpp.

Constructor & Destructor Documentation

◆ VertexBasedCellPopulation() [1/2]

template<unsigned DIM>
VertexBasedCellPopulation< DIM >::VertexBasedCellPopulation ( MutableVertexMesh< DIM, DIM > &  rMesh,
std::vector< CellPtr > &  rCells,
bool  deleteMesh = false,
bool  validate = true,
const std::vector< unsigned locationIndices = std::vector<unsigned>() 
)

Create a new cell population facade from a mesh and collection of cells.

There must be precisely one CellPtr for each VertexElement in the mesh.

Parameters
rMeshreference to a
rCellsreference to a vector of CellPtrs
deleteMeshset to true if you want the cell population to free the mesh memory on destruction
validatewhether to validate the cell population when it is created (defaults to true)
locationIndicesan optional vector of location indices that correspond to real cells

Definition at line 53 of file VertexBasedCellPopulation.cpp.

References AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mCells, VertexBasedCellPopulation< DIM >::mpMutableVertexMesh, VertexBasedCellPopulation< DIM >::mpVertexBasedDivisionRule, and AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mrMesh.

Referenced by VertexBasedCellPopulation< DIM >::serialize().

◆ VertexBasedCellPopulation() [2/2]

template<unsigned DIM>
VertexBasedCellPopulation< DIM >::VertexBasedCellPopulation ( MutableVertexMesh< DIM, DIM > &  rMesh)

Constructor for use by boost serialization ONLY!

Parameters
rMesha vertex mesh.

Definition at line 82 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mpMutableVertexMesh, and AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mrMesh.

◆ ~VertexBasedCellPopulation()

template<unsigned DIM>
VertexBasedCellPopulation< DIM >::~VertexBasedCellPopulation ( )
virtual

Destructor, which frees any memory allocated by the constructor.

Definition at line 92 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mDeleteMesh, and AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mrMesh.

Referenced by VertexBasedCellPopulation< DIM >::serialize().

Member Function Documentation

◆ AcceptCellWriter()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::AcceptCellWriter ( boost::shared_ptr< AbstractCellWriter< DIM, DIM > >  pCellWriter,
CellPtr  pCell 
)
virtual

A virtual method to accept a cell writer so it can write data from this object to file.

Parameters
pCellWriterthe population writer.
pCellthe cell whose data are being written.

Definition at line 368 of file VertexBasedCellPopulation.cpp.

◆ AcceptPopulationCountWriter()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::AcceptPopulationCountWriter ( boost::shared_ptr< AbstractCellPopulationCountWriter< DIM, DIM > >  pPopulationCountWriter)
virtual

A virtual method to accept a cell population count writer so it can write data from this object to file.

Parameters
pPopulationCountWriterthe population count writer.

Definition at line 362 of file VertexBasedCellPopulation.cpp.

◆ AcceptPopulationWriter()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::AcceptPopulationWriter ( boost::shared_ptr< AbstractCellPopulationWriter< DIM, DIM > >  pPopulationWriter)
virtual

A virtual method to accept a cell population writer so it can write data from this object to file.

Parameters
pPopulationWriterthe population writer.

Definition at line 356 of file VertexBasedCellPopulation.cpp.

◆ AddCell()

template<unsigned DIM>
CellPtr VertexBasedCellPopulation< DIM >::AddCell ( CellPtr  pNewCell,
CellPtr  pParentCell = CellPtr() 
)
virtual

◆ AddCellIdOfT2Swap()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::AddCellIdOfT2Swap ( unsigned  idOfT2Swap)

Add ID of T2 Swap.

Parameters
idOfT2SwapID of the cell undergoing a T2 swap

Definition at line 593 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mCellIdsOfT2Swaps.

◆ AddLocationOfT2Swap()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::AddLocationOfT2Swap ( c_vector< double, DIM >  locationOfT2Swap)

Add location of T2 Swap.

Parameters
locationOfT2SwapLocation of the T2 swap

Definition at line 587 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mLocationsOfT2Swaps.

◆ AddNode()

template<unsigned DIM>
unsigned VertexBasedCellPopulation< DIM >::AddNode ( Node< DIM > *  pNewNode)

Overridden AddNode() method.

Add a new node to the cell population.

Parameters
pNewNodepointer to the new node
Returns
global index of new node in cell population

Definition at line 179 of file VertexBasedCellPopulation.cpp.

References MutableVertexMesh< ELEMENT_DIM, SPACE_DIM >::AddNode(), and VertexBasedCellPopulation< DIM >::mpMutableVertexMesh.

◆ CheckForStepSizeException()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::CheckForStepSizeException ( unsigned  nodeIndex,
c_vector< double, DIM > &  rDisplacement,
double  dt 
)
virtual

Checks whether a given node displacement violates the movement threshold for this population. If so, a stepSizeException is generated that contains a warning/error message and a suggested smaller dt that should avoid the problem.

Parameters
nodeIndexIndex of the node in question (allows us to check whether this is a ghost or particle)
rDisplacementMovement vector of the node at this time step
dtCurrent time step size

Definition at line 261 of file VertexBasedCellPopulation.cpp.

References MutableVertexMesh< ELEMENT_DIM, SPACE_DIM >::GetCellRearrangementThreshold(), VertexBasedCellPopulation< DIM >::mpMutableVertexMesh, VertexBasedCellPopulation< DIM >::mRestrictVertexMovement, and VertexBasedCellPopulation< DIM >::mThrowStepSizeException.

◆ ClearLocationsAndCellIdsOfT2Swaps()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::ClearLocationsAndCellIdsOfT2Swaps ( )

Clear the locations and IDs of cells undergoing T2 Swaps.

Definition at line 599 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mCellIdsOfT2Swaps, and VertexBasedCellPopulation< DIM >::mLocationsOfT2Swaps.

◆ GetCellDataItemAtPdeNode()

template<unsigned DIM>
double VertexBasedCellPopulation< DIM >::GetCellDataItemAtPdeNode ( unsigned  pdeNodeIndex,
std::string &  rVariableName,
bool  dirichletBoundaryConditionApplies = false,
double  dirichletBoundaryValue = 0.0 
)
virtual

Overridden GetCellDataItemAtPdeNode() method.

Parameters
pdeNodeIndexindex of a node in a tetrahedral mesh for use with a PDE modifier
rVariableNamethe name of the cell data item to get
dirichletBoundaryConditionApplieswhere a Dirichlet boundary condition is used (optional; defaults to false)
dirichletBoundaryValuethe value of the Dirichlet boundary condition, if used (optional; defaults to 0.0)
Returns
the value of a CellData item (interpolated if necessary) at a node, specified by its index in a tetrahedral mesh for use with a PDE modifier. This method can be called by PDE modifier classes.
Todo:
Work out a better way to do the nodes not associated with cells

Implements AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 773 of file VertexBasedCellPopulation.cpp.

References AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::GetCellUsingLocationIndex(), VertexBasedCellPopulation< DIM >::GetNode(), VertexBasedCellPopulation< DIM >::GetNumNodes(), and Node< SPACE_DIM >::rGetContainingElementIndices().

◆ GetCellIdsOfT2Swaps()

template<unsigned DIM>
std::vector< unsigned > VertexBasedCellPopulation< DIM >::GetCellIdsOfT2Swaps ( )

Return all IDs of cells undergoing T2 swaps since the last sampling time step.

Returns
mLocationsOfT2Swaps

Definition at line 581 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mCellIdsOfT2Swaps.

Referenced by VertexT2SwapLocationsWriter< ELEMENT_DIM, SPACE_DIM >::Visit().

◆ GetDampingConstant()

template<unsigned DIM>
double VertexBasedCellPopulation< DIM >::GetDampingConstant ( unsigned  nodeIndex)
virtual

Overridden GetDampingConstant() method.

Parameters
nodeIndexthe global index of this node
Returns
the average damping constant of the cells surrounding the node.

Implements AbstractOffLatticeCellPopulation< DIM >.

Definition at line 101 of file VertexBasedCellPopulation.cpp.

References EXCEPTION, VertexBasedCellPopulation< DIM >::GetNode(), and SimulationTime::Instance().

Referenced by VertexBasedCellPopulation< DIM >::serialize().

◆ GetDefaultTimeStep()

template<unsigned DIM>
double VertexBasedCellPopulation< DIM >::GetDefaultTimeStep ( )
virtual

Overridden GetDefaultTimeStep() method.

Returns
a default value for the time step to use when simulating the cell population.

A hard-coded value of 0.002 is returned. However, note that the time step can be reset by calling SetDt() on the simulation object used to simulate the cell population.

Implements AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 823 of file VertexBasedCellPopulation.cpp.

◆ GetElement()

◆ GetElementCorrespondingToCell()

template<unsigned DIM>
VertexElement< DIM, DIM > * VertexBasedCellPopulation< DIM >::GetElementCorrespondingToCell ( CellPtr  pCell)

◆ GetLocationOfCellCentre()

template<unsigned DIM>
c_vector< double, DIM > VertexBasedCellPopulation< DIM >::GetLocationOfCellCentre ( CellPtr  pCell)
virtual

Overridden GetLocationOfCellCentre() method.

Find the centre of mass of a given cell (assuming uniform density). Note that, as there is no guarantee of convexity, this may lie outside the VertexElement corresponding to the cell.

Parameters
pCella cell in the population
Returns
the location of the centre of mass of the element corresponding to this cell.

Implements AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 160 of file VertexBasedCellPopulation.cpp.

References VertexMesh< ELEMENT_DIM, SPACE_DIM >::GetCentroidOfElement(), AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mCellLocationMap, and VertexBasedCellPopulation< DIM >::mpMutableVertexMesh.

Referenced by VertexBasedCellPopulation< DIM >::serialize().

◆ GetLocationsOfT2Swaps()

template<unsigned DIM>
std::vector< c_vector< double, DIM > > VertexBasedCellPopulation< DIM >::GetLocationsOfT2Swaps ( )

Return all locations of T2 swaps since the last sampling time step.

Returns
mLocationsOfT2Swaps

Definition at line 575 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mLocationsOfT2Swaps.

Referenced by VertexT2SwapLocationsWriter< ELEMENT_DIM, SPACE_DIM >::Visit().

◆ GetNeighbouringLocationIndices()

template<unsigned DIM>
std::set< unsigned > VertexBasedCellPopulation< DIM >::GetNeighbouringLocationIndices ( CellPtr  pCell)
virtual

Overridden GetNeighbouringLocationIndices() method.

Given a cell, returns the set of location indices corresponding to neighbouring cells.

Parameters
pCella cell
Returns
the set of neighbouring location indices.

Implements AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 172 of file VertexBasedCellPopulation.cpp.

References AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::GetLocationIndexUsingCell(), VertexMesh< ELEMENT_DIM, SPACE_DIM >::GetNeighbouringElementIndices(), and VertexBasedCellPopulation< DIM >::rGetMesh().

◆ GetNeighbouringNodeIndices()

template<unsigned DIM>
std::set< unsigned > VertexBasedCellPopulation< DIM >::GetNeighbouringNodeIndices ( unsigned  index)
virtual

Overridden GetNeighbouringNodeIndices() method.

Parameters
indexthe node index
Returns
the set of neighbouring node indices.

Implements AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 557 of file VertexBasedCellPopulation.cpp.

◆ GetNode()

◆ GetNumElements()

◆ GetNumNodes()

◆ GetOutputCellRearrangementLocations()

template<unsigned DIM>
bool VertexBasedCellPopulation< DIM >::GetOutputCellRearrangementLocations ( )
Returns
mOutputCellRearrangementLocations

Definition at line 519 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mOutputCellRearrangementLocations.

◆ GetRestrictVertexMovementBoolean()

template<unsigned DIM>
bool VertexBasedCellPopulation< DIM >::GetRestrictVertexMovementBoolean ( )

Get the value of the mRestrictVertexMovement boolean.

Returns
True if vertex movement is restricted at each timestep.

Definition at line 846 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mRestrictVertexMovement.

◆ GetRosetteRankOfCell()

template<unsigned DIM>
unsigned VertexBasedCellPopulation< DIM >::GetRosetteRankOfCell ( CellPtr  pCell)

Get the "rosette rank" of a cell.

This is defined as the maximum number of cells shared by any node in the cell's corresponding element.

Parameters
pCellboost shared pointer to a cell
Returns
rosette rank via associated mesh element

Definition at line 374 of file VertexBasedCellPopulation.cpp.

References AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::GetLocationIndexUsingCell(), VertexMesh< ELEMENT_DIM, SPACE_DIM >::GetRosetteRankOfElement(), and VertexBasedCellPopulation< DIM >::mpMutableVertexMesh.

Referenced by CellRosetteRankWriter< ELEMENT_DIM, SPACE_DIM >::GetCellDataForVtkOutput().

◆ GetTetrahedralMeshForPdeModifier()

template<unsigned DIM>
TetrahedralMesh< DIM, DIM > * VertexBasedCellPopulation< DIM >::GetTetrahedralMeshForPdeModifier ( )
virtual

Overridden GetTetrahedralMeshForPdeModifier() method.

Returns
a pointer to a tetrahedral mesh using the nodes in the VertexMesh as well as an additional node at the centre of each VertexElement. At present, this method only works in 2D.

This method is called by AbstractGrowingDomainPdeModifier.

Todo:
will the nodes in mpMutableVertexMesh always have indices 0,1,2,...? (#2221)

Implements AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 606 of file VertexBasedCellPopulation.cpp.

References AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNode(), MutableVertexMesh< ELEMENT_DIM, SPACE_DIM >::GetNumElements(), MutableVertexMesh< ELEMENT_DIM, SPACE_DIM >::GetNumNodes(), OutputFileHandler::GetOutputDirectoryFullPath(), PetscTools::IsSequential(), and VertexBasedCellPopulation< DIM >::mpMutableVertexMesh.

◆ GetVertexBasedDivisionRule()

template<unsigned DIM>
boost::shared_ptr< AbstractVertexBasedDivisionRule< DIM > > VertexBasedCellPopulation< DIM >::GetVertexBasedDivisionRule ( )
Returns
The Vertex division rule that is currently being used.

Definition at line 563 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mpVertexBasedDivisionRule.

◆ GetVolumeOfCell()

template<unsigned DIM>
double VertexBasedCellPopulation< DIM >::GetVolumeOfCell ( CellPtr  pCell)
virtual

◆ GetWidth()

template<unsigned DIM>
double VertexBasedCellPopulation< DIM >::GetWidth ( const unsigned rDimension)
virtual

Overridden GetWidth() method.

Calculate the 'width' of any dimension of the cell population by calling GetWidth() on the mesh.

Parameters
rDimensiona dimension (0,1 or 2)
Returns
The maximum distance between any nodes in this dimension.

Implements AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 548 of file VertexBasedCellPopulation.cpp.

Referenced by VertexBasedCellPopulation< DIM >::WriteDataToVisualizerSetupFile().

◆ IsCellAssociatedWithADeletedLocation()

template<unsigned DIM>
bool VertexBasedCellPopulation< DIM >::IsCellAssociatedWithADeletedLocation ( CellPtr  pCell)
virtual

Overridden IsCellAssociatedWithADeletedLocation() method.

Parameters
pCellthe cell
Returns
whether a given cell is associated with a deleted element.

Implements AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 288 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::GetElementCorrespondingToCell().

◆ IsPdeNodeAssociatedWithNonApoptoticCell()

template<unsigned DIM>
bool VertexBasedCellPopulation< DIM >::IsPdeNodeAssociatedWithNonApoptoticCell ( unsigned  pdeNodeIndex)
virtual

Overridden IsPdeNodeAssociatedWithNonApoptoticCell() method.

Parameters
pdeNodeIndexinedx of a node in a tetrahedral mesh for use with a PDE modifier
Returns
if a node, specified by its index in a tetrahedral mesh for use with a PDE modifier, is associated with a non-apoptotic cell. This method can be called by PDE classes.

Reimplemented from AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 741 of file VertexBasedCellPopulation.cpp.

References AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::GetCellUsingLocationIndex(), VertexBasedCellPopulation< DIM >::GetNode(), and VertexBasedCellPopulation< DIM >::GetNumNodes().

◆ OpenWritersFiles()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::OpenWritersFiles ( OutputFileHandler rOutputFileHandler)
virtual

Overridden OpenWritersFiles() method.

Open all files in mCellPopulationWriters and mCellWriters for writing (not appending).

Parameters
rOutputFileHandlerhandler for the directory in which to open this file.

Reimplemented from AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 485 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mOutputCellRearrangementLocations, AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mOutputResultsForChasteVisualizer, and AbstractCellPopulation< ELEMENT_DIM, SPACE_DIM >::OpenWritersFiles().

◆ OutputCellPopulationParameters()

◆ RemoveDeadCells()

template<unsigned DIM>
unsigned VertexBasedCellPopulation< DIM >::RemoveDeadCells ( )
virtual

Remove all cells labelled as dead.

Note that after calling this method the cell population will be in an inconsistent state until the equivalent of a 'remesh' is performed! So don't try iterating over cells or anything like that.

Returns
number of cells removed
Todo:
(#2489) this should cause an error - we should fix this!

Implements AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 226 of file VertexBasedCellPopulation.cpp.

References MutableVertexMesh< ELEMENT_DIM, SPACE_DIM >::DeleteElementPriorToReMesh(), VertexBasedCellPopulation< DIM >::GetElement(), AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::GetLocationIndexUsingCell(), AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mCells, and VertexBasedCellPopulation< DIM >::mpMutableVertexMesh.

◆ rGetMesh() [1/2]

◆ rGetMesh() [2/2]

template<unsigned DIM>
const MutableVertexMesh< DIM, DIM > & VertexBasedCellPopulation< DIM >::rGetMesh ( ) const
Returns
const reference to mrMesh (used in archiving).

Definition at line 142 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mpMutableVertexMesh.

◆ serialize()

template<unsigned DIM>
template<class Archive >
void VertexBasedCellPopulation< DIM >::serialize ( Archive &  archive,
const unsigned int  version 
)
inlineprivate

◆ SetNode()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::SetNode ( unsigned  index,
ChastePoint< DIM > &  rNewLocation 
)

Overridden SetNode() method.

Move the node with a given index to a new point in space.

Parameters
indexthe index of the node to be moved
rNewLocationthe new target location of the node

Definition at line 185 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mpMutableVertexMesh, and MutableVertexMesh< ELEMENT_DIM, SPACE_DIM >::SetNode().

◆ SetOutputCellRearrangementLocations()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::SetOutputCellRearrangementLocations ( bool  outputCellRearrangementLocations)

Set mOutputCellRearrangementLocations.

Parameters
outputCellRearrangementLocationsthe new value of mOutputCellRearrangementLocations

Definition at line 525 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mOutputCellRearrangementLocations.

◆ SetRestrictVertexMovementBoolean()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::SetRestrictVertexMovementBoolean ( bool  restrictVertexMovement)

Set the value of the mRestrictVertexMovement boolean.

Parameters
restrictVertexMovementwhether to restrict vertex movement in this simulation.

Definition at line 852 of file VertexBasedCellPopulation.cpp.

References EXPORT_TEMPLATE_CLASS_SAME_DIMS, and VertexBasedCellPopulation< DIM >::mRestrictVertexMovement.

◆ SetVertexBasedDivisionRule()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::SetVertexBasedDivisionRule ( boost::shared_ptr< AbstractVertexBasedDivisionRule< DIM > >  pVertexBasedDivisionRule)

Set the division rule for this population.

Parameters
pVertexBasedDivisionRulepointer to the new division rule

Definition at line 569 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::mpVertexBasedDivisionRule.

◆ SimulationSetupHook()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::SimulationSetupHook ( AbstractCellBasedSimulation< DIM, DIM > *  pSimulation)
virtual

Overridden SimulationSetupHook() method.

Hook method to add a T2SwapCellKiller to a simulation object, which is always required in the case of a VertexBasedCellPopulation. This functionality avoids the need for static or dynamic casts to specific cell population types within simulation methods.

Note: In order to inhibit T2 swaps, the user needs to set the threshold for T2 swaps in the MutableVertexMesh object mrMesh to 0, using the SetT2Threshold() method.

Parameters
pSimulationpointer to a cell-based simulation object

Definition at line 838 of file VertexBasedCellPopulation.cpp.

References AbstractCellBasedSimulation< ELEMENT_DIM, SPACE_DIM >::AddCellKiller(), and MAKE_PTR_ARGS.

◆ Update()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::Update ( bool  hasHadBirthsOrDeaths = true)
virtual

Remove the VertexElements which have been marked as deleted, perform any cell rearrangements if required, and update the correspondence with CellPtrs.

Parameters
hasHadBirthsOrDeaths- a bool saying whether cell population has had Births Or Deaths not needed in this cell population class
Todo:
We want to make these maps private, so we need a better way of doing the code below.

Implements AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 294 of file VertexBasedCellPopulation.cpp.

References VertexMesh< ELEMENT_DIM, SPACE_DIM >::GetNumAllElements(), AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mCellLocationMap, AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mCells, AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mLocationCellMap, VertexBasedCellPopulation< DIM >::mpMutableVertexMesh, MutableVertexMesh< ELEMENT_DIM, SPACE_DIM >::ReMesh(), AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::SetCellUsingLocationIndex(), and VertexBasedCellPopulation< DIM >::Validate().

Referenced by HeterotypicBoundaryLengthWriter< ELEMENT_DIM, SPACE_DIM >::Visit().

◆ Validate()

◆ WriteDataToVisualizerSetupFile()

template<unsigned DIM>
void VertexBasedCellPopulation< DIM >::WriteDataToVisualizerSetupFile ( out_stream &  pVizSetupFile)
virtual

Overridden WriteDataToVisualizerSetupFile() method. Write any data necessary to a visualization setup file. Used by AbstractCellBasedSimulation::WriteVisualizerSetupFile().

Parameters
pVizSetupFilea visualization setup file

Reimplemented from AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >.

Definition at line 829 of file VertexBasedCellPopulation.cpp.

References VertexBasedCellPopulation< DIM >::GetWidth(), and AbstractCellPopulation< ELEMENT_DIM, ELEMENT_DIM >::mrMesh.

◆ WriteVtkResultsToFile()

Friends And Related Function Documentation

◆ TestVertexBasedDivisionRules

template<unsigned DIM>
friend class TestVertexBasedDivisionRules
friend

This test uses the private constructor to simplify testing.

Definition at line 65 of file VertexBasedCellPopulation.hpp.

Member Data Documentation

◆ mCellIdsOfT2Swaps

template<unsigned DIM>
std::vector< unsigned > VertexBasedCellPopulation< DIM >::mCellIdsOfT2Swaps
private

The Ids of cells that have undergone T2 swaps, stored so they can be accessed and output by the cell killer and population writer classes. The Ids are stored until they are cleared by ClearLocationsAndCellIdsOfT2Swaps().

Definition at line 96 of file VertexBasedCellPopulation.hpp.

Referenced by VertexBasedCellPopulation< DIM >::AddCellIdOfT2Swap(), VertexBasedCellPopulation< DIM >::ClearLocationsAndCellIdsOfT2Swaps(), and VertexBasedCellPopulation< DIM >::GetCellIdsOfT2Swaps().

◆ mDeleteMesh

template<unsigned DIM>
bool VertexBasedCellPopulation< DIM >::mDeleteMesh
private

Whether to delete the mesh when we are destroyed. Needed if this cell population has been de-serialized.

Definition at line 71 of file VertexBasedCellPopulation.hpp.

Referenced by VertexBasedCellPopulation< DIM >::~VertexBasedCellPopulation().

◆ mLocationsOfT2Swaps

template<unsigned DIM>
std::vector< c_vector<double, DIM> > VertexBasedCellPopulation< DIM >::mLocationsOfT2Swaps
private

Locations of T2 swaps (the centre of the removed triangle), stored so they can be accessed and output by the cell killer and population writer classes. The locations are stored until they are cleared by ClearLocationsAndCellIdsOfT2Swaps().

Definition at line 90 of file VertexBasedCellPopulation.hpp.

Referenced by VertexBasedCellPopulation< DIM >::AddLocationOfT2Swap(), VertexBasedCellPopulation< DIM >::ClearLocationsAndCellIdsOfT2Swaps(), and VertexBasedCellPopulation< DIM >::GetLocationsOfT2Swaps().

◆ mOutputCellRearrangementLocations

◆ mpMutableVertexMesh

◆ mpVertexBasedDivisionRule

◆ mRestrictVertexMovement

template<unsigned DIM>
bool VertexBasedCellPopulation< DIM >::mRestrictVertexMovement
private

◆ mThrowStepSizeException

template<unsigned DIM>
bool VertexBasedCellPopulation< DIM >::mThrowStepSizeException = true
private

Whether to throw StepSizeExceptions, which defaults to true but is made false after the first StepSizeException is thrown. In vertex based cell populations a StepSizeException is not considered terminal, so there is no need to throw more than one (as the numerical method uses WARN_ONCE_ONLY).

Definition at line 109 of file VertexBasedCellPopulation.hpp.

Referenced by VertexBasedCellPopulation< DIM >::CheckForStepSizeException().


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