MeshEntityIterator provides a common iterator for mesh entities over meshes, boundaries and incidence relations. The basic use is illustrated below.
The following example shows how to iterate over all mesh entities of a mesh of topological dimension dim:
>>> for e in dolfin.cpp.entities(mesh, 1): ... print e.index()
The following example shows how to iterate over mesh entities of topological dimension dim connected (incident) to some mesh entity f:
>>> f = dolfin.cpp.MeshEntity(mesh, 0, 0) >>> for e in dolfin.cpp.entities(f, 1): ... print e.index()
In addition to the general iterator, a set of specific named iterators are provided for entities of type
Cell. These iterators are defined along with their respective classes.
Create iterator for mesh entities over given topological dimension
MeshEntityIterator(mesh, dim, opt)
Iterator over MeshEntity of dimension dim on mesh, with string option to iterate over “regular”, “ghost” or “all” entities
Create iterator for entities of given dimension connected to given entity
Check if iterator has reached the end
Provide a safeguard iterator pointing beyond the end of an iteration process, either iterating over the mesh /or incident entities. Added to be bit more like STL iterators, since many algorithms rely on a kind of beyond iterator.
Return current position
The membership flag