LYNX
Lithosphere dYnamic Numerical toolboX
A MOOSE-based application
A numerical simulator for modelling deformation of the lithosphere, based on MOOSE.
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
Please read the CITATION file for more information.
More to come...