Detailed Description

template<typename TPixelType, unsigned int VDimension = 3, typename TMeshTraits = DefaultStaticMeshTraits< TPixelType, VDimension, VDimension >>
class itk::Mesh< TPixelType, VDimension, TMeshTraits >

Implements the N-dimensional mesh structure.

Overview: Mesh implements the N-dimensional mesh structure for ITK. It provides an API to perform operations on points, cells, boundaries, etc., but does not tie down the underlying implementation and storage. A "MeshTraits" structure is used to define the container and identifier types that will be used to access the mesh. See DefaultStaticMeshTraits for the set of type definitions needed. All types that are defined in the "MeshTraits" structure will have duplicate typedefs in the resulting mesh itself.

Mesh is an adaptive, evolving structure. Typically points and cells are created, with the cells referring to their defining points. If additional topological information is required, then BuildCellLinks() is called and links from the points back to the cells that use them are created. This allows implicit topological information about the faces and edges of the cells to be determined. (For example, a "face" neighbor to a cell can be determined by intersection the sets of cells that use the points defining the face. This is an inherent assumption on the manifold relationship of the cells in the mesh.) In some cases, either because the mesh is non-manifold, because we wish to explicitly store information with the faces and edges of the mesh, or because performance requirements demand that boundaries are explicitly represented (the set intersection does not need to be performed); then Mesh can be further extended by adding explicit boundary assignments.

Usage: Mesh has three template parameters. The first is the pixel type, or the type of data stored (optionally) with points, cells, and/or boundaries. The second is the geometric dimension of the points defining the mesh. This also limits the maximum topological dimension of the cells that can be inserted. The third template parameter is the "MeshTraits" structure controlling type information for the mesh. Most users will be happy with the defaults, and will not have to worry about this third argument.

One of the most important parts of using this mesh is how to create cells to insert into it. The cells for the mesh take two template parameters. The first is the pixel type, and should correspond exactly to that type given to the mesh. The second is a "CellTraits" which holds a sub-set of the "MeshTraits" structure definitions, and is also a member of them. Any cell which is to be inserted to a mesh should have MeshTraits::CellTraits as its second template parameter.

Template parameters for Mesh:

TPixelType = The type stored as data for an entity (cell, point, or boundary).

TMeshTraits = Type information structure for the mesh.

References: No reference information is available.

Examples:: Examples/DataRepresentation/Mesh/AutomaticMesh.cxx, Examples/DataRepresentation/Mesh/Mesh1.cxx, Examples/DataRepresentation/Mesh/Mesh2.cxx, Examples/DataRepresentation/Mesh/Mesh3.cxx, Examples/DataRepresentation/Mesh/MeshCellsIteration.cxx, Examples/DataRepresentation/Mesh/MeshCellVisitor.cxx, Examples/DataRepresentation/Mesh/MeshCellVisitor2.cxx, Examples/DataRepresentation/Mesh/MeshKComplex.cxx, Examples/DataRepresentation/Mesh/MeshPolyLine.cxx, Examples/DataRepresentation/Mesh/MeshTraits.cxx, Examples/Filtering/SurfaceExtraction.cxx, Examples/SpatialObjects/MeshSpatialObject.cxx, SphinxExamples/src/Core/Common/ReadAPointSet/Code.cxx, SphinxExamples/src/Core/Mesh/ConvertTriangleMeshToBinaryImage/Code.cxx, SphinxExamples/src/Core/Mesh/ExtractIsoSurface/Code.cxx, SphinxExamples/src/Core/Mesh/TranslateOneMesh/Code.cxx, SphinxExamples/src/IO/Mesh/ReadMesh/Code.cxx, WikiExamples/Meshes/AddPointsAndEdges.cxx, WikiExamples/Meshes/AreaAndVolume.cxx, WikiExamples/Meshes/ConvertToVTK.cxx, WikiExamples/Meshes/PointAndCellData.cxx, WikiExamples/Meshes/ReadWrite.cxx, WikiExamples/Meshes/WishList/VTKPolyDataWriter.cxx, and WikiExamples/PointSet/ReadPointSet.cxx.

Definition at line 108 of file itkMesh.h.

Classes
class	BoundaryAssignmentIdentifier

Public Types
typedef MapContainer < BoundaryAssignmentIdentifier, CellIdentifier >	BoundaryAssignmentsContainer

typedef BoundaryAssignmentsContainer::Pointer	BoundaryAssignmentsContainerPointer

typedef std::vector < BoundaryAssignmentsContainerPointer >	BoundaryAssignmentsContainerVector

typedef BoundingBoxType::Pointer	BoundingBoxPointer

typedef BoundingBox < PointIdentifier, itkGetStaticConstMacro(PointDimension), CoordRepType, PointsContainer >	BoundingBoxType

typedef CellType::CellAutoPointer	CellAutoPointer

typedef MeshTraits::CellDataContainer	CellDataContainer

typedef CellDataContainer::ConstPointer	CellDataContainerConstPointer

typedef CellDataContainer::ConstIterator	CellDataContainerIterator

typedef CellDataContainer::Pointer	CellDataContainerPointer

typedef CellFeatureIdentifier	CellFeatureCount

typedef MeshTraits::CellFeatureIdentifier	CellFeatureIdentifier

typedef MeshTraits::CellIdentifier	CellIdentifier

typedef MeshTraits::CellLinksContainer	CellLinksContainer

typedef CellLinksContainer::ConstPointer	CellLinksContainerConstPointer

typedef CellLinksContainer::ConstIterator	CellLinksContainerIterator

typedef CellLinksContainer::Pointer	CellLinksContainerPointer

typedef CellType::MultiVisitor	CellMultiVisitorType

typedef MeshTraits::CellPixelType	CellPixelType

enum	CellsAllocationMethodType { CellsAllocationMethodUndefined, CellsAllocatedAsStaticArray, CellsAllocatedAsADynamicArray, CellsAllocatedDynamicallyCellByCell }

typedef MeshTraits::CellsContainer	CellsContainer

typedef CellsContainer::ConstIterator	CellsContainerConstIterator

typedef CellsContainer::ConstPointer	CellsContainerConstPointer

typedef CellsContainer::Iterator	CellsContainerIterator

typedef CellsContainer::Pointer	CellsContainerPointer

typedef MeshTraits::CellTraits	CellTraits

typedef CellInterface < CellPixelType, CellTraits >	CellType

typedef SmartPointer< const Self >	ConstPointer

typedef MeshTraits::CoordRepType	CoordRepType

typedef MeshTraits::InterpolationWeightType	InterpolationWeightType

typedef TMeshTraits	MeshTraits

typedef MeshTraits::PixelType	PixelType

typedef MeshTraits::PointCellLinksContainer	PointCellLinksContainer

typedef PointCellLinksContainer::const_iterator	PointCellLinksContainerIterator

typedef MeshTraits::PointDataContainer	PointDataContainer

typedef PointDataContainer::ConstIterator	PointDataContainerIterator

typedef PointDataContainer::Pointer	PointDataContainerPointer

typedef SmartPointer< Self >	Pointer

typedef MeshTraits::PointHashType	PointHashType

typedef MeshTraits::PointIdentifier	PointIdentifier

typedef MeshTraits::PointsContainer	PointsContainer

typedef PointsContainer::ConstIterator	PointsContainerConstIterator

typedef PointsContainer::Iterator	PointsContainerIterator

typedef PointsContainer::Pointer	PointsContainerPointer

typedef MeshTraits::PointType	PointType

typedef Superclass::RegionType	RegionType

typedef Mesh	Self

typedef PointSet< TPixelType, VDimension, TMeshTraits >	Superclass

Public Types inherited from itk::PointSet< TPixelType, VDimension, TMeshTraits >
typedef SmartPointer< const Self >	ConstPointer

typedef MeshTraits::CoordRepType	CoordRepType

typedef TMeshTraits	MeshTraits

typedef MeshTraits::PixelType	PixelType

typedef MeshTraits::PointDataContainer	PointDataContainer

typedef PointDataContainer::ConstPointer	PointDataContainerConstPointer

typedef PointDataContainer::ConstIterator	PointDataContainerIterator

typedef PointDataContainer::Pointer	PointDataContainerPointer

typedef SmartPointer< Self >	Pointer

typedef MeshTraits::PointIdentifier	PointIdentifier

typedef MeshTraits::PointsContainer	PointsContainer

typedef PointsContainer::ConstIterator	PointsContainerConstIterator

typedef PointsContainer::ConstPointer	PointsContainerConstPointer

typedef PointsContainer::Iterator	PointsContainerIterator

typedef PointsContainer::Pointer	PointsContainerPointer

typedef MeshTraits::PointType	PointType

typedef long	RegionType

typedef PointSet	Self

typedef DataObject	Superclass

Public Member Functions
virtual void	Accept (CellMultiVisitorType *mv) const

void	BuildCellLinks () const

virtual void	CopyInformation (const DataObject *data) override

virtual ::itk::LightObject::Pointer	CreateAnother () const

bool	GetAssignedCellBoundaryIfOneExists (int dimension, CellIdentifier, CellFeatureIdentifier, CellAutoPointer &) const

bool	GetBoundaryAssignment (int dimension, CellIdentifier cellId, CellFeatureIdentifier featureId, CellIdentifier *boundaryId) const

BoundaryAssignmentsContainerPointer	GetBoundaryAssignments (int dimension)

const BoundaryAssignmentsContainerPointer	GetBoundaryAssignments (int dimension) const

const BoundingBoxType *	GetBoundingBox () const

bool	GetCell (CellIdentifier, CellAutoPointer &) const

bool	GetCellBoundaryFeature (int dimension, CellIdentifier, CellFeatureIdentifier, CellAutoPointer &) const

CellIdentifier	GetCellBoundaryFeatureNeighbors (int dimension, CellIdentifier, CellFeatureIdentifier, std::set< CellIdentifier > *cellSet)

CellDataContainer *	GetCellData ()

const CellDataContainer *	GetCellData () const

CellLinksContainer *	GetCellLinks ()

const CellLinksContainer *	GetCellLinks () const

CellIdentifier	GetCellNeighbors (CellIdentifier cellId, std::set< CellIdentifier > *cellSet)

CellsContainer *	GetCells ()

const CellsContainer *	GetCells () const

virtual const char *	GetNameOfClass () const

CellFeatureCount	GetNumberOfCellBoundaryFeatures (int dimension, CellIdentifier) const

CellIdentifier	GetNumberOfCells () const

virtual void	Graft (const DataObject *data) override

virtual void	Initialize () override

void	PassStructure (Self *inputMesh)

bool	RemoveBoundaryAssignment (int dimension, CellIdentifier cellId, CellFeatureIdentifier featureId)

void	SetBoundaryAssignment (int dimension, CellIdentifier cellId, CellFeatureIdentifier featureId, CellIdentifier boundaryId)

void	SetBoundaryAssignments (int dimension, BoundaryAssignmentsContainer *)

void	SetCell (CellIdentifier, CellAutoPointer &)

void	SetCellData (CellDataContainer *)

void	SetCellLinks (CellLinksContainer *)

void	SetCells (CellsContainer *)


void	SetCellData (CellIdentifier, CellPixelType)

bool	GetCellData (CellIdentifier, CellPixelType *) const


virtual void	SetCellsAllocationMethod (CellsAllocationMethodType _arg)

virtual const CellsAllocationMethodType &	GetCellsAllocationMethod () const

Public Member Functions inherited from itk::PointSet< TPixelType, VDimension, TMeshTraits >
virtual ::itk::LightObject::Pointer	CreateAnother () const

virtual RegionType	GetBufferedRegion () const

virtual RegionType	GetMaximumNumberOfRegions () const

PointIdentifier	GetNumberOfPoints () const

PointDataContainer *	GetPointData ()

const PointDataContainer *	GetPointData () const

PointsContainer *	GetPoints ()

const PointsContainer *	GetPoints () const

virtual RegionType	GetRequestedRegion () const

void	PassStructure (Self *inputPointSet)

virtual bool	RequestedRegionIsOutsideOfTheBufferedRegion () override

virtual void	SetBufferedRegion (const RegionType &region)

void	SetPointData (PointDataContainer *)

void	SetPoints (PointsContainer *)

virtual void	SetRequestedRegion (const DataObject *data) override

virtual void	SetRequestedRegion (const RegionType &region)

virtual void	SetRequestedRegionToLargestPossibleRegion () override

virtual void	UpdateOutputInformation () override

virtual bool	VerifyRequestedRegion () override

void	SetPoint (PointIdentifier, PointType)

bool	GetPoint (PointIdentifier, PointType *) const

PointType	GetPoint (PointIdentifier) const

void	SetPointData (PointIdentifier, PixelType)

bool	GetPointData (PointIdentifier, PixelType *) const

Static Public Member Functions
static Pointer	New ()

Static Public Member Functions inherited from itk::PointSet< TPixelType, VDimension, TMeshTraits >
static Pointer	New ()

Static Public Attributes

static const unsigned int	PointDimension = TMeshTraits::PointDimension

static const unsigned int	MaxTopologicalDimension = TMeshTraits::MaxTopologicalDimension

Static Public Attributes inherited from itk::PointSet< TPixelType, VDimension, TMeshTraits >
static const unsigned int	PointDimension = TMeshTraits::PointDimension

Protected Member Functions
void	ReleaseCellsMemory ()


	Mesh ()

	~Mesh ()

void	PrintSelf (std::ostream &os, Indent indent) const override

Protected Member Functions inherited from itk::PointSet< TPixelType, VDimension, TMeshTraits >
	PointSet ()

	~PointSet ()

Private Attributes
CellsAllocationMethodType	m_CellsAllocationMethod