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 (
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
createLayeredMeshFromRasters -i <file name> -o <file name> -r <file name> [-t <floating point number>] [--ascii_output] [--] [--version] [-h] Where: -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 location. --ascii_output Write VTU output in ASCII format. --, --ignore_rest Ignores the rest of the labeled arguments following this flag. --version 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
.txt-file that contains the list of raster files, in this example it is called
list_raster_mesh.txt, is specified as follows:
path/to/raster-file/DEM.asc path/to/raster-file/m0.asc path/to/raster-file/m1.asc path/to/raster-file/m2.asc path/to/raster-file/m3.asc path/to/raster-file/m4.asc path/to/raster-file/m5.asc path/to/raster-file/m6.asc
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.