1MMGS(1) BSD General Commands Manual MMGS(1)
2
4 mmgs — Adaptation and optimization of a surface triangulation represent‐
5 ing a piecewise linear approximation of an underlying surface geometry.
6
8 mmgs ⟨mesh_file⟩ [output_file] [-sol ⟨solution_file⟩]
9 [-met ⟨metric_file⟩] [-h] [-v] [-m ⟨n⟩] [-d] [-val] [-default] [-A]
10 [-ar ⟨x⟩ | -nr] [-hmin ⟨x⟩] [-hmax ⟨x⟩] [-hsiz ⟨x⟩] [-hausd ⟨x⟩]
11 [-hgrad ⟨x⟩] [-hgradreq ⟨x⟩] [-rmc x] [-ls x] [-lssurf x]
12 [-keep-ref] [-nreg] [-xreg] [-noinsert] [-nomove] [-noswap]
13 [-nosizreq] [-nreg] [-nsd] [-optim] [-rn ⟨n⟩]
14
16 The mmgs application is dedicated to surface triangulation remeshing.
17 By default it performs mesh modifications in order to control the surface
19 approximation.
20 Providing a metric file, it adapts the mesh to the prescribed sizes at
21 nodes.
22 -optim option allows to improve the mesh quality with respect to initial
23 mesh size and the surface approximation respect.
24 Providing a level-set file containing the values of the level-set func‐
25 tion at the mesh nodes, the -ls option allows to explicitely mesh an im‐
26 plicit domain and the -lssurf option splits boundary edges of the mesh on
27 a provided isovalue.
28
31 1. Generic options:
32 -h Print help.
33 -v ⟨n⟩ Tune level of verbosity.
34 Takes values between -1 and 10.
35 -m ⟨n⟩ Set maximal memory size to n MBytes.
36 -d Turn on debug mode.
37 -default Write a local parameter file (with extension
38 .mmgs) with setted values.
39 -val Print the default parameters values.
40 2. File specifications:
42 -in ⟨mesh_file⟩ Input triangulation.
43 -out ⟨output_file⟩ Output triangulation.
44 -sol ⟨solution_file⟩ Load metric or level-set file.
45 -met ⟨metric_file⟩ Load metric file in level-set mode.
46 3. Mode specifications (default is mesh adaptation):
48 -ls x Create mesh of isovalue x (0.0 if x is not
49 provided).
50 -lssurf x Split boundary edges on isovalue x (0.0 if x
51 is not provided).
52 4. Parameters:
54 -A Enable anisotropy (without metric file).
55 -ar ⟨x⟩ | -nr Threshold for angle detection or sharp fea‐
56 tures detection disabling.
57 -hmin ⟨x⟩ Minimal mesh size.
58 -hmax ⟨x⟩ Maximal mesh size.
59 -hsiz ⟨x⟩ Constant mesh size.
60 -hausd ⟨x⟩ Control the Hausdorff distance to the under‐
61 lying surface geometry.
62 -hgrad ⟨x⟩ Control the gradation.
63 -hgradreq ⟨x⟩ Control the gradation from required entities
64 toward others.
65 -rmc x Remove componants whose volumic fraction is
66 less than x (1.e-5 if x is not provided) of
67 the whole mesh volume or not connected to
68 base references provided in parameter file
69 (level-set mode).
70 -keep-ref Preserve initial domain references when cre‐
71 ate the mesh of isovalue.
72 -noinsert No point insertion/deletion.
73 -nomove No point relocation
74 -noswap No edge or face flipping.
75 -nosizreq No imposition of the size of required edges
76 over required vertices.
77 -nreg Normal regularization using laplacian - an‐
78 tilaplacian smoothing.
79 -xreg Vertex coordinates regularization using
80 laplacian - antilaplacian smoothing.
81 -nsd ⟨n⟩ Save the subdomain of index n (default is
82 n=0 which save all subdomains).
83 -optim Mesh improvement with respect to the initial
84 mesh size.
85 -rn ⟨n⟩ Turn on ( n=1 ) or off ( n=0 ) the renumber‐
86 ing using the SCOTCH library (only available
87 with the USE_SCOTCH compilation flag and if
88 the scotch library is founded).
89
91 mmgs returns:
92 • the 0 value if successful;
93 • the 1 value if the process fail but we can save a conform mesh;
94 • the 2 value if the process fail and we can't save a conform mesh.
95
97 mmg3d(1) mmg2d(1)
98mmgs May 04, 2015 mmgs