Tools

mesh2vtu

Combines and converts a .mesh file and a .param file into a corresponding .vtu file

Usage:

mesh2vtu input.mesh input.param output.vtu

meshmerge

Combines multiple parameter files (.param) into one. All the files are validated to ensure each parameter has the same number of elements.

Usage:

meshmerge [-h] [-o outfile] infile [infile ...]

infile

Type:

string

Path to the n input parameter files to merge into one

outfile

Type:

string

Optional path to the output parameter file. If not given, defaults to a filename of concatenated input files.

meshpermutation

Because of how the triangles are generated and subsequently written to file, triangles that are close in space may not be close in the file. Therefore, if the mesh is used in a numerical model, it may result in inefficient access. This tool computes the permutation of a mesh that minimizes the bandwidth of the connectivity matrix.

This tool adds a new field cell_global_id to the .mesh file. A consuming program can sort the triangles (i.e., mesh.elem see: .mesh) by these ids. Then, spatially close triangles will also be close in memory. This may be visualized by plotting the nearest neighbour connectivity before and after reodering.

Before optimization

After optimization

Usage:

meshpermutation [-h] [-o outfile] [-t type] [-i infile]

outfile

File for output. Overwrite input file

type

rcm Performing RCM bandwidth minimization (default)

nd Performing ND fill-in minimization

metis Performing METIS communication minimization partitioning. Requires -n <value> where <value> is the number of partitions. If this mesh is used later for MPI simulation, this should correspond to the number of MPI ranks that will be used.

n

If metis type is selected, this is required. Number of partitions.

meshstats

Produces a csv file of detailed per-triangle information: the error (‘rmse’ is computed), triangle area (units^2), min and max inner angles (degrees). These values are also written to the _USM.shp file in the mesher output directory.

Expects that the .mesh is in a projected CRS.

Note that the triangles’ RMSE is recomputed, so can be a bit slow on very large meshes.

Note

Requires write_shp=True as the shp file is used to load triangle geometry.

Usage:

meshstats dir

dir

Directory to output directory produced by mesher.