Remove Mesh Elements


The tool removeMeshElements removes those elements from a given input mesh that fulfills a user specified criterion. The resulting mesh will be written to the specified output file. The user can choose between 4 different removal criteria:

  1. Remove elements by assigned properties, for instance material ids.
  2. Remove elements by element type, for instance remove line elements.
  3. Remove elements that have zero volume.
  4. Remove elements by axis aligned bounding box criterion.

One possible application is to cut out a smaller mesh out of a bigger one by marking the inner/outer region using the tool SetPropertiesInPolygonalRegion.

Another application is to cut out patches of a (top) surface (tool ExtractSurface) for assigning boundary conditions.


removeMeshElements -i <input-mesh> -o <output-mesh>
 [-n <property_name>] [--int-property-value <number value>] ...
 [--element-type <element type>] ...
    [--x-min <value>] [--x-max <value>] [--y-min <value>] [--y-max <value>] [--z-min <value>] [--z-max <value>]

Each particular line with optional arguments refers to one of the different removal criteria mentioned in the general section. The corresponding element types differ from VTK cell types and can be found in MeshLib/MeshEnums.cpp.


The left figure above is the result of the repeated application of SetPropertiesInPolygonalRegion. It contains material ids 0 (red), 1 (yellow), 2 (turquoise) and 3 (blue).

The result of the following command line input is depicted.
The result of the following command line input is depicted.

removeMeshElements -i TestCube-ResetPropertiesInPolygonalRegion.vtu -o TestCube-removeMeshElements.vtu -n MaterialIDs --int-property-value 1 --int-property-value 2 --int-property-value 3


The tool was used to cut the Unstrut catchment out of the Thuringian syncline model and to remove some geological units not necessary for the modeling within the INFLUINS project, see reference [GO2OGS].

This article was written by Thomas Fischer. If you are missing something or you find an error please let us know.
Generated with Hugo 0.101.0 in CI job 284016 | Last revision: December 19, 2022
Commit: Merge branch 'bourgeat-tol' into 'master' 138a7678  | Edit this page on