MMG2D(1)

πŸ“¦ version 5.8.0, in fedora 43, fedora 44, nixpkgs unstable

πŸ’– MMG2D(1) πŸ’–

okay bestie, listen up β€” this is the manual page for mmg2d, from the General Commands Manual section, and it's genuinely iconic. It's the tool for adaptation and optimization of bidimensional meshes. Yes, meshes. Triangles. Two dimensions. We're thriving. πŸ¦‹


✨ NAME ✨

mmg2d β€” Adaptation and optimization of bidimensional meshes. that's the whole vibe. πŸŽ€


🌸 SYNOPSIS 🌸

mmg2d ⟨mesh_file⟩ [output_file] [-sol ⟨solution_file⟩]
      [-met ⟨metric_file⟩] [-h] [-v] [-m ⟨n⟩] [-d] [-val] [-default]
      [-A] [-ar ⟨x⟩ | -nr] [-hmin ⟨x⟩] [-hmax ⟨x⟩] [-hsiz ⟨x⟩]
      [-hausd ⟨x⟩] [-hgrad ⟨x⟩] [-hgradreq ⟨x⟩] [-rmc x] [-lag ⟨n⟩]
      [-ls x] [-lssurf x] [-noinsert] [-nomove] [-noswap] [-nosurf]
      [-nosizreq] [-nreg] [-xreg] [-nsd ⟨n⟩] [-opnbdy] [-optim]
      [-3dMedit ⟨n⟩]

like, look at all those flags. she's got range. πŸ’…


πŸ‘‘ DESCRIPTION πŸ‘‘

The mmg2d application is dedicated to bidimensional triangular mesh remeshing. periodt.

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.

Without metric file, the -optim option allows to improve the mesh quality with respect to the initial mesh size.

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 mesh boundaries on a provided isovalue.

Providing a displacement file -lag option applies a lagrangian displacement to boundary mesh nodes.

so basically she does a lot and she does it well. 😌


🫢 COMMAND LINE ARGUMENTS 🫢

πŸ“ 1. Generic options:

  • -h β€” Print help. (the "bestie I'm lost" button πŸ™ˆ)
  • -v ⟨n⟩ β€” Tune level of verbosity. Takes values between -1 and 10.
  • -m ⟨n⟩ β€” Set maximal memory size to n MBytes.
  • -d β€” Turn on debug mode.
  • -default β€” Write a local parameter file (with extension .mmg2d) with setted values.
  • -val β€” Print the default parameters values.

🧚 2. File specifications:

  • -in ⟨mesh_file⟩ β€” Input triangulation.
  • -out ⟨output_file⟩ β€” Output triangulation.
  • -sol ⟨solution_file⟩ β€” Load metric, level-set or displacement file.
  • -met ⟨metric_file⟩ β€” Load metric file in level-set mode.

🌈 3. Mode specifications (default is mesh adaptation):

  • -lag ⟨n⟩ β€” Lagrangian mesh displacement according to mode 0 ( n=0 ), 1 ( n=1 ) or 2 ( n=2 ). This option is only available with the USE_ELAS compilation flag. The LinearElasticity library must be founded to activate this flag.
  • -ls x β€” Create mesh of isovalue x (0.0 if x is not provided).
  • -lssurf x β€” Split boundary mesh on isovalue x (0.0 if x is not provided).
no cap, default mode is mesh adaptation. that's the baseline. everything else is a side quest. ✨

πŸ’œ 4. Parameters:

  • -A β€” 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).
  • -opnbdy β€” Preserve input edges at the interface of two domains of the same reference.
  • -noinsert β€” No point insertion/deletion.
  • -nomove β€” No point relocation
  • -nosurf β€” No surface modifications.
  • -noswap β€” No edge or face flipping.
  • -nosizreq β€” No imposition of the size of required edges over required vertices.
  • -nreg β€” Normal regularization using laplacian - antilaplacian smoothing.
  • -xreg β€” Vertex coordinates regularization using laplacian - antilaplacian smoothing.
  • -nsd ⟨n⟩ β€” Save the subdomain of index n (default is n=0 which save all subdomains).
  • -optim β€” Mesh improvement with respect to the initial mesh size.
  • -3dMedit ⟨n⟩ β€” Write and/or read Medit mesh file in 3D. If val=1 write the 2D mesh in 3D. If val=2 read and write 2D mesh in 3D. If val=3 read a 2D mesh in 3D and write it in 2D.

πŸ’€ RETURN VALUES πŸ’€

mmg2d returns:

  • the 0 value if successful;
  • the 1 value if the process fail but can save a conform mesh;
  • the 2 value if the process fail and can't save a comform mesh.

like she'll tell you exactly how it went. communicative queen. πŸ‘‘


πŸ”₯ SEE ALSO πŸ”₯

mmg3d(1) mmgs(1)

her sisters!! go say hi!! 🫢✨


and that's the whole page, bestie. this one's mmg2d, version-of-record MMG2D(1), dated May 04, 2015 β€” mwah, no notes, she ate and left absolutely zero crumbs. πŸ’…πŸŽ€πŸ’–

πŸ“¦ where this page comes from