The macro-micro-coupling tool for multiscale coupled molecular-continuum flow simulation.
To compile and execute MaMiCo on a linux system, you need at least:
- a C++17 compiler installed (e.g. GCC 7 or newer)
- CMake version >= 3.0
Optional dependencies are:
- MPI, highly recommended for parallel runs, e.g. on clusters.
- Eigen 3, a linear algebra library used for the POD noise filter.
- pybind11, for the MaMiCo Python bindings.
- OpenFOAM, for coupling to CFD simulations with OpenFOAM.
- preCICE, for coupling with other solvers using the preCICE coupling library.
- ls1-MarDyn, for coupling to MD simulations with ls1.
- LAMMPS, for coupling to MD simulations with LAMMPS.
- LCOV and gcc, for test code coverage analysis.
-
First clone this repository and create a new build directory:
git clone [email protected]:HSU-HPC/MaMiCo.git cd MaMiCo mkdir build cd build
-
If you don't have a github account or don't want to use it, you can alternatively use
git clone https://github.com/HSU-HPC/MaMiCo.git
(read-only). -
Then initialise CMake in your build directory, pointing it to the root directory of the repository. (Note that on some older systems, the command may be named
cmake3
instead ofcmake
.)cmake ..
-
This will configure the build system with default settings and generate makefiles in the build directory. Optionally, you might want to change the build configuration now:
ccmake .
-
Here you can enable optional dependencies, e.g. activate BUILD_WITH_MPI (default OFF), or modifiy which compiler and flags you want to use. When you are done, press the configure [c] and generate [g] keys. Now you can start the compilation:
make
-
After cloning the repository, initialize the ls1 submodule with
git submodule init git submodule update
-
Follow the instructions on the ls1 repository to build with cmake, however remember to enable the MAMICO_COUPLING flag, and provide the MaMiCo base directory in the MAMICO_SRC_DIR variable.
-
Make MaMiCo as normal, choosing LS1_MARDYN as your MD library.
- Download the LAMMPS source code, build it using CMake with the option
-DBUILD_SHARED_LIBS=ON
, and install it usingmake install
. - Make LAMMPS available through pgk-config with
export PKG_CONFIG_PATH=/home/$(whoami)/.local/lib/pkgconfig
. - Create a symbolic link to the LAMMPS header files in the MaMiCo root folder using
ln -s <path to LAMMPS>/src <path to MaMiCo>/lammps
- The build instructions have created an executable of the standard Couette flow test case, the file is called 'couette'. It expects an XML configuration file named 'couette.xml' in the current working directory.
- An example simulation configuration file can be found here, other template input files are in the examples folder as well.
- Copy this file to your build folder, rename it 'couette.xml'.
- The available options and features are listed directly in the template file via XML comments, so that you can modify the configuration to suit your needs.
- Start the simulation by executing (sequential case)
./couette
or e.g. (MPI-parallel)mpirun -n 8 ./couette
. - If you get the error message 'ERROR MoleculeService::MoleculeService: Could not open file CheckpointSimpleMD_10000_reflecting_0.checkpoint!', copy the file of the same name from the 'examples' folder into your build folder.
- Depending on the configuration, you will obtain various output files in CSV, VTK or other formats.
- P. Jarmatz, P. Neumann: MaMiCo: Parallel Noise Reduction for Multi-instance Molecular-Continuum Flow Simulation, International Conference on Computational Science. Springer, Cham, 2019
- P. Neumann, X. Bian: MaMiCo: Transient multi-instance molecular-continuum flow simulation on supercomputers, Computer Physics Communications 220 (2017): 390-402
- P. Neumann, H. Flohr, R. Arora, P. Jarmatz: MaMiCo: Software design for parallel molecular-continuum flow simulations Computer Physics Communications 200 (2016): 324-335