Parmmg - Parallel 3D volume remesher

ParMmg is an open source software for parallel mesh adaptation of 3D volume meshes. The parallel mesh adaptation algorithm is based on iterative remeshing and repartitioning of the distributed mesh (see 1). It is inspired by the Yales2 algorithm (see 2). ParMmg uses the Mmg software to perform the sequential remeshing steps.

⚠️ ParMmg is built on Mmg but it is not officially patronized by the Mmg Consortium, thus it does not benefit from the same professional user support. Support is currently done with love by the developers and the community, on their own initiative and free time, and without related funding.

Feel free to contact the maintainers if you think that an advanced usage of ParMmg could be useful for your project, or to discuss opportunities for collaborations on specific developments. ⚠️

Get and compile the ParMmg project

Needed tools

To get and build ParMmg, you will need:

Git: to download the code you will have to use a git manager. You can install a git manager from the link below but there are many other git clients that you can use:
- Official Git client (command line program)
- GitKraken
- SourceTree
Note that if you uses Microsoft Visual Studio (Windows OS), you can simply activate the Git Module of the application.
CMake : ParMmg uses the CMake building system that can be downloaded on the following web page: https://cmake.org/download/. On Windows OS, once CMake is installed, please do not forget to mark the option:
```
"Add CMake to the system PATH for all users"
```

ParMmg download and compilation

Unix-like OS (Linux, MacOS...)

Get the repository:

      git clone https://github.com/MmgTools/ParMmg.git

The project sources are available under the src/ directory.

By default ParMmg download and install automatically Mmg and Metis (as CMake external projects):

      cd ParMmg  
      mkdir build  
      cd build  
      cmake ..  
      make  
      make install

If the make install command fail, try to run the sudo make install command. If you don't have root access, please refers to the Installation section of the setup guide of Mmg and follow the same steps.

If you don't have internet access and/or want to use your own installation of Mmg (resp. Metis), you can disable the automatic download of Mmg setting the DOWNLOAD_MMG (resp. DOWNLOAD_METIS) CMake variable to OFF. In this case, you can help CMake to find Mmg (resp. Metis) by specifying the source directory of Mmg in the MMG_DIR variable and the build directory of Mmg in the MMG_BUILDDIR variable (resp. the installation directory of Metis in the METIS_DIR variable).

Example:

    cd ParMmg  
    mkdir build  
    cd build  
    cmake -DDOWNLOAD_MMG=OFF -DMMG_DIR=~/mmg -DMMG_BUILDDIR=~/mmg/build ..  
    cmake -DDOWNLOAD_METIS=OFF -DMETIS_DIR=~/metis-install ..  
    make  
    make install

The parmmg application is available under the parmmg_O3 command.

Note that if you use some specific options and want to set it easily, you can use a shell script to execute the previous commands. An example is provided in the Mmg wiki here.

Windows OS

For now we do not provide Windows portability.

Documentation

A short documentation is available here. To get ParMmg help, run:

  parmmg_O3 -h

To see the ParMmg default option:

  parmmg_O3 -val

Algorithm

The parallel algorithm used in ParMmg has been developed by the Coria team and is described here. Its current implementation and differences are detailed here.

About the team

ParMmg's current developers and maintainers are Luca Cirrottola and Algiane Froehly.

License and copyright

Code is under the terms of the GNU Lesser General Public License.

Acknowledgements

This work has received funding from the ExaQUte project (http://exaqute.eu/), founded by the European Union’s Horizon 2020 research and innovation programme under grant agreement No 800898. This work has also received funding from the FUI22 ICARUS project (http://i-carus.fr/), founded by Région Nouvelle- Aquitaine (RNA) under grant agreement 17001260-031 and the Fonds Unique intérministeriel (FUI) under grant agreement No DOS0050687100.

The authors would like to thank the scientific support of the YALES2 development team at the CORIA research center (http://www.coria.fr/) in the implementation of the parallel remeshing algorithm.

Reference

Parallel unstructured mesh adaptation using iterative remeshing and repartitioning - L. Cirrottola and A. Froehly - November 29, 2019 - Inria research report 9307

Three-dimensional adaptive domain remeshing, implicit domain meshing, and applications to free and moving boundary problems - C. Dapogny, C. Dobrzynski and P. Frey - April 1, 2014 - JCP

Mesh adaptation for large-eddy simulations in complex geometries. - P. Benard, G. Balarac, V. Moureau, C. Dobrzynski, G. Lartigue, et al. - 2016 - International Journal for Numerical Methods in Fluids

prj-/ParMmg