AbstractMesh< ELEMENT_DIM, SPACE_DIM > Class Template Reference

#include <AbstractMesh.hpp>

Inheritance diagram for AbstractMesh< ELEMENT_DIM, SPACE_DIM >:

Collaboration diagram for AbstractMesh< ELEMENT_DIM, SPACE_DIM >:

Classes
class	NodeIterator

Public Types
typedef std::vector< Node < SPACE_DIM > * >::const_iterator	BoundaryNodeIterator

Public Member Functions
NodeIterator	GetNodeIteratorBegin (bool skipDeletedNodes=true)
NodeIterator	GetNodeIteratorEnd ()
	AbstractMesh ()
virtual	~AbstractMesh ()
virtual unsigned	GetNumNodes () const
unsigned	GetNumBoundaryNodes () const
virtual unsigned	GetNumAllNodes () const
unsigned	GetNumNodeAttributes () const
Node< SPACE_DIM > *	GetNode (unsigned index) const
virtual Node< SPACE_DIM > *	GetNodeOrHaloNode (unsigned index) const
Node< SPACE_DIM > *	GetNodeFromPrePermutationIndex (unsigned index) const
virtual void	ReadNodesPerProcessorFile (const std::string &rNodesPerProcessorFile)
virtual DistributedVectorFactory *	GetDistributedVectorFactory ()
virtual void	SetDistributedVectorFactory (DistributedVectorFactory *pFactory)
virtual void	PermuteNodes ()
BoundaryNodeIterator	GetBoundaryNodeIteratorBegin () const
BoundaryNodeIterator	GetBoundaryNodeIteratorEnd () const
std::string	GetMeshFileBaseName () const
bool	IsMeshOnDisk () const
const std::vector< unsigned > &	rGetNodePermutation () const
virtual c_vector< double, SPACE_DIM >	GetVectorFromAtoB (const c_vector< double, SPACE_DIM > &rLocationA, const c_vector< double, SPACE_DIM > &rLocationB)
double	GetDistanceBetweenNodes (unsigned indexA, unsigned indexB)
virtual double	GetWidth (const unsigned &rDimension) const
virtual ChasteCuboid< SPACE_DIM >	CalculateBoundingBox () const
virtual unsigned	GetNearestNodeIndex (const ChastePoint< SPACE_DIM > &rTestPoint)
virtual void	Scale (const double xFactor=1.0, const double yFactor=1.0, const double zFactor=1.0)
virtual void	Translate (const c_vector< double, SPACE_DIM > &rDisplacement)
void	Translate (const double xMovement=0.0, const double yMovement=0.0, const double zMovement=0.0)
virtual void	Rotate (c_matrix< double, SPACE_DIM, SPACE_DIM > rotationMatrix)
void	Rotate (c_vector< double, 3 > axis, double angle)
void	RotateX (const double theta)
void	RotateY (const double theta)
void	RotateZ (const double theta)
void	Rotate (double theta)
virtual void	RefreshMesh ()
bool	IsMeshChanging () const
unsigned	CalculateMaximumContainingElementsPerProcess () const
void	SetMeshHasChangedSinceLoading ()

Protected Member Functions
virtual void	SetElementOwnerships ()
ChasteCuboid< SPACE_DIM >	CalculateBoundingBox (const std::vector< Node< SPACE_DIM > * > &rNodes) const

Protected Attributes
std::vector< Node< SPACE_DIM > * >	mNodes
std::vector< Node< SPACE_DIM > * >	mBoundaryNodes
DistributedVectorFactory *	mpDistributedVectorFactory
std::vector< unsigned >	mNodePermutation
std::string	mMeshFileBaseName
bool	mMeshChangesDuringSimulation

Private Member Functions
virtual unsigned	SolveNodeMapping (unsigned index) const =0
template<class Archive >
void	serialize (Archive &archive, const unsigned int version)

Friends
class	TestDistributedTetrahedralMesh
template<unsigned A_DIMENSION>
class	NodesOnlyMesh
template<unsigned A_DIMENSION>
class	QuadraticMeshHelper
class	boost::serialization::access

Detailed Description

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>
class AbstractMesh< ELEMENT_DIM, SPACE_DIM >

Abstract base class for all meshes.

Definition at line 60 of file AbstractMesh.hpp.

Member Typedef Documentation

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

typedef std::vector<Node<SPACE_DIM> *>::const_iterator AbstractMesh< ELEMENT_DIM, SPACE_DIM >::BoundaryNodeIterator

Definition of boundary node Iterator type.

Definition at line 148 of file AbstractMesh.hpp.

Constructor & Destructor Documentation

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

AbstractMesh< ELEMENT_DIM, SPACE_DIM >::AbstractMesh

(

)

Constructor.

Definition at line 44 of file AbstractMesh.cpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

AbstractMesh< ELEMENT_DIM, SPACE_DIM >::~AbstractMesh ( )

virtual

Virtual destructor, since this class has virtual methods.

Definition at line 52 of file AbstractMesh.cpp.

Member Function Documentation

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

ChasteCuboid< SPACE_DIM > AbstractMesh< ELEMENT_DIM, SPACE_DIM >::CalculateBoundingBox ( const std::vector< Node< SPACE_DIM > * > &  rNodes ) const

protected

Calculate a bounding box from a set of nodes. A generalised version of the public CalculateBoundingBox method.

Parameters

rNodes

the list of nodes to calculate the bounding box for.

Returns

the bounding box in the form of a ChasteCuboid.

Todo:

#1322 use a const version of NodeIterator here

Definition at line 227 of file AbstractMesh.cpp.

Referenced by Electrodes< DIM >::Electrodes(), and FineCoarseMeshPair< DIM >::SetUpBoxes().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

ChasteCuboid< SPACE_DIM > AbstractMesh< ELEMENT_DIM, SPACE_DIM >::CalculateBoundingBox ( ) const

virtual

Calculate the bounding box (width extremes for all dimensions of the mesh). Overridden in distributed case

Returns

The minimum and maximum co-ordinates of any node in each dimension

Reimplemented in DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, and DistributedTetrahedralMesh< DIM, DIM >.

Definition at line 277 of file AbstractMesh.cpp.

Referenced by DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::CalculateBoundingBox(), and Cylindrical2dMesh::UpdateTopAndBottom().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

unsigned AbstractMesh< ELEMENT_DIM, SPACE_DIM >::CalculateMaximumContainingElementsPerProcess

(

)

const

Returns

Iterates through local nodes and finds the maximum number of containing elements for all locally owned nodes Useful for determining FEM matrix fill.

Definition at line 489 of file AbstractMesh.cpp.

Referenced by AbstractTetrahedralMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteNclFile().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

AbstractMesh< ELEMENT_DIM, SPACE_DIM >::BoundaryNodeIterator AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetBoundaryNodeIteratorBegin

(

)

const

Returns

a pointer to the first boundary node in the mesh.

Definition at line 169 of file AbstractMesh.cpp.

Referenced by EllipticGrowingDomainPdeModifier< DIM >::ConstructBoundaryConditionsContainer(), ParabolicGrowingDomainPdeModifier< DIM >::ConstructBoundaryConditionsContainer(), ParabolicBoxDomainPdeModifier< DIM >::ConstructBoundaryConditionsContainer(), EllipticBoxDomainPdeModifier< DIM >::ConstructBoundaryConditionsContainer(), BoundaryConditionsContainer< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::DefineConstantDirichletOnMeshBoundary(), and PapillaryFibreCalculator::GetRadiusVectorForOneElement().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

AbstractMesh< ELEMENT_DIM, SPACE_DIM >::BoundaryNodeIterator AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetBoundaryNodeIteratorEnd

(

)

const

Returns

a pointer to *one past* the last boundary node in the mesh (for consistency with STL iterators).

Definition at line 175 of file AbstractMesh.cpp.

Referenced by BoundaryConditionsContainer< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::DefineConstantDirichletOnMeshBoundary(), and PapillaryFibreCalculator::GetRadiusVectorForOneElement().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

double AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetDistanceBetweenNodes	(	unsigned	indexA,
		unsigned	indexB
	)

Return the distance between two nodes.

This method calls GetVectorFromAtoB(), which is overridden in some daughter classes (e.g. Cylindrical2dMesh).

Parameters

indexA	a node index
indexB	a node index

Returns

distance between two nodes.

Definition at line 212 of file AbstractMesh.cpp.

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

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

DistributedVectorFactory * AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetDistributedVectorFactory ( )

virtual

Returns

the DistributedVectorFactory.

Definition at line 133 of file AbstractMesh.cpp.

References PetscTools::IsParallel().

Referenced by NodePartitioner< ELEMENT_DIM, SPACE_DIM >::DumbPartitioning(), Hdf5ToTxtConverter< ELEMENT_DIM, SPACE_DIM >::Hdf5ToTxtConverter(), Hdf5ToVtkConverter< ELEMENT_DIM, SPACE_DIM >::Hdf5ToVtkConverter(), and VoltageInterpolaterOntoMechanicsMesh< DIM >::VoltageInterpolaterOntoMechanicsMesh().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

std::string AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetMeshFileBaseName

(

)

const

Returns

mMeshFileBaseName.

Definition at line 181 of file AbstractMesh.cpp.

References EXCEPTION.

Referenced by AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

unsigned AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNearestNodeIndex ( const ChastePoint< SPACE_DIM > &  rTestPoint )

virtual

GetNearestNodeIndex iterates through all nodes in the mesh and returns the global index with the smallest distance to the provided point.

This method is overridden in the distributed case to return the global node index.

This method uses GetVectorFromAtoB distance and hence may return a correct solution in non-Euclidean space, but only if this method is overridden in a subclass (see e.g. Cylindrical2dMesh for an example of this).

Parameters

rTestPoint

reference to the point

Returns

node index

Reimplemented in DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, and DistributedTetrahedralMesh< DIM, DIM >.

Definition at line 285 of file AbstractMesh.cpp.

References ChastePoint< DIM >::rGetLocation().

Referenced by DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::GetNearestNodeIndex().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

Node< SPACE_DIM > * AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNode

(

unsigned

index

)

const

Get the node with a given index in the mesh.

Parameters

index

the global index of the node

Returns

a pointer to the node.

Definition at line 93 of file AbstractMesh.cpp.

Referenced by AbstractTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::ConstructFromMesh(), ExtendedBidomainTissue< SPACE_DIM >::ExtendedBidomainTissue(), CryptCellsGenerator< CELL_CYCLE_MODEL >::Generate(), HoneycombMeshGenerator::GetCircularMesh(), Cylindrical2dVertexMesh::GetMeshForVtk(), Toroidal2dVertexMesh::GetMeshForVtk(), NonlinearElasticityTools< DIM >::GetNodesByComponentValue(), PapillaryFibreCalculator::GetRadiusVectorForOneElement(), VertexMeshWriter< ELEMENT_DIM, SPACE_DIM >::MakeVtkMesh(), Cylindrical2dNodesOnlyMesh::SetNode(), Cylindrical2dMesh::UseTheseElementsToDecideMeshing(), and DiscreteSystemForceCalculator::WriteResultsToFile().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

Node< SPACE_DIM > * AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNodeFromPrePermutationIndex

(

unsigned

index

)

const

Get the node with a given index in the mesh, prior to any node permutation being applied. For non-permuted meshes, this will have the same effect as GetNode.

This method is intended for use by the archiving code, to enable checkpoint migration, so that we can load the correct cells and boundary conditions after the mesh has been re-partitioned.

If unsure, use GetNode in preference to this method!

Parameters

index

the global index of the node prior to a permutation being applied

Returns

a pointer to the node

Definition at line 106 of file AbstractMesh.cpp.

Referenced by BoundaryConditionsContainer< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::MergeFromArchive().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

AbstractMesh< ELEMENT_DIM, SPACE_DIM >::NodeIterator AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNodeIteratorBegin ( bool  skipDeletedNodes = true )

inline

Returns

an iterator to the first node in the mesh.

Parameters

skipDeletedNodes

whether to include deleted nodes

Definition at line 531 of file AbstractMesh.hpp.

Referenced by AbstractCentreBasedCellPopulation< ELEMENT_DIM, SPACE_DIM >::AbstractCentreBasedCellPopulation(), VertexCryptBoundaryForce< DIM >::AddForceContribution(), DiffusionForce< DIM >::AddForceContribution(), AbstractContinuumMechanicsSolver< DIM >::AllocateMatrixMemory(), BidomainProblem< DIM >::AnalyseMeshForBath(), MeshBasedCellPopulationWithGhostNodes< DIM >::ApplyGhostForces(), ElectrodesStimulusFactory< DIM >::ComputeElectrodeTotalFlux(), Cylindrical2dMesh::CreateMirrorNodes(), Electrodes< DIM >::Electrodes(), NodeBasedCellPopulationWithParticles< DIM >::GetParticleIndices(), NodeBasedCellPopulation< DIM >::GetTetrahedralMeshForPdeModifier(), NodeBasedCellPopulationWithParticles< DIM >::NodeBasedCellPopulationWithParticles(), VtkMeshWriter< ELEMENT_DIM, SPACE_DIM >::SetParallelFiles(), NodeBasedCellPopulationWithParticles< DIM >::SetParticles(), ParabolicGrowingDomainPdeModifier< DIM >::UpdateSolutionVector(), NodeBasedCellPopulationWithParticles< DIM >::Validate(), NodeBasedCellPopulation< DIM >::Validate(), NodeVelocityWriter< ELEMENT_DIM, SPACE_DIM >::Visit(), XdmfMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteFilesUsingMesh(), VtkMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteFilesUsingMesh(), AbstractTetrahedralMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteNclFile(), PottsBasedCellPopulation< DIM >::WriteVtkResultsToFile(), and NodeBasedCellPopulationWithParticles< DIM >::WriteVtkResultsToFile().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

AbstractMesh< ELEMENT_DIM, SPACE_DIM >::NodeIterator AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNodeIteratorEnd ( )

inline

Returns

an iterator to one past the last node in the mesh.

Definition at line 538 of file AbstractMesh.hpp.

Referenced by NodeBasedCellPopulationWithParticles< DIM >::AcceptCellWritersAcrossPopulation(), MeshBasedCellPopulationWithGhostNodes< DIM >::AcceptCellWritersAcrossPopulation(), VertexCryptBoundaryForce< DIM >::AddForceContribution(), DiffusionForce< DIM >::AddForceContribution(), Cylindrical2dMesh::CreateMirrorNodes(), Electrodes< DIM >::Electrodes(), NodeBasedCellPopulationWithParticles< DIM >::NodeBasedCellPopulationWithParticles(), VtkMeshWriter< ELEMENT_DIM, SPACE_DIM >::SetParallelFiles(), NodeVelocityWriter< ELEMENT_DIM, SPACE_DIM >::Visit(), XdmfMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteFilesUsingMesh(), VtkMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteFilesUsingMesh(), and AbstractTetrahedralMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteNclFile().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

Node< SPACE_DIM > * AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNodeOrHaloNode ( unsigned  index ) const

virtual

Get the node with a given index in the mesh (synonym of GetNode() unless overridden in a distributed mesh).

Parameters

index

the global index of the node

Returns

a pointer to the node.

Reimplemented in DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, DistributedTetrahedralMesh< DIM, DIM >, NodesOnlyMesh< SPACE_DIM >, NodesOnlyMesh< DIM >, and NodesOnlyMesh< 2 >.

Definition at line 100 of file AbstractMesh.cpp.

Referenced by QuadraticMeshHelper< DIM >::AddInternalNodesToElements().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

unsigned AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNumAllNodes ( ) const

virtual

Returns

the total number of nodes (including those marked as deleted).

Reimplemented in DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, and DistributedTetrahedralMesh< DIM, DIM >.

Definition at line 78 of file AbstractMesh.cpp.

Referenced by TetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::ExportToMesher(), HoneycombMeshGenerator::GetCircularMesh(), Cylindrical2dMesh::ReMesh(), Cylindrical2dMesh::UseTheseElementsToDecideMeshing(), and AbstractTetrahedralMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteNclFile().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

unsigned AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNumBoundaryNodes

(

)

const

Returns

the number of boundary nodes in the mesh.

Definition at line 72 of file AbstractMesh.cpp.

Referenced by BoundaryConditionsContainer< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::DefineConstantDirichletOnMeshBoundary().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

unsigned AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNumNodeAttributes

(

)

const

Returns

the number of attributes on each node. Note, this implementation assumes that all nodes have the same number of attributes so that the first node in the container is indicative of the others.

Definition at line 84 of file AbstractMesh.cpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

unsigned AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetNumNodes ( ) const

virtual

Returns

the number of nodes that are actually in use.

Overridden in MutableMesh and DistributedTetrahedralMesh.

Reimplemented in MutableVertexMesh< ELEMENT_DIM, SPACE_DIM >, MutableVertexMesh< 2, 2 >, MutableVertexMesh< DIM, DIM >, NodesOnlyMesh< SPACE_DIM >, NodesOnlyMesh< DIM >, NodesOnlyMesh< 2 >, VertexMesh< ELEMENT_DIM, SPACE_DIM >, VertexMesh< ELEMENT_DIM, ELEMENT_DIM >, VertexMesh< 2, 2 >, VertexMesh< DIM, DIM >, PottsMesh< DIM >, PottsMesh< SPACE_DIM >, MutableMesh< ELEMENT_DIM, SPACE_DIM >, MutableMesh< ELEMENT_DIM, ELEMENT_DIM >, MutableMesh< 2, 2 >, MutableMesh< DIM, DIM >, MutableMesh< SPACE_DIM, SPACE_DIM >, DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, and DistributedTetrahedralMesh< DIM, DIM >.

Definition at line 66 of file AbstractMesh.cpp.

Referenced by AbstractContinuumMechanicsSolver< DIM >::AbstractContinuumMechanicsSolver(), CaBasedCellPopulation< DIM >::CaBasedCellPopulation(), AbstractFunctionalCalculator< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::Calculate(), CardiacElectroMechProbRegularGeom< DIM >::CardiacElectroMechProbRegularGeom(), CmguiDeformedSolutionsWriter< DIM >::CmguiDeformedSolutionsWriter(), CuboidMeshConstructor< ELEMENT_DIM, SPACE_DIM >::Construct(), AbstractTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::ConstructFromMesh(), NodePartitioner< ELEMENT_DIM, SPACE_DIM >::DumbPartitioning(), TetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::ExportToMesher(), CryptCellsGenerator< CELL_CYCLE_MODEL >::Generate(), NonlinearElasticityTools< DIM >::GetNodesByComponentValue(), Hdf5ToTxtConverter< ELEMENT_DIM, SPACE_DIM >::Hdf5ToTxtConverter(), Hdf5ToVtkConverter< ELEMENT_DIM, SPACE_DIM >::Hdf5ToVtkConverter(), StreeterFibreGenerator< SPACE_DIM >::StreeterFibreGenerator(), VoltageInterpolaterOntoMechanicsMesh< DIM >::VoltageInterpolaterOntoMechanicsMesh(), XdmfMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteFilesUsingMesh(), AbstractTetrahedralMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteFilesUsingMesh(), AbstractTetrahedralMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteNclFile(), and DiscreteSystemForceCalculator::WriteResultsToFile().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

c_vector< double, SPACE_DIM > AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetVectorFromAtoB ( const c_vector< double, SPACE_DIM > &  rLocationA, const c_vector< double, SPACE_DIM > &  rLocationB  )

virtual

Returns

a vector between two points in space.

This method is overridden in some daughter classes (e.g. Cylindrical2dMesh).

Parameters

rLocationA	a c_vector of coordinates
rLocationB	a c_vector of coordinates

Returns

c_vector from location A to location B.

Reimplemented in VertexMesh< ELEMENT_DIM, SPACE_DIM >, VertexMesh< ELEMENT_DIM, ELEMENT_DIM >, VertexMesh< 2, 2 >, and VertexMesh< DIM, DIM >.

Definition at line 204 of file AbstractMesh.cpp.

Referenced by CryptStatistics::CellIsInSection(), CryptStatistics::CellIsInSectionPeriodic(), and VertexMesh< ELEMENT_DIM, SPACE_DIM >::GetVectorFromAtoB().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

double AbstractMesh< ELEMENT_DIM, SPACE_DIM >::GetWidth ( const unsigned &  rDimension ) const

virtual

Calculate the 'width' of any dimension of the mesh.

This method is overridden in some daughter classes (e.g. Cylindrical2dMesh).

Parameters

rDimension

a dimension (0,1 or 2)

Returns

The maximum distance between any nodes in this dimension.

Reimplemented in NodesOnlyMesh< SPACE_DIM >, NodesOnlyMesh< DIM >, NodesOnlyMesh< 2 >, Cylindrical2dMesh, Cylindrical2dVertexMesh, Toroidal2dVertexMesh, and Cylindrical2dNodesOnlyMesh.

Definition at line 220 of file AbstractMesh.cpp.

Referenced by CryptStatistics::CellIsInSectionPeriodic(), CryptStatistics::GetCryptSection(), Cylindrical2dNodesOnlyMesh::GetWidth(), Cylindrical2dVertexMesh::GetWidth(), Cylindrical2dMesh::GetWidth(), and NodesOnlyMesh< SPACE_DIM >::GetWidth().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

bool AbstractMesh< ELEMENT_DIM, SPACE_DIM >::IsMeshChanging

(

)

const

Returns

Whether the mesh changes (used in archiving).

Definition at line 483 of file AbstractMesh.cpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

bool AbstractMesh< ELEMENT_DIM, SPACE_DIM >::IsMeshOnDisk

(

)

const

Get whether this mesh was read from file.

Returns

whether this mesh was read from file

Definition at line 192 of file AbstractMesh.cpp.

Referenced by AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::PermuteNodes ( )

virtual

Permute the nodes so that they appear in a different order in mNodes (and their mIndex's are altered accordingly).

Reimplemented in TetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, TetrahedralMesh< DIM, DIM >, and TetrahedralMesh< 3, 3 >.

Definition at line 162 of file AbstractMesh.cpp.

References NEVER_REACHED.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::ReadNodesPerProcessorFile ( const std::string &  rNodesPerProcessorFile )

virtual

Read in the number of nodes per processor from file.

Parameters

rNodesPerProcessorFile

the name of the file

Reimplemented in TetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, TetrahedralMesh< DIM, DIM >, and TetrahedralMesh< 3, 3 >.

Definition at line 120 of file AbstractMesh.cpp.

References NEVER_REACHED.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::RefreshMesh ( )

virtual

This method allows the mesh properties to be re-calculated after one or more nodes have been moved.

Reimplemented in TetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, TetrahedralMesh< DIM, DIM >, TetrahedralMesh< 3, 3 >, and Cylindrical2dNodesOnlyMesh.

Definition at line 478 of file AbstractMesh.cpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

const std::vector< unsigned > & AbstractMesh< ELEMENT_DIM, SPACE_DIM >::rGetNodePermutation

(

)

const

Returns

mNodePermutation.

When empty (most meshes) there is no node permutation When non-empty (parallel distributed meshes) then for a given original_index mNodePermutation[original_index] holds the new assigned index of that node in memory

Definition at line 198 of file AbstractMesh.cpp.

Referenced by QuadraticMeshHelper< DIM >::AddInternalNodesToElements(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save(), and AbstractTetrahedralMeshWriter< ELEMENT_DIM, SPACE_DIM >::WriteNclFile().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::Rotate ( c_matrix< double, SPACE_DIM, SPACE_DIM >  rotationMatrix )

virtual

Do a general mesh rotation with a positive determinant orthonormal rotation matrix. This is the rotation method that actually does the work. Should be overridden when the child class has halo nodes.

Parameters

rotationMatrix

is a Ublas rotation matrix of the correct form

Reimplemented in DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, and DistributedTetrahedralMesh< DIM, DIM >.

Definition at line 383 of file AbstractMesh.cpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::Rotate	(	c_vector< double, 3 >	axis,
		double	angle
	)

Do an angle axis rotation.

Parameters

axis	is the axis of rotation (does not need to be normalised)
angle	is the angle of rotation in radians

Definition at line 397 of file AbstractMesh.cpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::Rotate

(

double

theta

)

Rotating a 2D mesh equates that rotation around the z-axis.

Parameters

theta

is the angle of rotation in radians

Definition at line 472 of file AbstractMesh.cpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::RotateX

(

const double

theta

)

Rotate the mesh about the x-axis.

Parameters

theta

is the angle of rotation in radians

Definition at line 422 of file AbstractMesh.cpp.

References EXCEPTION.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::RotateY

(

const double

theta

)

Rotate the mesh about the y-axis.

Parameters

theta

is the angle of rotation in radians

Definition at line 438 of file AbstractMesh.cpp.

References EXCEPTION.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::RotateZ

(

const double

theta

)

Rotate the mesh about the z-axis.

Parameters

theta

is the angle of rotation in radians

Definition at line 455 of file AbstractMesh.cpp.

References EXCEPTION.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::Scale ( const double  xFactor = 1.0, const double  yFactor = 1.0, const double  zFactor = 1.0  )

virtual

Scale the mesh.

Parameters

xFactor	is the scale in the x-direction (defaults to 1.0)
yFactor	is the scale in the y-direction (defaults to 1.0)
zFactor	is the scale in the z-direction (defaults to 1.0)

Reimplemented in DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, DistributedTetrahedralMesh< DIM, DIM >, and Cylindrical2dVertexMesh.

Definition at line 322 of file AbstractMesh.cpp.

Referenced by HoneycombVertexMeshGenerator::HoneycombVertexMeshGenerator(), Cylindrical2dVertexMesh::Scale(), and DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::Scale().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

template<class Archive >

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::serialize ( Archive &  archive, const unsigned int  version  )

inlineprivate

Serialize the mesh.

Parameters

archive	the archive
version	the current version of this class

Definition at line 87 of file AbstractMesh.hpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::SetDistributedVectorFactory ( DistributedVectorFactory *  pFactory )

virtual

Set method for mpDistributedVectorFactory. Must be called before the mesh is used for anything. This only actually impacts the DistributedTetrahedralMesh subclass, in which the supplied factory is then used to specify the node distribution among the processes.

Parameters

pFactory

a factory to use for this mesh

Reimplemented in DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, and DistributedTetrahedralMesh< DIM, DIM >.

Definition at line 147 of file AbstractMesh.cpp.

References EXCEPTION, PetscTools::GetNumProcs(), and DistributedVectorFactory::GetNumProcs().

Referenced by AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::load(), and DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::SetDistributedVectorFactory().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::SetElementOwnerships ( )

protectedvirtual

Does nothing. Used in derived classes which have elements

Reimplemented in AbstractTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, AbstractTetrahedralMesh< ELEMENT_DIM, ELEMENT_DIM >, AbstractTetrahedralMesh< DIM, DIM >, AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >, DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, and DistributedTetrahedralMesh< DIM, DIM >.

Definition at line 127 of file AbstractMesh.cpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::SetMeshHasChangedSinceLoading

(

)

Set whether the mesh has been modified since it was read from file. This prevents the archiving code just blithely storing the original, unmodified, mesh.

Definition at line 504 of file AbstractMesh.cpp.

Referenced by CylindricalHoneycombMeshGenerator::CylindricalHoneycombMeshGenerator(), VertexBasedCellPopulation< SPACE_DIM >::GetTetrahedralMeshForPdeModifier(), HoneycombMeshGenerator::HoneycombMeshGenerator(), and MeshBasedCellPopulation< ELEMENT_DIM, SPACE_DIM >::Update().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

virtual unsigned AbstractMesh< ELEMENT_DIM, SPACE_DIM >::SolveNodeMapping ( unsigned  index ) const

privatepure virtual

Pure virtual solve node mapping method. For a node with a given global index, get the local index used by this process.

Overridden in TetrahedralMesh DistributedTetrahedralMesh and Vertex Mesh classes.

Parameters

index

the global index of the node

Returns

local index

Implemented in DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, DistributedTetrahedralMesh< DIM, DIM >, NodesOnlyMesh< SPACE_DIM >, NodesOnlyMesh< DIM >, NodesOnlyMesh< 2 >, VertexMesh< ELEMENT_DIM, SPACE_DIM >, VertexMesh< ELEMENT_DIM, ELEMENT_DIM >, VertexMesh< 2, 2 >, VertexMesh< DIM, DIM >, TetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, TetrahedralMesh< DIM, DIM >, TetrahedralMesh< 3, 3 >, PottsMesh< DIM >, and PottsMesh< SPACE_DIM >.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::Translate ( const c_vector< double, SPACE_DIM > &  rDisplacement )

virtual

Translate the mesh given the displacement vector. This is the translation method that actually does the work. Should be overridden when the child class has halo nodes.

Parameters

rDisplacement

is a translation vector of the correct size

Reimplemented in DistributedTetrahedralMesh< ELEMENT_DIM, SPACE_DIM >, and DistributedTetrahedralMesh< DIM, DIM >.

Definition at line 369 of file AbstractMesh.cpp.

Referenced by HoneycombMeshGenerator::GetCircularMesh().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

void AbstractMesh< ELEMENT_DIM, SPACE_DIM >::Translate	(	const double	xMovement = 0.0,
		const double	yMovement = 0.0,
		const double	zMovement = 0.0
	)

Translate the mesh given the coordinate displacements separately.

Parameters

xMovement	is the x-displacement (defaults to 0.0)
yMovement	is the y-displacement (defaults to 0.0)
zMovement	is the z-displacement (defaults to 0.0)

Definition at line 344 of file AbstractMesh.cpp.

Friends And Related Function Documentation

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

friend class boost::serialization::access

friend

Needed for serialization.

Definition at line 79 of file AbstractMesh.hpp.

Member Data Documentation

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

std::vector<Node<SPACE_DIM> *> AbstractMesh< ELEMENT_DIM, SPACE_DIM >::mBoundaryNodes

protected

Vector of pointers to boundary nodes in the mesh.

Definition at line 99 of file AbstractMesh.hpp.

Referenced by QuadraticMeshHelper< DIM >::AddNodeToBoundaryElement(), and TetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::ImportFromMesher().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

bool AbstractMesh< ELEMENT_DIM, SPACE_DIM >::mMeshChangesDuringSimulation

protected

Whether this mesh changes during simulation (used to know whether to write a new one to file)

Definition at line 125 of file AbstractMesh.hpp.

Referenced by Toroidal2dVertexMesh::ConstructFromMeshReader(), Cylindrical2dVertexMesh::Cylindrical2dVertexMesh(), MutableMesh< ELEMENT_DIM, SPACE_DIM >::MutableMesh(), MutableVertexMesh< ELEMENT_DIM, SPACE_DIM >::MutableVertexMesh(), AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save(), AbstractMesh< SPACE_DIM, SPACE_DIM >::serialize(), and VertexMesh< ELEMENT_DIM, SPACE_DIM >::VertexMesh().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

std::string AbstractMesh< ELEMENT_DIM, SPACE_DIM >::mMeshFileBaseName

protected

If the mesh is constructed from file using a MeshReader, this member variable stores the base name of these files.

Definition at line 120 of file AbstractMesh.hpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

std::vector<unsigned> AbstractMesh< ELEMENT_DIM, SPACE_DIM >::mNodePermutation

protected

Vector containing node permutation information.

When empty (most meshes) there is no node permutation When non-empty (parallel distributed meshes) then for a given original_index mNodePermutation[original_index] holds the new assigned index of that node in memory

Definition at line 114 of file AbstractMesh.hpp.

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

std::vector<Node<SPACE_DIM> *> AbstractMesh< ELEMENT_DIM, SPACE_DIM >::mNodes

protected

Vector of pointers to nodes in the mesh.

Definition at line 96 of file AbstractMesh.hpp.

Referenced by Toroidal2dVertexMesh::ConstructFromMeshReader(), NodesOnlyMesh< SPACE_DIM >::ConstructNodesWithoutMesh(), Cylindrical2dMesh::CreateMirrorNodes(), Cylindrical2dMesh::Cylindrical2dMesh(), Cylindrical2dVertexMesh::Cylindrical2dVertexMesh(), TetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::ExportToMesher(), TetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::ImportFromMesher(), MutableMesh< SPACE_DIM, SPACE_DIM >::load(), NodesOnlyMesh< 2 >::load(), MutableVertexMesh< ELEMENT_DIM, SPACE_DIM >::MutableVertexMesh(), AbstractMesh< ELEMENT_DIM, SPACE_DIM >::NodeIterator::NodeIterator(), Cylindrical2dMesh::ReconstructCylindricalMesh(), Cylindrical2dNodesOnlyMesh::RefreshMesh(), Cylindrical2dMesh::ReMesh(), MutableMesh< SPACE_DIM, SPACE_DIM >::save(), TetrahedralMesh< ELEMENT_DIM, SPACE_DIM >::SolveNodeMapping(), and VertexMesh< ELEMENT_DIM, SPACE_DIM >::VertexMesh().

template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>

DistributedVectorFactory* AbstractMesh< ELEMENT_DIM, SPACE_DIM >::mpDistributedVectorFactory

protected

DistributedVectorFactory capable of reproducing the given number of nodes owned by each processor.

Definition at line 105 of file AbstractMesh.hpp.

Referenced by AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::load(), and AbstractMesh< SPACE_DIM, SPACE_DIM >::serialize().

---

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

• mesh/src/common/AbstractMesh.hpp
• mesh/src/common/AbstractMesh.cpp