Thetis
An unstructured grid coastal ocean model built using the Firedrake finite element framework.
https://github.com/thetisproject/thetis
Category: Hydrosphere
Sub Category: Coastal and Reefs
Keywords from Contributors
petsc code-generation e3sm-model ngee-arctic pflotran amcg firedrake mesh-adaptation moving-mesh pyadjoint
Last synced: about 16 hours ago
JSON representation
Repository metadata
Finite element flow solver for simulating coastal and estuarine flows.
- Host: GitHub
- URL: https://github.com/thetisproject/thetis
- Owner: thetisproject
- License: other
- Created: 2015-12-11T18:43:31.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2025-10-23T09:53:49.000Z (2 months ago)
- Last Synced: 2025-10-23T11:11:07.266Z (2 months ago)
- Language: Python
- Size: 56.6 MB
- Stars: 77
- Watchers: 23
- Forks: 32
- Open Issues: 35
- Releases: 19
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
- Authors: AUTHORS
readme.md
🌊 Thetis
Thetis is an open-source, finite element framework for simulating coastal and estuarine flows with advanced numerics, high flexibility, and easy extensibility.
Thetis builds on the Firedrake finite element library to provide robust solvers for 2D/3D shallow water equations and related physical processes in the coastal ocean.
🌟 Key Features
✅ 2D depth-averaged and 3D baroclinic shallow water solvers
✅ Wetting and drying schemes for realistic coastlines
✅ Scalar transport (salinity, temperature, tracers)
✅ Adjoint capabilities for data assimilation and inverse modeling
✅ Flexible unstructured meshes
✅ Open-source and easily extensible Python codebase
📚 Full documentation and installation instructions are available at thetisproject.org
🚀 Installation
Please see the installation instructions on the website for full details.
For the release branch:
- Install Firedrake and activate its virtual environment.
- Install Thetis within the Firedrake environment:
pip install git+https://github.com/thetisproject/thetis.git
You can instead install and switch between different versions of Thetis with:
git clone https://github.com/thetisproject/thetis
cd thetis
git checkout <branch_name>
pip install -e .
Note
The latest development branch of Thetis (master) will require the corresponding main branch of Firedrake. See the
website for more details.
Release branch weekly status
Getting Started
To get up and running with Thetis once it has been installed, we recommend checking out the basic tutorials and
documentation. Further examples can then be found in the
repository at examples. See examples/README.md for
detailed descriptions of each example script.
📬 Questions?
Check the website for ways of reaching out to developers!
Citing Thetis
If Thetis is helpful in your research, please cite:
Kärnä, T., Kramer, S. C., Mitchell, L., Ham, D. A., Piggott, M. D. & Baptista, A. M. (2018).
Thetis coastal ocean model: discontinuous Galerkin discretization for the three-dimensional hydrostatic equations.
Geoscientific Model Development, 11: 4359–4382.
doi: 10.5194/gmd-11-4359-2018
License
Thetis is available under the MIT License. See the LICENSE file for details.
Owner metadata
- Name: thetisproject
- Login: thetisproject
- Email:
- Kind: organization
- Description:
- Website:
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/17277005?v=4
- Repositories: 2
- Last ynced at: 2023-03-08T11:26:51.198Z
- Profile URL: https://github.com/thetisproject
GitHub Events
Total
- Issues event: 22
- Watch event: 5
- Delete event: 16
- Issue comment event: 74
- Push event: 124
- Pull request review comment event: 59
- Pull request review event: 85
- Pull request event: 48
- Fork event: 4
- Create event: 28
Last Year
- Issues event: 22
- Watch event: 5
- Delete event: 16
- Issue comment event: 72
- Push event: 120
- Pull request event: 47
- Pull request review comment event: 59
- Pull request review event: 85
- Fork event: 4
- Create event: 27
Committers metadata
Last synced: about 2 months ago
Total Commits: 1,851
Total Committers: 26
Avg Commits per committer: 71.192
Development Distribution Score (DDS): 0.41
Commits in past year: 50
Committers in past year: 7
Avg Commits per committer in past year: 7.143
Development Distribution Score (DDS) in past year: 0.64
| Name | Commits | |
|---|---|---|
| Tuomas Karna | t****a@g****m | 1092 |
| Joe Wallwork | j****6@i****k | 221 |
| Stephan Kramer | s****r@i****k | 218 |
| Lawrence Mitchell | l****l@i****k | 58 |
| Tuomas Karna | k****t@s****g | 51 |
| mc4117 | m****7@i****k | 48 |
| Athanasios Angeloudis | a****6@i****k | 47 |
| Connor Jordan | 1****n | 23 |
| Simon Warder | s****5@i****k | 19 |
| Connor Ward | c****0@i****k | 11 |
| David Ham | D****m@i****k | 11 |
| acse-ej321 | 8****1 | 10 |
| Mariana Clare | m****2@h****k | 8 |
| Simon Warder | s****5@e****k | 8 |
| Nicolas Barral | n****l@i****k | 7 |
| acse-ej321 | a****1@g****m | 5 |
| Jon Hill | j****l@y****k | 4 |
| Andrew T. T. McRae | d****r | 2 |
| Connor Jordan | 1****2 | 1 |
| Jack Betteridge | 4****e | 1 |
| Matthew Piggott | m****t | 1 |
| Pablo Brubeck | b****k@p****m | 1 |
| Wei Pan | p****8@f****m | 1 |
| Athanasios Angeloudis | a****6@i****k | 1 |
| Athanasios Angeloudis | a****6@e****k | 1 |
| jonathanlee | 1****e | 1 |
Committer domains:
- imperial.ac.uk: 9
- ese-dcoles.ese.ic.ac.uk: 1
- foxmail.com: 1
- york.ac.uk: 1
- github.com: 1
- ese-swarder15.ese.ic.ac.uk: 1
- hotmail.co.uk: 1
- ic.ac.uk: 1
- stccmop.org: 1
Issue and Pull Request metadata
Last synced: about 2 months ago
Total issues: 44
Total pull requests: 165
Average time to close issues: 3 months
Average time to close pull requests: about 2 months
Total issue authors: 20
Total pull request authors: 14
Average comments per issue: 2.23
Average comments per pull request: 1.07
Merged pull request: 116
Bot issues: 0
Bot pull requests: 0
Past year issues: 15
Past year pull requests: 57
Past year average time to close issues: about 2 months
Past year average time to close pull requests: about 1 month
Past year issue authors: 7
Past year pull request authors: 8
Past year average comments per issue: 1.67
Past year average comments per pull request: 0.95
Past year merged pull request: 26
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- jwallwork23 (8)
- cpjordan (7)
- tkarna (4)
- stephankramer (4)
- jhill1 (3)
- Sijbrandb (2)
- MaihgrUmosch (2)
- jonathclee (2)
- acse-ej321 (1)
- thangel (1)
- dbsi-pinkman (1)
- hcerbone (1)
- JDBetteridge (1)
- acse-ra2617 (1)
- devmrs (1)
Top Pull Request Authors
- jwallwork23 (44)
- cpjordan (44)
- stephankramer (33)
- tkarna (18)
- connorjward (6)
- jhill1 (6)
- seimurss (3)
- acse-ej321 (3)
- jonathclee (2)
- JDBetteridge (2)
- wence- (1)
- LawrenceDior (1)
- f-haces (1)
- pbrubeck (1)
Top Issue Labels
- enhancement (7)
- bug (3)
Top Pull Request Labels
- bug (7)
- enhancement (2)
Dependencies
- netCDF4 *
- pyproj *
- pytz *
- scipy *
- traitlets *
- uptide *
- actions/checkout v2 composite
- actions/setup-python v2 composite
Score: 7.976595409316577