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 transforms raja measur archiving compose animals optimize

Last synced: about 11 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 (almost 7 years ago)
Default Branch: develop
Last Pushed: 2025-04-21T18:51:07.000Z (5 days ago)
Last Synced: 2025-04-21T19:46:41.320Z (5 days ago)
Topics: carbon-storage, geomechanics, gpu, hpc, llnl, reservoir-simulation
Language: C++
Homepage:
Size: 295 MB
Stars: 234
Watchers: 30
Forks: 92
Open Issues: 314
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

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: 213
Commit comment event: 5
Issues event: 97
Watch event: 27
Delete event: 190
Issue comment event: 582
Push event: 2989
Pull request review event: 1313
Pull request review comment event: 1086
Pull request event: 392
Fork event: 15

Last Year

Create event: 213
Commit comment event: 5
Issues event: 97
Watch event: 27
Delete event: 190
Issue comment event: 582
Push event: 2989
Pull request review event: 1313
Pull request review comment event: 1086
Pull request event: 392
Fork event: 15

Committers metadata

Last synced: 3 days ago

Total Commits: 4,255
Total Committers: 118
Avg Commits per committer: 36.059
Development Distribution Score (DDS): 0.636

Commits in past year: 334
Committers in past year: 39
Avg Commits per committer in past year: 8.564
Development Distribution Score (DDS) in past year: 0.76

Name	Email	Commits
Randolph R. Settgast	s**1@l**v	1550
Christopher Sherman	s**7@l**v	318
Benjamin Curtice Corbett	c**5@l**v	312
Sergey Klevtsov	s**f@g**m	214
Francois Hamon	f**n@t**m	201
TotoGaz	4****z	154
Pavel Tomin	p****n	131
Antoine Mazuyer	a**r@p**m	128
Matteo Cusini	4****M	127
Arturo Vargas	a**9@g**m	107
Nicola Castelletto	3****1	87
Matthias	m**n@s**u	61
Brian Han	h**2@l**v	56
Jian Huang	5****1	49
Joshua White	w**0@l**v	47
Dickson Kachuma	8****a	43
Sy-Tuan Nguyen	4****n	41
William R Tobin	4****n	31
MelReyCG	1****G	29
acitrain	6****n	25
Stefano Frambati	s**i@t**m	25
hannah_mairs	h**s@g**m	25
Herve Gross	4****s	24
Xavier Lacoste	x**0@g**m	24
Herve Gross	h**s@t**m	23
Lionel Untereiner	l**r@g**m	22
tbeltzun	1****n	21
Victor A. P. Magri	5****m	20
Yue Hao	h**1@l**v	19
Andrea Franceschini	f**0@d**t	18
and 88 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 703
Total pull requests: 1,462
Average time to close issues: 8 months
Average time to close pull requests: 2 months
Total issue authors: 129
Total pull request authors: 85
Average comments per issue: 2.59
Average comments per pull request: 2.3
Merged pull request: 977
Bot issues: 0
Bot pull requests: 14

Past year issues: 126
Past year pull requests: 571
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 27 days
Past year issue authors: 51
Past year pull request authors: 49
Past year average comments per issue: 1.72
Past year average comments per pull request: 2.23
Past year merged pull request: 342
Past year bot issues: 0
Past year bot pull requests: 12

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

Top Issue Authors

rrsettgast (57)
paveltomin (51)
TotoGaz (49)
CusiniM (28)
sytuannguyen (26)
francoishamon (25)
jhuang2601 (24)
MelReyCG (24)
untereiner (23)
cssherman (21)
wrtobin (17)
FishYNY (15)
klevzoff (15)
joshua-white (13)
tbeltzun (12)

Top Pull Request Authors

paveltomin (190)
rrsettgast (140)
CusiniM (118)
TotoGaz (94)
francoishamon (87)
dkachuma (80)
MelReyCG (40)
jhuang2601 (40)
bmhan12 (39)
arng40 (35)
sframba (34)
untereiner (34)
acitrain (33)
ryar9534 (30)
victorapm (30)

Top Issue Labels

type: bug (248)
type: new (241)
type: feature (116)
type: cleanup / refactor (88)
type: documentation (44)
type: testing (30)
EPIC (23)
type: build system (20)
type: dev environment (9)
type: CI (7)
EPIC - FF/Import (7)
Theme - FF (4)
changes XML input (4)
Theme - HF (3)
EPIC - FF/Contact (3)
Theme (3)
EPIC - Mesh/PerfRobust (3)
type: optimization (2)
type: discussion (2)
type: visualization (2)
EPIC - Mesh/mesh_doctor (2)
flag: requires updated TPL(s) (1)
EPIC - FF/Solvers (1)
duplicate (1)
flag: requires updated submodule(s) (1)

Top Pull Request Labels

ci: run integrated tests (519)
ci: run CUDA builds (404)
flag: requires rebaseline (369)
flag: ready for review (331)
flag: ready to be merged (271)
flag: no rebaseline (227)
type: feature (209)
ci: ready to be merged (197)
type: bug (186)
ci: run code coverage (182)
type: cleanup / refactor (160)
type: documentation (100)
flag: requires updated TPL(s) (47)
type: build system (39)
flag: requires updated submodule(s) (38)
type: testing (33)
type: CI (29)
changes XML input (24)
type: optimization (18)
DO NOT MERGE ! (17)
dependencies (15)
type: pygeosx (9)
type: dev environment (9)
spe11 (9)
flag: TPL(s) build check (6)
EPIC - FF/Import (5)
Theme - FF (5)
type: new (5)
EPIC - FF/Contact (4)
ci: ready for review (4)

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: 11.076959911413681

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology