See the documentation at MPM-Geomechanics.
MPM-Geomechanics is a program that allows us to model the behavior of geo-materials, like soil and rock, when these materials are subjected to different initial and boundary conditions. Currently, the geo-materials are present in several areas of the society, like for example in the slopes and excavation process in mining industry activities, or in the study of risk associated to naturals disasters.
The objective of this repository is to provide a platform for developing the MPM for the study of geomechanical problems involving large deformations and distortions.
If you are interested to collaborate with this project, please contact to [email protected]. There are several topics for developing in this project, here there are a few of them:
-
contact method for large terrain models using STL meshes (Zhang et al., 2023) ✅
-
axisymmetric formulation (Nairn & Guilkey, 2015)
-
implicit (Nair & Roy, 2012) and semi-implicit (Kularathna et al., 2021) time integration
-
convected particle domain interpolation (Sadeghirad et al., 2011)
-
thermo-mechanics formulation (Zhan et al., 2024)
-
update stress schemes USF and MUSL (Buzzi et al., 2008)
-
damage constitutive models (Homel & Herbold, 2016)
-
viscous constitutive models
-
critical state constitutive models (Sheng et al., 2000)
-
MPI implementation for process optimization (Ku & Kim, 2023)
-
...
The main features of the program in the actuality are:
- Three-dimensional formulation (can simulated 2D plane strain problems too)
- Dynamic formulation (suitable for earthquake and general dynamic problems)
- Shared memory parallelization (for computational time reduction)
- Several constitutive models for soils and rock, including softening and hardening options.
- Go to the Actions page.
- Select the latest run of the MSBuild workflow for Window, or CI for Linux.
- At the bottom, you will find the available artifacts under the Artifacts section.
- Download the
compiled-binariesartifact to get the compiled code.
For generating documentation and compilation of the code please see the documentation at MPM-Geomechanics.
In this example an soil slope failure is simulated using an elastoplastic material:
For more details of this simulation see the input file slope-failure.json
In this example an elastoplastic body impacts over an elastic body. The fracturing process in rock masses is captured using an exponential strain softening over tensile strength in the elastoplastic material:
Fracturing induced by exponential softening over the tensile strength. The yellow body is subjected to an initial velocity. The withe body is elastic.
An elasto-plastic body impacts over an elastic body. The exponential softening used over the tensile strength, in order to reproduce the fracturing process in the body.
See exponential-softening.json input file for simulation details.
In this example is tested the refinement mesh behavior. The fixed (left-bottom) and free boundary (right-up) conditions are tested too.
See exponential-softening-refined.json input file for simulation details.
| Program | Installation | Description |
|---|---|---|
| Winget | Microsoft's official website | Package manager for Windows |
| Git | via Winget | Version control system. Used in this project to clone the GoogleTest repository |
| CMake | via Winget | Build system generator |
| MSYS2 | via Winget | Package manager that includes MinGW |
| MinGW32-make | via MSYS2 | Environment for the GCC compiler |
| GCC | via MSYS2 | GNU Compiler Collection |
| G++ | via MSYS2 | C++ Compiler |
Make sure you have Winget installed, you can verify this by running winget --version. If you don't have installed Winget, you can get it from Microsoft's official website
- Install Git, CMake and MSYS2 using
wingetby running the following commands:
# Git
winget install -e --id Git.Git -e --source winget
# MSYS2
winget install -e --id MSYS2.MSYS2 --source winget
# CMake
winget install -e --id Kitware.CMake --source winget
- Open the
MSYSconsole and execute the following commands:
# GCC and G++
pacman -S mingw-w64-x86_64-gcc
# mingw32-make
pacman -S mingw-w64-x86_64-make
Verify the environment variables for the directory C:/msys64/mingw64/bin. If it does not exist, add it.
Then, in the console line of windows (or powershell), you must verify the versions of each installation via:
git --version
cmake --version
mingw32-make --version
gcc --version
g++ --version
| Program | Installation | Description |
|---|---|---|
| Git | via apt | Version control system. Used in this project to clone the GoogleTest repository |
| CMake | via apt | Build system generator |
| Make | via apt | Package manager that includes MinGW |
| GCC | via apt | GNU Compiler Collection |
| G++ | via apt | C++ Compiler |
- Install all the necessary progrmas using
aptby running the following commands:
# Git
sudo apt install git
# CMake
sudo apt install cmake
# Make, GCC, G++
sudo apt install build-essential
- You must verify the versions of each installation via:
git --version
cmake --version
make --version
gcc --version
g++ --version
The tests use GoogleTest. It is necessary to import this library by cloning the official repository into the folder /external. Each developer must clone this repository independently.
cd external
git clone https://github.com/google/googletest.git
Your directory must have the following structure:
mpm-geomechanics/
├─ build/
│ ├─ CMakeFiles/
│ ├─ make/
│ ├─ msbuild/
│ ├─ testing/
│ │ ├─ CMakeLists.txt
│ │ ├─ build/
The commands must be executed in the /build/testing/build directory (If it does not exist, it must be created), otherwise, the process will produce an error.
cmake -G "MinGW Makefiles" ..
cmake --build .
These commands will generate a .exe file named MPM-Test.exe.
cmake -G "Unix Makefiles" ..
cmake --build .
These commands will generate a executable file named MPM-Test.