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⟩] [-A] [-ls x] [-keep-ref] [-nreg]
12 [-noinsert] [-nomove] [-noswap] [-nosizreq] [-nreg] [-nsd] [-optim]
13 [-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 Providing a level-set file containing the values of the level-set func‐
23 tion at the mesh nodes, the -ls option allows to explicitely mesh an im‐
24 plicit domain. -optim option allow to improve the mesh quality with re‐
25 spect to initial mesh size and the surface approximation respect.
26
29 1. Generic options:
30 -h Print help.
31 -v ⟨n⟩ Tune level of verbosity.
32 Takes values between -1 and 10.
33 -m ⟨n⟩ Set maximal memory size to n MBytes.
34 -d Turn on debug mode.
35 -default Write a local parameter file (with extension
36 .mmgs) with setted values.
37 -val Print the default parameters values.
38 2. File specifications:
40 -in ⟨mesh_file⟩ Input triangulation.
41 -out ⟨output_file⟩ Output triangulation.
42 -sol ⟨solution_file⟩ Load metric or level-set file.
43 -met ⟨metric_file⟩ Load metric file in level-set mode.
44 3. Mode specifications (default is mesh adaptation):
46 -ls x Create mesh of isovalue x (0.0 if x is not
47 provided).
48 4. Parameters:
50 -A Enable anisotropy (without metric file).
51 -ar ⟨x⟩ | -nr Threshold for angle detection or sharp fea‐
52 tures detection disabling.
53 -hmin ⟨x⟩ Minimal mesh size.
54 -hmax ⟨x⟩ Maximal mesh size.
55 -hsiz ⟨x⟩ Constant mesh size.
56 -hausd ⟨x⟩ Control the Hausdorff distance to the under‐
57 lying surface geometry.
58 -hgrad ⟨x⟩ Control the gradation.
59 -hgradreq ⟨x⟩ Control the gradation from required entities
60 toward others.
61 -keep-ref Preserve initial domain references when cre‐
62 ate the mesh of isovalue.
63 -noinsert No point insertion/deletion.
64 -nomove No point relocation
65 -noswap No edge or face flipping.
66 -nosizreq No imposition of the size of required edges
67 over required vertices.
68 -nreg Normal regularization using laplacian - an‐
69 tilaplacian smoothing.
70 -nsd ⟨n⟩ Save the subdomain of index n (default is
71 n=0 which save all subdomains).
72 -optim Mesh improvement with respect to the initial
73 mesh size.
74 -rn ⟨n⟩ Turn on ( n=1 ) or off ( n=0 ) the renumber‐
75 ing using the SCOTCH library (only available
76 with the USE_SCOTCH compilation flag and if
77 the scotch library is founded).
78
80 mmgs returns:
81 • the 0 value if successful;
82 • the 1 value if the process fail but we can save a conform mesh;
83 • the 2 value if the process fail and we can't save a conform mesh.
84
86 mmg3d(1) mmg2d(1)
87mmgs May 04, 2015 mmgs