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           [-nofem] [-noinsert] [-nomove] [-noswap] [-nosurf] [-nosizreq]
13           [-nreg] [-nsd] [-optim] [-optimLES] [-octree n⟩] [-rn n⟩]
14

DESCRIPTION

16     The mmg3d application is dedicated to tetrahedral remeshing.  Both sur‐
17     face and volume mesh are modified.
18
19     By defaults it performs mesh modifications in order to control the sur‐
20     face approximation.
21     Providing a metric file, it adapts the mesh to the prescribed sizes at
22     nodes.
23     Providing a level-set file containing the values of the level-set func‐
24     tion at the mesh nodes, the -ls option allows to explicitly mesh an im‐
25     plicit domain.
26     Without metric file, the -optim option allow to improve the mesh quality
27     with respect to the initial mesh size.  -optimLES option allow to improve
28     strongly the isotropic mesh quality for LES simulations.
29

COMMAND LINE ARGUMENTS

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

RETURN VALUES

99     mmg3d returns:
100     the 0 value if successful;
101     the 1 value if the process fail but can save a conform mesh;
102     the 2 value if the process fail and can't save a comform mesh.
103

SEE ALSO

105     mmgs(1) mmg2d(1)
106
107mmg3d                            May 04, 2015                            mmg3d
Impressum