class dolfin.cpp.mesh.entities(*args)

Bases: object

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 Vertex, Edge, Face, Facet and Cell. These iterators are defined along with their respective classes.

Overloaded versions

  • MeshEntityIterator()

    Default constructor

  • MeshEntityIterator(mesh, dim)

    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

  • MeshEntityIterator(entity, dim)

    Create iterator for entities of given dimension connected to given entity

  • MeshEntityIterator(it)

    Copy constructor


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