Extract Surface


The tool extracts 2d surface elements of a mesh given either in the vtu or msh format. Since the algorithm uses the element surface normals a correct node ordering of the element nodes is required. The user can specify the components of the normal the extracted surface should have.


ExtractSurface -i [<file name of input mesh>] [-o <file name of output mesh>]
 [-x <floating point value>] [-y <floating point value>] [-z <floating point value>]
 [-a <floating point value>]
 [--face-property-name <string>]
 [--element-property-name <string>]
 [--node-property-name <string>]
  • The normal of the surface that should be extracted is given by the arguments -x, -y and -z. The default normal is (0,0,-1).
  • The command line option -a can be used to specify the allowed deviation of the normal of the surface element from the given normal.
  • The data arrays added to the surface mesh by using the options --face-property-name (default value ‘bulk_face_ids’), --element-property-name (default value ‘bulk_element_ids’), and --node-property-name (default value ‘bulk_node_ids’) are used in other tools (for instance in ComputeNodeAreasFromSurfaceMesh) and is required for flux calculations during a simulation run of OpenGeoSys.
  • The switch ‘ascii-output’ produces vtu-files containing the data in human readable ASCII format instead of binary format.


Extracted surfaces

Extracted top, bottom and side surfaces:

  • top ExtractSurface -i Input.vtu -o TopSurface.vtu
  • bottom ExtractSurface -i Input.vtu -o BottomSurface.vtu -x 0 -y 0 -z 1
  • side ExtractSurface -i Input.vtu -o SideSurface.vtu -x 1 -y 1 -z 0 -a 45

Shows the extracted front, right, back, and left surfaces from the cube that are colored by the corresponding subsurface material id. The material ids transformed to the surfaces can be used for further boundary condition preparations for instance employing paraviews threshold filter.

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.96.0. Last revision: February 16, 2022
Commit: explanation stress concentration and running model 5c94789  | Edit this page on