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

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

Last synced: about 8 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 7 years ago)
Default Branch: develop
Last Pushed: 2025-12-12T03:25:34.000Z (14 days ago)
Last Synced: 2025-12-12T11:18:16.369Z (14 days ago)
Topics: carbon-storage, geomechanics, gpu, hpc, llnl, reservoir-simulation
Language: C++
Homepage:
Size: 616 MB
Stars: 256
Watchers: 29
Forks: 97
Open Issues: 296
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

Create event: 354
Commit comment event: 28
Issues event: 160
Watch event: 36
Delete event: 288
Issue comment event: 844
Push event: 4848
Pull request review event: 1963
Pull request review comment event: 1631
Pull request event: 625
Fork event: 18

Last Year

Create event: 349
Commit comment event: 27
Issues event: 161
Watch event: 36
Delete event: 285
Issue comment event: 833
Push event: 4803
Pull request event: 620
Pull request review event: 1958
Pull request review comment event: 1628
Fork event: 18

Committers metadata

Last synced: 13 days ago

Total Commits: 4,438
Total Committers: 125
Avg Commits per committer: 35.504
Development Distribution Score (DDS): 0.648

Commits in past year: 274
Committers in past year: 35
Avg Commits per committer in past year: 7.829
Development Distribution Score (DDS) in past year: 0.701

Name	Email	Commits
Randolph R. Settgast	s**1@l**v	1564
Christopher Sherman	s**7@l**v	318
Benjamin Curtice Corbett	c**5@l**v	313
Sergey Klevtsov	s**f@g**m	216
Francois Hamon	f**n@t**m	201
Pavel Tomin	p****n	181
TotoGaz	4****z	154
Matteo Cusini	4****M	128
Antoine Mazuyer	a**r@p**m	128
Arturo Vargas	a**9@g**m	107
Nicola Castelletto	3****1	91
Dickson Kachuma	8****a	62
Jian Huang	5****1	62
Matthias	m**n@s**u	61
Brian Han	h**2@l**v	58
Joshua White	w**0@l**v	47
Sy-Tuan Nguyen	4****n	42
MelReyCG	1****G	38
Arnaud DUDES	1****0	34
William R Tobin	4****n	31
Stefano Frambati	s**i@t**m	28
acitrain	6****n	27
Herve Gross	4****s	25
hannah_mairs	h**s@g**m	25
Xavier Lacoste	x**0@g**m	24
Victor A. P. Magri	5****m	24
Herve Gross	h**s@t**m	23
Lionel Untereiner	l**r@g**m	22
tbeltzun	1****n	21
Yue Hao	h**1@l**v	19
and 95 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 6 days ago

Total issues: 674
Total pull requests: 2,105
Average time to close issues: 9 months
Average time to close pull requests: 2 months
Total issue authors: 137
Total pull request authors: 92
Average comments per issue: 2.53
Average comments per pull request: 2.05
Merged pull request: 1,323
Bot issues: 0
Bot pull requests: 30

Past year issues: 53
Past year pull requests: 510
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 21 days
Past year issue authors: 30
Past year pull request authors: 42
Past year average comments per issue: 1.51
Past year average comments per pull request: 1.06
Past year merged pull request: 205
Past year bot issues: 0
Past year bot pull requests: 13

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

Top Issue Authors

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

Top Pull Request Authors

paveltomin (346)
rrsettgast (200)
CusiniM (158)
dkachuma (139)
TotoGaz (100)
francoishamon (85)
arng40 (69)
MelReyCG (65)
jhuang2601 (60)
sframba (49)
bmhan12 (48)
victorapm (47)
acitrain (41)
untereiner (38)
cssherman (37)

Top Issue Labels

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

Top Pull Request Labels

ci: run integrated tests (903)
ci: run CUDA builds (726)
flag: ready for review (476)
flag: requires rebaseline (470)
flag: no rebaseline (388)
ci: run code coverage (326)
type: feature (274)
ci: ready to be merged (265)
flag: ready to be merged (261)
type: bug (258)
type: cleanup / refactor (219)
type: documentation (116)
flag: requires updated TPL(s) (55)
type: build system (52)
type: CI (51)
type: testing (46)
changes XML input (38)
flag: requires updated submodule(s) (38)
dependencies (32)
DO NOT MERGE ! (28)
type: optimization (20)
flag: TPL(s) build check (12)
type: pygeosx (8)
type: dev environment (8)
type: docs (8)
spe11 (8)
github_actions (7)
EPIC - FF/Contact (7)
Theme - FF (6)
type: new (4)

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 over 1 year ago)
Last Synced: 2025-12-19T22:08:57.095Z (6 days 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 over 1 year ago)
Last Synced: 2025-12-19T22:08:57.507Z (6 days ago)
Versions: 4
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Dependent packages count: 5.395%
- Average: 5.576%
- Dependent repos count: 5.758%

Dependencies

src/coreComponents/python/modules/geosx_mesh_doctor/pyproject.toml pypi

src/coreComponents/python/modules/geosx_mesh_doctor/requirements.txt pypi

networkx >=2.4
numpy *
tqdm *
vtk >=9.1

src/coreComponents/python/modules/geosx_mesh_doctor/setup.py pypi

src/coreComponents/python/modules/geosx_mesh_tools_package/pyproject.toml pypi

src/coreComponents/python/modules/geosx_xml_tools_package/pyproject.toml pypi

src/coreComponents/python/modules/hdf5_wrapper_package/pyproject.toml pypi

src/coreComponents/python/modules/pygeosx_tools_package/pyproject.toml pypi

src/coreComponents/python/modules/timehistory_package/pyproject.toml pypi

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

.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

Score: -Infinity

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology