TriangleMeshReader reads a mesh stored in Shewchuk's Triangle format. More...

Inheritance diagram for Sundance::TriangleMeshReader:

Public Member Functions
	TriangleMeshReader (const std::string &filename, const MeshType &meshType, const MPIComm &comm=MPIComm::world())
	TriangleMeshReader (const ParameterList &params)
	Construct from a ParameterList.
virtual	~TriangleMeshReader ()
	virtual dtor
virtual Mesh	fillMesh () const
	Create a mesh.
virtual std::string	description () const
	Print a short descriptive std::string.
virtual RCP< MeshSourceBase >	getRcp ()
	Return a ref count pointer to self.
Private Member Functions
void	readParallelInfo (Array< int > &ptGID, Array< int > &ptOwner, Array< int > &elemGID, Array< int > &elemOwner) const
Mesh	readNodes (Array< int > &ptGID, Array< int > &ptOwner) const
void	readSides (Mesh &mesh) const
void	readElems (Mesh &mesh, const Array< int > &nodeGID, Array< int > &elemGID, Array< int > &elemOwner) const
Private Attributes
std::string	nodeFilename_
std::string	elemFilename_
std::string	parFilename_
std::string	sideFilename_
int	offset_

Detailed Description

TriangleMeshReader reads a mesh stored in Shewchuk's Triangle format.

This format is documented at the Triangle homepage. This reader expects to find node information in .node files and element information in .ele files. The filename constructor argument is the stem of the filenames, and so that a reader constructed with filename joe will look for node and element data in joe.node and joe.ele respectively. Node and element attributes are read if present, and can be accessed with the getAttributes() method of MeshSource.

Parallel extensions

We have extended the Triangle format to deal with distributed meshes. A TriangleMeshReader is constructed with an MPIComm object, and if that communicator has more than one processor the mesh is assumed to be split into files, one for each processor. Data on mesh "joe" for the nnn-th processor will be found in the files

joe.node.nnn
joe.ele.nnn
joe.par.nnn

The .node.nnn and .ele.nnn files contain the node and element data for the part of the mesh seen by the nnn-th processor. The node and element numberings given in those two files are local indexes. The .par.nnn contains node and element ownership information for the part of the mesh seen by the nnn-th processor.

A .par file is formatted as follows:

First line: rank numProcs
Second line: numPoints
Next nPoints lines: ptLID ptGID ptOwnerRank
Next line: numElems
Next nElems lines: elemLID elemGID elemOwnerRank

Definition at line 89 of file SundanceTriangleMeshReader.hpp.

Constructor & Destructor Documentation

TriangleMeshReader::TriangleMeshReader	(	const std::string &	filename,
		const MeshType &	meshType,
		const MPIComm &	comm = `MPIComm::world()`
	)

Definition at line 12 of file SundanceTriangleMeshReader.cpp.

References Sundance::ObjectWithClassVerbosity< MeshSourceBase >::classVerbosity(), elemFilename_, Sundance::MeshSourceBase::myRank(), nodeFilename_, Sundance::MeshSourceBase::nProc(), parFilename_, Sundance::DefaultObjectWithVerbosity::setVerbosity(), sideFilename_, SUNDANCE_OUT, Sundance::toString(), and Sundance::DefaultObjectWithVerbosity::verb().

TriangleMeshReader::TriangleMeshReader ( const ParameterList & params )

Construct from a ParameterList.

Definition at line 47 of file SundanceTriangleMeshReader.cpp.

References Sundance::ObjectWithClassVerbosity< MeshSourceBase >::classVerbosity(), elemFilename_, Sundance::MeshSourceBase::myRank(), nodeFilename_, Sundance::MeshSourceBase::nProc(), parFilename_, Sundance::DefaultObjectWithVerbosity::setVerbosity(), SUNDANCE_OUT, Sundance::toString(), and Sundance::DefaultObjectWithVerbosity::verb().

virtual Sundance::TriangleMeshReader::~TriangleMeshReader ( ) [inline, virtual]

virtual dtor

Definition at line 101 of file SundanceTriangleMeshReader.hpp.

Member Function Documentation

virtual std::string Sundance::TriangleMeshReader::description ( ) const [inline, virtual]

Print a short descriptive std::string.

Reimplemented from Sundance::MeshSourceBase.

Definition at line 108 of file SundanceTriangleMeshReader.hpp.

References Sundance::MeshReaderBase::filename().

Mesh TriangleMeshReader::fillMesh ( ) const [virtual]

Create a mesh.

Implements Sundance::MeshSourceBase.

Definition at line 77 of file SundanceTriangleMeshReader.cpp.

References readElems(), readNodes(), readParallelInfo(), and readSides().

virtual RCP<MeshSourceBase> Sundance::TriangleMeshReader::getRcp ( ) [inline, virtual]

Return a ref count pointer to self.

Implements Sundance::Handleable< MeshSourceBase >.

Definition at line 113 of file SundanceTriangleMeshReader.hpp.

void TriangleMeshReader::readElems	(	Mesh &	mesh,
		const Array< int > &	nodeGID,
		Array< int > &	elemGID,
		Array< int > &	elemOwner
	)		const `[private]`

Definition at line 346 of file SundanceTriangleMeshReader.cpp.

References Sundance::Mesh::addElement(), Sundance::MeshReaderBase::atof(), Sundance::MeshReaderBase::atoi(), Sundance::MeshSourceBase::elemAttributes(), elemFilename_, Sundance::MeshReaderBase::getNextLine(), Sundance::MeshSourceBase::nProc(), offset_, Sundance::MeshReaderBase::openFile(), parFilename_, Sundance::Mesh::spatialDim(), and SUNDANCE_TRACE.

Referenced by fillMesh().

Mesh TriangleMeshReader::readNodes	(	Array< int > &	ptGID,
		Array< int > &	ptOwner
	)		const `[private]`

Definition at line 223 of file SundanceTriangleMeshReader.cpp.

References Sundance::Mesh::addVertex(), Sundance::MeshReaderBase::atof(), Sundance::MeshReaderBase::atoi(), Sundance::MeshSourceBase::createMesh(), Sundance::dimension(), Sundance::MeshReaderBase::getNextLine(), Sundance::MeshSourceBase::nodeAttributes(), nodeFilename_, Sundance::MeshSourceBase::nProc(), offset_, Sundance::MeshReaderBase::openFile(), parFilename_, SUNDANCE_OUT, and Sundance::DefaultObjectWithVerbosity::verb().

Referenced by fillMesh().

void TriangleMeshReader::readParallelInfo	(	Array< int > &	ptGID,
		Array< int > &	ptOwner,
		Array< int > &	elemGID,
		Array< int > &	elemOwner
	)		const `[private]`