GEOS

A simulation framework for modeling coupled flow, transport, and geomechanics in the subsurface.
https://github.com/GEOS-DEV/GEOS

Category: Emissions
Sub Category: Carbon Capture

Keywords

carbon-storage geomechanics gpu hpc llnl reservoir-simulation

Keywords from Contributors

portability radiuss parallel-computing app-infrastructure blt programming-model raja

Last synced: about 3 hours ago
JSON representation

Repository metadata

GEOS Simulation Framework

Host: GitHub
URL: https://github.com/GEOS-DEV/GEOS
Owner: GEOS-DEV
License: lgpl-2.1
Created: 2018-05-02T06:54:50.000Z (over 8 years ago)
Default Branch: develop
Last Pushed: 2026-08-21T17:28:45.000Z (4 days ago)
Last Synced: 2026-08-21T17:38:05.185Z (4 days ago)
Topics: carbon-storage, geomechanics, gpu, hpc, llnl, reservoir-simulation
Language: C++
Homepage:
Size: 583 MB
Stars: 286
Watchers: 29
Forks: 106
Open Issues: 309
Releases: 5
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: .github/CODEOWNERS
- Notice: NOTICE
- Copyright: COPYRIGHT

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.

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.

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.

How does GEOS relate to the earlier GEOS code?

GEOS is the offshoot of an earlier code developed at LLNL also called GEOS. The new
code differs from our previous efforts in two important ways:

This new code GEOS uses a fundamentally different programming model to achieve
high performance on the complicated chip architectures common on today's
HPC systems. This code is ready for exascale-class systems as they are delivered.
The new code has been released as an open-source effort to encourage collaboration
within the research and industrial community. See the release notes below
for details of the LGPL 2.1 License that has been adopted.

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

Citation (CITATION.cff)

cff-version: 1.2.0
message: If you use this software, please cite this repository and our article in the
  Journal of Open Source Software.
authors:
- family-names: "Settgast"
  given-names: "Randolph Richard"
  orcid: "https://orcid.org/0000-0002-2536-7867"
- family-names: "Corbett"
  given-names: "Benjamin Curtice"
- family-names: "Klevtsov"
  given-names: "Sergey"
  orcid: "https://orcid.org/0000-0001-9044-1827"
- family-names: "Hamon"
  given-names: "Francois"
  orcid: "https://orcid.org/0000-0001-8229-963X"
- family-names: "Sherman"
  given-names: "Christopher"
  orcid: "https://orcid.org/0000-0003-3550-0657"
- family-names: "Cusini"
  given-names: "Matteo"
  orcid: "https://orcid.org/0000-0002-6024-861X"
- family-names: "Gazzola"
  given-names: "Thomas"
  orcid: "https://orcid.org/0000-0002-6103-4605"
- family-names: "Tobin"
  given-names: "William"
- family-names: "White"
  given-names: "Joshua"
  orcid: "https://orcid.org/0000-0003-3491-142X"
- family-names: "Castelletto"
  given-names: "Nicola"
  orcid: "https://orcid.org/0000-0001-6816-6769"
- family-names: "Borio"
  given-names: "Andrea"
  orcid: "https://orcid.org/0000-0003-2016-5403"
- family-names: "Franceschini"
  given-names: "Andrea"
  orcid: "https://orcid.org/0000-0003-4395-5125"
- family-names: "Huang"
  given-names: "Jian"
  orcid: "https://orcid.org/0000-0002-5380-2563"
- family-names: "Han"
  given-names: "Brian"
- family-names: "Gross"
  given-names: "Herve"
  orcid: "https://orcid.org/0000-0002-1747-2018"
- family-names: "Franc"
  given-names: "Jacques"
  orcid: "https://orcid.org/0000-0002-8833-9425"
- family-names: "Mazuyer"
  given-names: "Antoine"
- family-names: "Besset"
  given-names: "Julien"
- family-names: "Citrain"
  given-names: "Aurelien"
- family-names: "Vargas"
  given-names: "Arturo"
- family-names: "Cremon"
  given-names: "Matthias"
  orcid: "https://orcid.org/0000-0001-7458-6401"
- family-names: "Hao"
  given-names: "Yue"
- family-names: "Khait"
  given-names: "Mark"
- family-names: "Lacoste"
  given-names: "Xavier"
- family-names: "Semnani"
  given-names: "Shabnam"
- family-names: "Frambati"
  given-names: "Stefano"
- family-names: "N'diaye"
  given-names: "Mamadou"
- family-names: "Nguyen"
  given-names: "Sy-Tuan"
- family-names: "Morgan"
  given-names: "Hannah Mairs"
- family-names: "Crook"
  given-names: "Cameron Mikel"
- family-names: "Jin"
  given-names: "Tao"
- family-names: "Froehly"
  given-names: "Algiane"
- family-names: "Homel"
  given-names: "Michael"
- family-names: "Magri"
  given-names: "Victor Paludetto"
- family-names: "Ju"
  given-names: "Isaac"
- family-names: "Rey"
  given-names: "Mel"
- family-names: "Povolny"
  given-names: "Stefan"
- family-names: "Wu"
  given-names: "Hui"
- family-names: "Bui"
  given-names: "Quan"
- family-names: "Tang"
  given-names: "Hewei"
- family-names: "Camargo"
  given-names: "Julia T."
- family-names: "Chourdakis"
  given-names: "Gerasimos"
- family-names: "Hui"
  given-names: "Wu"
- family-names: "Ren"
  given-names: "Guotong"
- family-names: "Yang"
  given-names: "Li"
- family-names: "Taeho"
  given-names: "Kim"
- family-names: "Waziri"
  given-names: "Sohail"
- family-names: "White"
  given-names: "Chris"
- family-names: "Fu"
  given-names: "Pengcheng"
- family-names: "Lapene"
  given-names: "Alexandre"
- family-names: "Thierry"
  given-names: "Bertrand"
- family-names: "Fei"
  given-names: "Fan"
- family-names: "Meng"
  given-names: "Jie"
- family-names: "Untereiner"
  given-names: "Lionel"
- family-names: "Raji"
  given-names: "Oluwatobi Quadri"
- family-names: "Karimi-Fard"
  given-names: "Mohammad"
- family-names: "Fuss"
  given-names: "Gaetan"
- family-names: "Huang"
  given-names: "Jixian"
- family-names: "Frigo"
  given-names: "Matteo"
- family-names: "Martinez"
  given-names: "Paloma"
- family-names: "Kachuma"
  given-names: "Dickson"
- family-names: "Tomin"
  given-names: "Pavel"
- family-names: "Byer"
  given-names: "Thomas James"
- family-names: "Ligocki"
  given-names: "Terry"
- family-names: "Shovkun"
  given-names: "Igor"
- family-names: "Bader"
  given-names: "Milad"
- family-names: "Robinson"
  given-names: "Peter B."
- family-names: "Hasanzade"
  given-names: "Rasim"
- family-names: "Dudes"
  given-names: "Arnaud"
- family-names: "Costa"
  given-names: "Andre Macieira Braga"
- family-names: "Pellerin"
  given-names: "Jeanne"
- family-names: "Aronson"
  given-names: "Ryan"
- family-names: "Osei-Kuffuor"
  given-names: "Daniel"
title: "GEOSX"
version: 1.1.0
doi: "10.5281/zenodo.7151031"
date-released: 2024-09-14
url: "https://github.com/GEOS-DEV/GEOS"
preferred-citation:
  authors:
  - family-names: Settgast
    given-names: Randolph R.
    orcid: "https://orcid.org/0000-0002-2536-7867"
  - family-names: Aronson
    given-names: Ryan M.
    orcid: "https://orcid.org/0009-0004-0785-5084"
  - family-names: Besset
    given-names: Julien R.
  - family-names: Borio
    given-names: Andrea
    orcid: "https://orcid.org/0000-0003-2016-5403"
  - family-names: Bui
    given-names: Quan M.
    orcid: "https://orcid.org/0000-0003-2648-0586"
  - family-names: Byer
    given-names: Thomas J.
  - family-names: Castelletto
    given-names: Nicola
    orcid: "https://orcid.org/0000-0001-6816-6769"
  - family-names: Citrain
    given-names: Aurélien
    orcid: "https://orcid.org/0009-0006-3742-1425"
  - family-names: Corbett
    given-names: Benjamin C.
    orcid: "https://orcid.org/0009-0008-7108-9651"
  - family-names: Corbett
    given-names: James
  - family-names: Cordier
    given-names: Philippe
    orcid: "https://orcid.org/0000-0002-6439-9263"
  - family-names: Cremon
    given-names: Matthias A.
    orcid: "https://orcid.org/0000-0001-7458-6401"
  - family-names: Crook
    given-names: Cameron M.
    orcid: "https://orcid.org/0000-0002-5366-6418"
  - family-names: Cusini
    given-names: Matteo
    orcid: "https://orcid.org/0000-0002-6024-861X"
  - family-names: Fei
    given-names: Fan
    orcid: "https://orcid.org/0000-0001-7273-4458"
  - family-names: Frambati
    given-names: Stefano
    orcid: "https://orcid.org/0000-0003-0683-1203"
  - family-names: Franc
    given-names: Jacques
    orcid: "https://orcid.org/0000-0002-8833-9425"
  - family-names: Franceschini
    given-names: Andrea
    orcid: "https://orcid.org/0000-0003-4395-5125"
  - family-names: Frigo
    given-names: Matteo
    orcid: "https://orcid.org/0000-0001-8150-1090"
  - family-names: Fu
    given-names: Pengcheng
    orcid: "https://orcid.org/0000-0002-7408-3350"
  - family-names: Gazzola
    given-names: Thomas
    orcid: "https://orcid.org/0000-0002-6103-4605"
  - family-names: Gross
    given-names: Herve
    orcid: "https://orcid.org/0000-0002-1747-2018"
  - family-names: Hamon
    given-names: Francois
    orcid: "https://orcid.org/0000-0001-8229-963X"
  - family-names: Han
    given-names: Brian M.
    orcid: "https://orcid.org/0009-0002-8549-7644"
  - family-names: Hao
    given-names: Yue
    orcid: "https://orcid.org/0000-0002-4543-8618"
  - family-names: Hasanzade
    given-names: Rasim
  - family-names: Homel
    given-names: Michael
    orcid: "https://orcid.org/0000-0002-0399-0092"
  - family-names: Huang
    given-names: Jian
    orcid: "https://orcid.org/0000-0002-5380-2563"
  - family-names: Jin
    given-names: Tao
    orcid: "https://orcid.org/0000-0001-6658-8941"
  - family-names: Ju
    given-names: Isaac
    orcid: "https://orcid.org/0000-0003-4110-7472"
  - family-names: Kachuma
    given-names: Dickson
  - family-names: Karimi-Fard
    given-names: Mohammad
    orcid: "https://orcid.org/0000-0001-5707-165X"
  - family-names: Kim
    given-names: Taeho
  - family-names: Klevtsov
    given-names: Sergey
    orcid: "https://orcid.org/0000-0001-9044-1827"
  - family-names: Lapene
    given-names: Alexandre
  - family-names: Magri
    given-names: Victor A. P.
    orcid: "https://orcid.org/0000-0002-3389-523X"
  - family-names: Mazuyer
    given-names: Antoine
    orcid: "https://orcid.org/0000-0002-0329-3385"
  - family-names: N'diaye
    given-names: Mamadou
  - family-names: Osei-Kuffuor
    given-names: Daniel
    orcid: "https://orcid.org/0000-0002-6111-6205"
  - family-names: Povolny
    given-names: Stefan
  - family-names: Ren
    given-names: Guotong
    orcid: "https://orcid.org/0000-0002-5821-9158"
  - family-names: Semnani
    given-names: Shabnam J.
  - family-names: Sherman
    given-names: Chris S.
    orcid: "https://orcid.org/0000-0003-3550-0657"
  - family-names: Rey
    given-names: Melvin
  - family-names: Tchelepi
    given-names: Hamdi A.
    orcid: "https://orcid.org/0000-0002-3084-6635"
  - family-names: Tobin
    given-names: William R.
    orcid: "https://orcid.org/0009-0001-3960-6064"
  - family-names: Tomin
    given-names: Pavel
    orcid: "https://orcid.org/0000-0003-4862-4288"
  - family-names: Untereiner
    given-names: Lionel
    orcid: "https://orcid.org/0000-0002-8025-2616"
  - family-names: Vargas
    given-names: Arturo
    orcid: "https://orcid.org/0000-0001-8001-5517"
  - family-names: Waziri
    given-names: Sohail
  - family-names: Wen
    given-names: Xianhuan
    orcid: "https://orcid.org/0000-0002-6055-4553"
  - family-names: White
    given-names: Joshua A.
    orcid: "https://orcid.org/0000-0003-3491-142X"
  - family-names: Wu
    given-names: Hui
    orcid: "https://orcid.org/0000-0002-9575-3886"
  date-published: 2024-10-10
  doi: 10.21105/joss.06973
  issn: 2475-9066
  issue: 102
  journal: Journal of Open Source Software
  publisher:
    name: Open Journals
  start: 6973
  title: "GEOS: A performance portable multi-physics simulation
    framework for subsurface applications"
  type: article
  url: "https://joss.theoj.org/papers/10.21105/joss.06973"
  volume: 9
title: "GEOS: A performance portable multi-physics simulation framework
  for subsurface applications"

Owner metadata

Name: GEOS
Login: GEOS-DEV
Email:
Kind: organization
Description: GEOS Simulation Framework
Website:
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/38363894?v=4
Repositories: 1
Last ynced at: 2023-04-13T23:40:41.659Z
Profile URL: https://github.com/GEOS-DEV

GitHub Events

Total

Commit comment event: 28
Create event: 443
Delete event: 384
Fork event: 19
Issue comment event: 913
Issues event: 186
Pull request event: 833
Pull request review comment event: 1834
Pull request review event: 2109
Push event: 6160
Watch event: 39

Last Year

Create event: 129
Delete event: 123
Fork event: 1
Issue comment event: 152
Issues event: 60
Pull request event: 276
Pull request review comment event: 357
Pull request review event: 337
Push event: 1897
Watch event: 4

Committers metadata

Last synced: 5 days ago

Total Commits: 4,555
Total Committers: 148
Avg Commits per committer: 30.777
Development Distribution Score (DDS): 0.668

Commits in past year: 216
Committers in past year: 35
Avg Commits per committer in past year: 6.171
Development Distribution Score (DDS) in past year: 0.875

Name	Email	Commits
Randolph R. Settgast	s**1@l**v	1511
Christopher Sherman	s**7@l**v	316
Benjamin Curtice Corbett	c**5@l**v	282
Pavel Tomin	p**n@u**m	182
TotoGaz	4**z@u**m	153
Matteo Cusini	4**M@u**m	114
Sergey Klevtsov	s**f@g**m	112
Francois Hamon	f**n@t**m	110
Sergey Klevtsov	k**v@s**u	104
Arturo Vargas	a**9@g**m	100
Francois Hamon	f**n@s**u	91
Antoine Mazuyer	a**r@p**m	90
Dickson Kachuma	8**a@u**m	85
Jian Huang	5**1@u**m	67
Matthias	m**n@s**u	61
Nicola Castelletto	3**1@u**m	61
Randolph R. Settgast	r**t@g**m	59
Brian Han	h**2@l**v	58
Joshua White	w**0@l**v	44
MelReyCG	1**G@u**m	42
Sy-Tuan Nguyen	4**n@u**m	42
Arnaud DUDES	1**0@u**m	41
Victor A. P. Magri	5**m@u**m	35
Nicola Castelletto	c**1@l**v	34
Ben Corbett	3**5@u**m	31
Antoine Mazuyer	3**r@u**m	28
Stefano Frambati	s**i@t**m	28
acitrain	6**n@u**m	27
Herve Gross	4**s@u**m	25
hannah_mairs	h**s@g**m	25
and 118 more...

Committer domains:

Issue and Pull Request metadata

Last synced: about 16 hours ago

Total issues: 686
Total pull requests: 2,247
Average time to close issues: 9 months
Average time to close pull requests: 2 months
Total issue authors: 141
Total pull request authors: 100
Average comments per issue: 2.51
Average comments per pull request: 1.99
Merged pull request: 1,387
Bot issues: 0
Bot pull requests: 33

Past year issues: 22
Past year pull requests: 237
Past year average time to close issues: 3 months
Past year average time to close pull requests: about 1 month
Past year issue authors: 14
Past year pull request authors: 31
Past year average comments per issue: 1.91
Past year average comments per pull request: 0.98
Past year merged pull request: 81
Past year bot issues: 0
Past year bot pull requests: 5

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/GEOS-DEV/GEOS

Top Issue Authors

rrsettgast (61)
TotoGaz (45)
paveltomin (45)
CusiniM (27)
jhuang2601 (23)
francoishamon (23)
sytuannguyen (22)
MelReyCG (21)
untereiner (21)
cssherman (21)
wrtobin (17)
klevzoff (15)
FishYNY (14)
joshua-white (13)
tbeltzun (11)

Top Pull Request Authors

paveltomin (345)
rrsettgast (208)
dkachuma (160)
CusiniM (158)
TotoGaz (100)
francoishamon (85)
arng40 (75)
MelReyCG (69)
jhuang2601 (66)
victorapm (62)
sframba (49)
bmhan12 (48)
jafranc (45)
acitrain (41)
frankfeifan (41)

Top Issue Labels

type: bug (250)
type: new (229)
type: feature (107)
type: cleanup / refactor (88)
type: documentation (42)
type: testing (27)
EPIC (23)
type: build system (19)
type: dev environment (9)
EPIC - FF/Import (7)
type: CI (6)
Theme - FF (5)
changes XML input (4)
ci: run integrated tests (4)
Theme - HF (3)
EPIC - Mesh/PerfRobust (3)
Theme (3)
flag: ready for review (2)
ci: ready to be merged (2)
EPIC - FF/Contact (2)
ci: run CUDA builds (2)
type: discussion (2)
type: visualization (2)
type: optimization (2)
EPIC - Mesh/mesh_doctor (2)
ci: run code coverage (1)
enhancement (1)
flag: no rebaseline (1)
bug (1)
flag: requires updated TPL(s) (1)

Top Pull Request Labels

ci: run integrated tests (1,013)
ci: run CUDA builds (836)
flag: ready for review (533)
flag: requires rebaseline (510)
flag: no rebaseline (434)
ci: run code coverage (414)
type: feature (303)
type: bug (281)
ci: ready to be merged (265)
flag: ready to be merged (261)
type: cleanup / refactor (232)
type: documentation (121)
flag: requires updated TPL(s) (61)
type: CI (56)
type: build system (52)
type: testing (48)
changes XML input (43)
flag: requires updated submodule(s) (42)
dependencies (36)
DO NOT MERGE ! (29)
type: optimization (20)
EPIC - FF/Contact (14)
github_actions (13)
flag: TPL(s) build check (13)
type: docs (10)
Theme - FF (9)
spe11 (8)
type: dev environment (8)
type: pygeosx (8)
type: new (6)

Package metadata

Total packages: 2
Total downloads: unknown
Total dependent packages: 0 (may contain duplicates)
Total dependent repositories: 0 (may contain duplicates)
Total versions: 8

proxy.golang.org: github.com/GEOS-DEV/GEOS

Homepage:
Documentation: https://pkg.go.dev/github.com/GEOS-DEV/GEOS#section-documentation
Licenses: lgpl-2.1
Latest release: v1.1.0 (published almost 2 years ago)
Last Synced: 2026-08-24T19:04:17.421Z (1 day ago)
Versions: 4
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent packages count: 5.395%
- Average: 5.576%
- Dependent repos count: 5.758%

proxy.golang.org: github.com/geos-dev/geos

Homepage:
Documentation: https://pkg.go.dev/github.com/geos-dev/geos#section-documentation
Licenses: lgpl-2.1
Latest release: v1.1.0 (published almost 2 years ago)
Last Synced: 2026-08-25T06:10:29.439Z (about 16 hours ago)
Versions: 4
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent packages count: 5.395%
- Average: 5.576%
- Dependent repos count: 5.758%

Dependencies

.github/workflows/ci_tests.yml actions

actions/checkout v3 composite
google-github-actions/auth v1 composite
google-github-actions/setup-gcloud v1 composite

.devcontainer/Dockerfile docker

docker.io/geosx/ubuntu20.04-gcc10 ${GEOS_TPL_TAG} build

.github/workflows/build_and_test.yml actions

actions/checkout v3 composite
google-github-actions/auth v1 composite
google-github-actions/setup-gcloud v1 composite

src/docs/sphinx/requirements.txt pypi

Sphinx >=7.0.0
docutils >=0.18
h5py *
matplotlib *
mpmath *
numpy *
pandas *
scipy *
sphinx-argparse *
sphinx-design *
sphinx_rtd_theme *
sphinxcontrib-plantuml *
sphinxcontrib-programoutput >=0.17

Score: -Infinity

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology