1MMG3D(1)                  BSD General Commands Manual                 MMG3D(1)
2

NAME

4     mmg3d — Adaptation and optimization of a tetrahedral mesh and implicit
5     domain meshing.
6

SYNOPSIS

8     mmg3d 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] [-opnbdy] [-lag n⟩] [-ls x]
12           [-lssurf x] [-nofem] [-noinsert] [-nomove] [-noswap] [-nosurf]
13           [-nosizreq] [-nreg] [-xreg] [-nsd] [-optim] [-optimLES]
14           [-octree n⟩] [-rn n⟩]
15

DESCRIPTION

17     The mmg3d application is dedicated to tetrahedral remeshing.  Both sur‐
18     face and volume mesh are modified.
19
20     By defaults it performs mesh modifications in order to control the sur‐
21     face approximation.
22     Providing a metric file, it adapts the mesh to the prescribed sizes at
23     nodes.
24     Without metric file, the -optim option allows to improve the mesh quality
25     with respect to the initial mesh size.  -optimLES option allows to im‐
26     prove strongly the isotropic mesh quality for LES simulations.
27     Providing a level-set file containing the values of the level-set func‐
28     tion at the mesh nodes, the -ls option allows to explicitly mesh an im‐
29     plicit domain and the -lssurf option splits mesh boundaries on a provided
30     isovalue.
31     Providing a displacement file -lag option applies a lagrangian displace‐
32     ment to boundary mesh nodes.
33
34

COMMAND LINE ARGUMENTS

36     1.   Generic options:
37          -h                      Print help.
38          -v ⟨n⟩                  Tune level of verbosity.
39                                  Takes values between -1 and 10.
40          -m ⟨n⟩                  Set maximal memory size to n MBytes.
41          -d                      Turn on debug mode.
42          -default                Write a local parameter file (with extension
43                                  .mmg3d) with setted values.
44          -val                    Print the default parameters values.
45
46     2.   File specifications:
47          -in ⟨mesh_file⟩         Input triangulation.
48          -out ⟨output_file⟩      Output triangulation.
49          -sol ⟨solution_file⟩    Load metric, displacement or level-set file.
50          -met ⟨metric_file⟩      Load metric file in level-set mode.
51
52     3.   Mode specifications (default is mesh adaptation):
53          -lag ⟨n⟩                Lagrangian mesh displacement according to
54                                  mode 0 ( n=0 ), 1 ( n=1 ) or 2 ( n=2 ). This
55                                  option is only available with the USE_ELAS
56                                  compilation flag. The LinearElasticity li‐
57                                  brary must be founded to activate this flag.
58          -ls x                   Create mesh of isovalue x (0.0 if x is not
59                                  provided).
60          -lssurf x               Split boundary mesh on isovalue x (0.0 if x
61                                  is not provided).
62
63     4.   Parameters:
64          -A                      Enable anisotropy (without metric file).
65          -ar ⟨x⟩ | -nr           Threshold for angle detection or sharp fea‐
66                                  tures detection disabling.
67          -hmin ⟨x⟩               Minimal mesh size.
68          -hmax ⟨x⟩               Maximal mesh size.
69          -hsiz ⟨x⟩               Constant mesh size.
70          -hausd ⟨x⟩              Control the Hausdorff distance between the
71                                  surface mesh and the underlying surface ge‐
72                                  ometry.
73          -hgrad ⟨x⟩              Control the gradation.
74          -hgradreq ⟨x⟩           Control the gradation from required entities
75                                  toward others.
76          -rmc x                  Remove componants whose volumic fraction is
77                                  less than x (1.e-5 if x is not provided) of
78                                  the whole mesh volume (level-set mode).
79          -opnbdy                 Preserve input triangles at the interface of
80                                  two domains of the same reference.
81          -nofem                  Do not force Mmg to create a finite element
82                                  mesh.
83          -noinsert               No point insertion/deletion.
84          -nomove                 No point relocation
85          -nosurf                 No surface modifications.
86          -noswap                 No edge or face flipping.
87          -nosizreq               No imposition of the size of required edges
88                                  over required vertices.
89          -nreg                   Normal regularization using laplacian - an‐
90                                  tilaplacian smoothing.
91          -xreg                   Vertex coordinates regularization using
92                                  laplacian - antilaplacian smoothing.
93          -nsd ⟨n⟩                Save the subdomain of index n (default is
94                                  n=0 which save all subdomains).
95          -octree ⟨n⟩             Specify the maximal number of point per oc‐
96                                  tree cell (only available without the
97                                  PATTERN compilation flag).
98          -optim                  Mesh improvement with respect to the initial
99                                  mesh size.
100          -optimLES               Strong isotropic mesh optimization for LES
101                                  computations.
102          -rn ⟨n⟩                 Turn on ( n=1 ) or off ( n=0 ) the renumber‐
103                                  ing using the SCOTCH library (only available
104                                  with the USE_SCOTCH compilation flag and if
105                                  the scotch library is founded).
106

RETURN VALUES

108     mmg3d returns:
109     the 0 value if successful;
110     the 1 value if the process fail but can save a conform mesh;
111     the 2 value if the process fail and can't save a comform mesh.
112

SEE ALSO

114     mmgs(1) mmg2d(1)
115
116mmg3d                            May 04, 2015                            mmg3d
Impressum