mmgs - Man Page

Adaptation and optimization of a surface triangulation representing a piecewise linear approximation of an underlying surface geometry.


mmgsmesh_file⟩ [output_file] [-solsolution_file⟩] [-metmetric_file⟩] [-h] [-v] [-mn⟩] [-d] [-val] [-default] [-A] [-arx⟩ | -nr] [-hminx⟩] [-hmaxx⟩] [-hsizx⟩] [-hausdx⟩] [-hgradx⟩] [-hgradreqx⟩] [-rmc x] [-ls x] [-lssurf x] [-keep-ref] [-nreg] [-xreg] [-noinsert] [-nomove] [-noswap] [-nosizreq] [-nreg] [-nsd] [-optim] [-rnn⟩]


The mmgs application is dedicated to surface triangulation remeshing.

By default it performs mesh modifications in order to control the surface approximation.
Providing a metric file, it adapts the mesh to the prescribed sizes at nodes.
-optim option allows to improve the mesh quality with respect to initial mesh size and the surface approximation respect.
Providing a level-set file containing the values of the level-set function at the mesh nodes, the -ls option allows to explicitely mesh an implicit domain and the -lssurf option splits boundary edges of the mesh on a provided isovalue.

Command Line Arguments

  1. Generic options:


    Print help.

    -v ⟨n⟩

    Tune level of verbosity.
    Takes values between -1 and 10.

    -m ⟨n⟩

    Set maximal memory size to n MBytes.


    Turn on debug mode.


    Write a local parameter file (with extension .mmgs) with setted values.


    Print the default parameters values.

  2. File specifications:

    -in ⟨mesh_file⟩

    Input triangulation.

    -out ⟨output_file⟩

    Output triangulation.

    -sol ⟨solution_file⟩

    Load metric or level-set file.

    -met ⟨metric_file⟩

    Load metric file in level-set mode.

  3. Mode specifications (default is mesh adaptation):

    -ls x

    Create mesh of isovalue x (0.0 if x is not provided).

    -lssurf x

    Split boundary edges on isovalue x (0.0 if x is not provided).

  4. Parameters:


    Enable anisotropy (without metric file).

    -ar ⟨x⟩ | -nr

    Threshold for angle detection or sharp features detection disabling.

    -hmin ⟨x⟩

    Minimal mesh size.

    -hmax ⟨x⟩

    Maximal mesh size.

    -hsiz ⟨x⟩

    Constant mesh size.

    -hausd ⟨x⟩

    Control the Hausdorff distance to the underlying surface geometry.

    -hgrad ⟨x⟩

    Control the gradation.

    -hgradreq ⟨x⟩

    Control the gradation from required entities toward others.

    -rmc x

    Remove componants whose volumic fraction is less than x (1.e-5 if x is not provided) of the whole mesh volume or not connected to base references provided in parameter file (level-set mode).


    Preserve initial domain references when create the mesh of isovalue.


    No point insertion/deletion.


    No point relocation


    No edge or face flipping.


    No imposition of the size of required edges over required vertices.


    Normal regularization using laplacian - antilaplacian smoothing.


    Vertex coordinates regularization using laplacian - antilaplacian smoothing.

    -nsd ⟨n⟩

    Save the subdomain of index n (default is n=0 which save all subdomains).


    Mesh improvement with respect to the initial mesh size.

    -rn ⟨n⟩

    Turn on ( n=1 ) or off ( n=0 ) the renumbering using the SCOTCH library (only available with the USE_SCOTCH compilation flag and if the scotch library is founded).

Return Values

mmgs returns:

See Also

mmg3d(1) mmg2d(1)

Referenced By

mmg2d(1), mmg3d(1).

May 4, 2015