lynx

Lithosphere dYnamics Numerical toolboX - a MOOSE-based application

https://github.com/ajacquey/lynx

Science Score: 64.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 11 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    2 of 4 committers (50.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.6%) to scientific vocabulary

Keywords

geodynamics lithosphere lynx moose-framework

Keywords from Contributors

geothermal-reservoirs golem
Last synced: 6 months ago · JSON representation ·

Repository

Lithosphere dYnamics Numerical toolboX - a MOOSE-based application

Basic Info
  • Host: GitHub
  • Owner: ajacquey
  • License: gpl-3.0
  • Language: C++
  • Default Branch: main
  • Homepage:
  • Size: 6.95 MB
Statistics
  • Stars: 5
  • Watchers: 2
  • Forks: 3
  • Open Issues: 0
  • Releases: 0
Topics
geodynamics lithosphere lynx moose-framework
Created about 6 years ago · Last pushed over 4 years ago
Metadata Files
Readme License Citation

README.md


LYNX
Lithosphere dYnamic Numerical toolboX
A MOOSE-based application

A numerical simulator for modelling deformation of the lithosphere, based on MOOSE.

GPL License DOI

About

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 ORCID iD icon and Mauro Cacace ORCID iD icon 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.

Licence

LYNX is distributed under the GNU GENERAL PUBLIC LICENSE v3.

Getting Started

Minimum System Requirements

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)

1. Setting Up a MOOSE Installation

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.

2. Clone LYNX

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.

3. Compile LYNX

You can compile LYNX by following these instructions:

cd ~/projects/lynx
make -j4

4. Test LYNX

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!

Usage

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).

Cite

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.

Publications using LYNX

  • 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

Owner

  • Name: Antoine Jacquey
  • Login: ajacquey
  • Kind: user
  • Location: Montreal, CA
  • Company: Polytechnique Montreal

Citation (CITATION)

You are welcome to use and modify the LYNX simulator.
See the README.md for details.

If you use LYNX for your research, we would appreciate appropriate citation.
This includes a reference to the 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

And to one of 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

And also a reference to the publication describing the theory and implementation of the LYNX simulator:
The articles presenting the LYNX simulator are currently under review.

Here are the BibTex entries for LaTeX users:

@misc{LYNXApp,
  author = {Jacquey, Antoine B. and Cacace, Mauro},
  title = {{LYNX: Lithosphere dYnamic Numerical toolboX, a MOOSE-based application}},
  month = {jul},
  year = {2019},
  doi = {10.5281/zenodo.3355376},
  url = {https://doi.org/10.5281/zenodo.3355376}
}

@article{Lynx1,
  author = {Jacquey, Antoine B. and Cacace, Mauro},
  title = {Multiphysics Modeling of a Brittle-Ductile Lithosphere: 1. Explicit Visco-Elasto-Plastic Formulation and Its Numerical Implementation},
  journal = {Journal of Geophysical Research: Solid Earth},
  volume = {125},
  number = {1},
  pages = {e2019JB018474},
  doi = {10.1029/2019JB018474},
  url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2019JB018474},
  eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2019JB018474},
  note = {e2019JB018474 10.1029/2019JB018474},
  abstract = {Abstract The long-term strength of the lithosphere is controled by two different modes of deformation: a brittle-like, effective pressure-sensitive behavior at shallow crustal depth, which gradually transits to a thermally activated ductile flow rheology with increasing depth. All applications dealing with long-term tectonics therefore share the necessity to describe in a consistent way the multiphysics coupling among the different deformation mechanisms controlling the bulk behavior of the lithosphere. We describe an efficient numerical implementation of a consistent visco-elasto-plastic rheology suitable to describe the first-order aspects of continental rock masses. Different from typical long-term geodynamics numerical frameworks, we explicitly account for both volumetric and deviatoric response of lithospheric rocks to applied loads. Plastic correction to a viscoelastic stress state is introduced via a non-associative Drucker-Prager model, without resorting to the assumption of a plastic limiter. The transient behavior of crustal and lithospheric rocks is accounted for by an overstress (rate-dependent) viscoplastic rheology, which additionally helps solving for numerical issues related to plastic strain accumulation even in the absence of energetic feedbacks. When applied to the study of the dynamics of plume-lithosphere interactions, our implementation is able to reproduce a surface topography with complex multiharmonic wavelength patterns in agreement with observations. In the final chapter, we discuss main limitations of the current rheological description when applied to the study of transient semi-brittle rock behavior. These aspects are tackled in a companion paper, where a thermodynamically consistent formulation extending the current numerical description is presented.},
  year = {2020}
}

@article{Lynx2,
  author = {Jacquey, Antoine B. and Cacace, Mauro},
  title = {Multiphysics Modeling of a Brittle-Ductile Lithosphere: 2. Semi-brittle, Semi-ductile Deformation and Damage Rheology},
  journal = {Journal of Geophysical Research: Solid Earth},
  volume = {125},
  number = {1},
  pages = {e2019JB018475},
  doi = {10.1029/2019JB018475},
  url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2019JB018475},
  eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2019JB018475},
  note = {e2019JB018475 10.1029/2019JB018475},
  abstract = {Abstract The brittle-ductile transition is a domain of finite extent characterized by high differential stress where both brittle and ductile deformation are likely to occur. Understanding its depth location, extent, and stability through time is of relevance for diverse applications including subduction dynamics, mantle-surface interactions, and, more recently, proper targeting of high-enthalpy unconventional geothermal resources, where local thermal conditions may activate ductile creep at shallower depths than expected. In this contribution, we describe a thermodynamically consistent physical framework and its numerical implementation, therefore extending the formulation of the companion paper Jacquey and Cacace (2020, https://doi.org/10.1029/2019JB018474) to model thermo-hydro-mechanical coupled processes responsible for the occurrence of transitional semi-brittle, semi-ductile behavior in porous rocks. We make use of a damage rheology to account for the macroscopic effects of microstructural processes leading to brittle-like material weakening and of a rate-dependent plastic model to account for ductile material behavior. Our formulation additionally considers the role of porosity and its evolution during loading in controlling the volumetric mechanical response of a stressed rock. By means of dedicated applications, we discuss how our damage poro-visco-elasto-viscoplastic rheology can effectively reconcile the style of localized deformation under different confining pressure conditions as well as the bulk macroscopic material response as recorded by laboratory experiments under full triaxial conditions.},
  year = {2020}
}

GitHub Events

Total
Last Year

Committers

Last synced: over 1 year ago

All Time
  • Total Commits: 60
  • Total Committers: 4
  • Avg Commits per committer: 15.0
  • Development Distribution Score (DDS): 0.383
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Antoine Jacquey a****y@g****e 37
Antoine Jacquey a****y@m****u 14
Antoine Jacquey a****y 7
Antoine Jacquey a****y@t****u 2
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 0
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 0
  • Total pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels