LYNX (Lithosphere dYnamic Numerical toolboX) is a numerical simulator for modelling coupled Thermo-Hydro-Mechanical processes in the porous rocks of the lithosphere. The simulator is developed by Antoine Jacquey and Mauro Cacace at the GFZ Potsdam, German Research Centre for Geosciences from the section Basin Modelling.

LYNX is a MOOSE-based application. Visit the MOOSE framework page for more information.

LYNX is distributed under the GNU GENERAL PUBLIC LICENSE v3.

The following system requirements are from the MOOSE framework (see Getting Started for more information):

• Compiler: C++11 Compliant GCC 4.8.4, Clang 3.4.0, Intel20130607
• Python 2.7+
• Memory: 16 GBs (debug builds)
• Processor: 64-bit x86
• Disk: 30 GBs
• OS: UNIX compatible (OS X, most flavors of Linux)

To install LYNX, you need first to have a working and up-to-date installation of the MOOSE framework.
To do so, please visit the Getting Started page of the MOOSE framework and follow the instructions. If you encounter difficulties at this step, you can ask for help on the MOOSE-users Google group.

LYNX can be cloned directly from GitLab using Git. In the following, we refer to the directory projects which you created during the MOOSE installation (by default ~/projects):

cd ~/projects
git clone https://gitext.gfz-potsdam.de/ajacquey/lynx.git
cd ~/projects/lynx
git checkout master

Note: the "master" branch of LYNX is the "stable" branch which is updated only if all tests are passing.

You can compile LYNX by following these instructions:

cd ~/projects/lynx
make -j4

To make sure that everything was installed properly, you can run the tests suite of LYNX:

cd ~/projects/lynx
./run_tests -j2

If all the tests passed, then your installation is working properly. You can now use the LYNX simulator!

To run LYNX from the command line with multiple processors, use the following command:

mpiexec -n <nprocs> ~/projects/lynx/lynx-opt -i <input-file>

Where <nprocs> is the number of processors you want to use and <input-file> is the path to your input file (extension .i).

Information about the structure of the LYNX input files can be found in the documentation (link to follow).

If you use LYNX for your work please cite:

• This repository:
  Jacquey, Antoine B., & Cacace, Mauro. (2019, July 30). LYNX: Lithosphere dYnamic Numerical toolboX, a MOOSE-based application (Version 1.0). Zenodo. http://doi.org/10.5281/zenodo.3355376

• The following research articles: Jacquey, Antoine B., & Cacace, Mauro. (2020). Multiphysics Modeling of a Brittle‐Ductile Lithosphere: 1. Explicit Visco‐Elasto‐Plastic Formulation and Its Numerical Implementation. Journal of Geophysical Research: Solid Earth. http://doi.org/10.1029/2019jb018474 Jacquey, Antoine B., & Cacace, Mauro. (2020). Multiphysics Modeling of a Brittle‐Ductile Lithosphere: 2. Semi‐brittle, Semi‐ductile Deformation and Damage Rheology. Journal of Geophysical Research: Solid Earth. http://doi.org/10.1029/2019jb018475

Please read the CITATION file for more information.

• Jacquey, Antoine B., & Cacace, Mauro. (2020). Multiphysics Modeling of a Brittle‐Ductile Lithosphere: 1. Explicit Visco‐Elasto‐Plastic Formulation and Its Numerical Implementation. Journal of Geophysical Research: Solid Earth. http://doi.org/10.1029/2019jb018474

• Jacquey, Antoine B., & Cacace, Mauro. (2020). Multiphysics Modeling of a Brittle‐Ductile Lithosphere: 2. Semi‐brittle, Semi‐ductile Deformation and Damage Rheology. Journal of Geophysical Research: Solid Earth. http://doi.org/10.1029/2019jb018475