GEOS-DEV /GEOS

GEOS Simulation Framework

★ 299⑂ 113👁 29⑃ 2,886● 1,215▤ 5
C++LGPL-2.1Created 2018-05-02
Download: 1.2.01.2.0 ↓1.2.02024-10-02
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-021

Top issues

Discussions

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

Snapshot: 2026-11-17T21:58:29Z · Data license Apache-2.0 · JSON