createLayeredMeshFromRasters is a tool for creating a 3D mesh from a 2D mesh by adding layers to the 2D mesh. The layers are created from the x-y coordinates of the mesh combined with the z-coordinates from raster files (*.asc, *.grd, *.xyz). The tool builds the 3D mesh starting with the bottom layer. The bottom layer must cover the complete domain, i.e. it needs to have as many nodes as the 2D input mesh. If not an error will occur as there is no information on the lower boundary of the mesh. Currently, only inputs from line and triangle elements are supported, since mapping quads can result in invalid mesh elements. The different layers have to be listed in an extra .txt-file, where the top to bottom arrangement is given by the order of the raster files in the .txt-file.


   createLayeredMeshFromRasters  -i <file name> -o <file name> -r <file name>
                                [-t <floating point number>] [--ascii_output]
                                [--] [--version] [-h]


   -i <file name>,  --input-mesh-file <file name>
     (required)  The file name of the 2D input mesh.

   -o <file name>,  --output-mesh-file <file name>
     (required)  The file name of the resulting 3D mesh.

   -r <file name>,  --raster-list <file name>
     (required)  An ascii-file containing a list of raster files, starting
     from top (DEM) to bottom.

   -t <floating point number>,  --thickness <floating point number>
     The minimum thickness of a layer to be integrated at any given

     Write VTU output in ASCII format.

   --,  --ignore_rest
     Ignores the rest of the labeled arguments following this flag.

     Displays version information and exits.

   -h,  --help
     Displays usage information and exits.


Fig.1 2D input mesh mapped to an elevation (generated with the tool MeshMapping, although it is not necessary to use a mapped mesh, a flat mesh is sufficient). The z-values of the mesh are scaled by a factor of 10.

Create layers below a given 2D mesh according to a list of raster files.
createLayeredMeshFromRasters -i mesh_mapped.vtu -o mesh_layered.vtu -r list_raster_mesh.txt

The .txt-file that contains the list of raster files, in this example it is called list_raster_mesh.txt, is specified as follows:


Fig.2 The layered 3D output mesh created from raster files. The different colors depict different material IDs. The z-values of the mesh are scaled by a factor of 10.

This article was written by Julian Heinze. If you are missing something or you find an error please let us know.
Generated with Hugo 0.117.0 in CI job 362666 | Last revision: July 12, 2023
Commit: [PL/SSD] Rename x_dot to x_prev 04a8fec8  | Edit this page on