299
stars
113
forks
29
watchers
2,886
prs
1,215
issues
5
releases
README
Welcome to the GEOS project!
-----------------------------
GEOS is a simulation framework for modeling coupled flow, transport, and geomechanics
in the subsurface. The code provides advanced solvers for a number of target applications,
including
- carbon sequestration,
- geothermal energy,
- and similar systems.
Its capabilities include single-phase, multiphase and compositional flow (isothermal or thermal), wells,
solid mechanics and poromechanics, fracture and fault mechanics (contact, embedded fractures, hydraulic fracturing),
wave propagation and induced seismicity.
A key focus of the project is achieving scalable performance on current and next-generation
high performance computing systems. We do this through a portable programming model and research into scalable algorithms.
You may want to browse our
publications
page for more details on the HPC, numerics,
and applied engineering components of this effort.
Getting started
---------------
GEOS is distributed as source code. To download, build and run a first simulation, follow the
Quick Start Guide,
then work through the tutorials.
Docker images with all third-party libraries pre-built are available (see the Quick Start Guide), and
this repository can be opened directly in a GitHub Codespace or a VS Code Dev Container.
Documentation
-------------
Please visit the Main documentation for GEOS.
If you would like to contribute to GEOS, please see the developer guide
If you would like to report a bug, please submit an issue.
Who develops GEOS?
-------------------
GEOS is an open source project and is developed by a community of researchers at
several institutions. The bulk of the code has been written by contributors from
four main organizations:
- Lawrence Livermore National Laboratory,
- Stanford University,
- TotalEnergies,
- Chevron
See our
authors
and
acknowledgements
page for more details.
History
-------
GEOS was known as GEOSX until 2023; some file names, library names and URLs still use the old name.
It succeeds an earlier code developed at LLNL, also called GEOS. The current code differs from that earlier effort in two important ways:
- It uses a fundamentally different programming model to achieve
high performance on the complicated chip architectures common on today's
HPC systems, including GPU-based exascale-class systems.
- It is developed as an open-source effort to encourage collaboration
within the research and industrial community, under the LGPL 2.1 License.
Release
-------
For release details and restrictions, please read the LICENSE file.
For copyrights, please read the COPYRIGHT file.
For contributors, please read the CONTRIBUTORS file.
For acknowledgements, please read the ACKNOWLEDGEMENTS file.
For notice, please read the NOTICE file.
LLNL-CODE-812638 OCEC-18-021Top issues
#2905Update CI platforms and compilers12 comments · 2023-12-21#1004HF simulation resumed from a restart file has weird matrix sizes12 comments · 2020-06-17#2331Renaming `geosx` into `geos`11 comments · 2023-03-09#2277[EPIC] Log formatting improvement11 comments · 2023-02-06#1994Semi-Automated explicit instantiation of templated functions in separate compilation units11 comments · 2022-08-01#766Modification to integrated test tolerance scheme.11 comments · 2020-02-13#2703Error in time history outputs9 comments · 2023-09-22#3355bug in testLifoStorage8 comments · 2024-09-13
Discussions
#4105Migration to C++20 and C++231 comments · 2026-07-31#4092High-level components over FieldSpecification (e.g. PermeabilitySpecification) and there direction1 comments · 2026-06-26#4081Schema Change Examples for PR #39720 comments · 2026-06-10#4065Preexisting Fractures Implementation0 comments · 2026-05-26#4022CO2-Brine Model PVT Parameter Files Replaced by XML Attributes0 comments · 2026-04-08#3885Egg Benchmark: Result mismatch from the paper0 comments · 2025-10-28#3804Best practice for incorporating grdecl-converted-to-vtu mesh with all supporting and additional .txt data into a GEOS XML input file0 comments · 2025-09-02#3794Buckling Capabilities of Geos0 comments · 2025-08-25
Latest release
1.2.0 1.2.0 2024-10-02:sparkles: New Features - 7130462 - Augmented Lagrangian (slip and open modes) (PR 3217 by @matteofrigo5) - 1616ea4 - minimum interval for time-step increase after time-step cut (PR 3338 by @victorapm) - 0db85be - Log refactor - Output PVT (PR 3149 by @arng40) - :arrow_lower_right: addresses issue 3013 opened by @MelReyCG :bug: Bug Fixes - eb7c6b2 - Remove shadow declarations (PR 3293 by @dkachuma) - f9a64bb - testLifoStorage random fail on RockyLinux with clang+CUDA (PR 3362 by @sframba) :recycle: Refactors - 7ff2349 - mixture density computation in multiphase poromechanics solvers (P