Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
[](https://gitlab.inria.fr/ParMmg/ParMmg/commits/master)
ParMmg is an open source software for parallel mesh adaptation of 3D volume meshes.
The algorithm of parallel mesh adaptation is inspired from the [Yales2](https://www.coria-cfd.fr/index.php/YALES2) algorithm, see [1](https://onlinelibrary.wiley.com/doi/abs/10.1002/fld.4204).
ParMmg uses the [Mmg](http://mmgtools.org) software to perform the sequential remeshing steps.
## 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](https://git-scm.com/download) (command line program)
* [GitKraken](https://www.gitkraken.com/)
* [SourceTree](https://www.sourcetreeapp.com/)
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/](https://cmake.org/download/). On Windows OS,
once CMake is installed, please <span style="color:red"> do not forget to
mark the option:
```
"Add CMake to the system PATH for all users"
```
</span>
* **Mmg** : Mmg can be download on [GitHub](https://github.com/MmgTools/mmg). Please, follow the [installation guide](https://github.com/MmgTools/Mmg/wiki/Setup-guide#iii-installation) of the [setup guide](https://github.com/MmgTools/Mmg/wiki/Setup-guide#setup-guide)
* **Metis** : ParMmg uses the Metis graph partitionner. Please, consult the [project webpage](http://glaros.dtc.umn.edu/gkhome/metis/metis/download) and follow the instructions.
### ParMmg download and compilation
#### Unix-like OS (Linux, MacOS...)
1. Get the repository:
```Shell
wget https://gitlab.inria.fr/ParMmg/ParMmg/-/archive/alpha/ParMmg-1.0.0.alpha.zip
```
or
```Shell
git clone https://gitlab.inria.fr/ParMmg/ParMmg.git
```
The project sources are available under the **_src/_** directory.
2. ParMmg uses the Mmg sources, thus, to compile, you must provide the path to your Mmg directory and the path to your build directory of Mmg. Example :
```Shell
cd ParMmg
mkdir build
cd build
cmake -DMMG_DIR=~/path-to-mmg-dir -DMMG_BUILDDIR=~/path-to-mmg-builddir ..
make
make install
```
In this example, we supposed that metis is available in the Path. If not, you can help ParMmg to find Metis by providing the ```METIS_DIR``` variable to CMake.
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](https://github.com/MmgTools/Mmg/wiki/Setup-guide#iii-installation) of the [setup guide](https://github.com/MmgTools/Mmg/wiki/Setup-guide#setup-guide) of Mmg and follow the same steps.
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](https://github.com/MmgTools/mmg/wiki/Configure-script-for-CMake-(UNIX-like-OS)).
#### Windows OS
For now we do not provide the windows portability.
## Documentation
A short documentation is available [here](https://gitlab.inria.fr/ParMmg/ParMmg/wikis/home#user-guide).
To get ParMmg help, run:
```Shell
parmmg_O3 -h
```
To see the ParMmg default option:
```Shell
parmmg_O3 -val
```
### Algorithm
The algorithm used in ParMmg has been developped by the Coria team and is detailed [here](https://onlinelibrary.wiley.com/doi/abs/10.1002/fld.4204).
### About the team
ParMmg's current developers and maintainers are [Luca Cirrottola](mailto:luca.cirrottola@inria.fr) and [Algiane Froehly](mailto:algiane.froehly@inria.fr).
## License and copyright
Code is under the [terms of the GNU Lesser General Public License](https://raw.githubusercontent.com/MmgTools/mmg/master/LICENSE).
Copyright © Bx INP/Inria/UBordeaux, 2018- .
## Reference
[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_](http://www.sciencedirect.com/science/article/pii/S0021999114000266)
[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_](https://onlinelibrary.wiley.com/doi/abs/10.1002/fld.4204)