eo-tides
eo-tides: Tide modelling tools for large-scale satellite Earth observation analysis - Published in JOSS (2025)
Science Score: 100.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 21 DOI reference(s) in README and JOSS metadata -
✓Academic publication links
Links to: joss.theoj.org -
✓Committers with academic emails
1 of 6 committers (16.7%) from academic institutions -
○Institutional organization owner
-
✓JOSS paper metadata
Published in Journal of Open Source Software
Keywords
Keywords from Contributors
Repository
Tide modelling tools for large-scale satellite Earth observation analysis
Basic Info
- Host: GitHub
- Owner: GeoscienceAustralia
- License: apache-2.0
- Language: Python
- Default Branch: main
- Homepage: https://GeoscienceAustralia.github.io/eo-tides/
- Size: 134 MB
Statistics
- Stars: 75
- Watchers: 4
- Forks: 10
- Open Issues: 11
- Releases: 45
Topics
Metadata Files
README.md
eo-tides: Tide modelling tools for large-scale satellite earth observation analysis
- ⚙️ Github repository: https://github.com/GeoscienceAustralia/eo-tides/
- 📦 PyPI: https://pypi.org/project/eo-tides/
- ℹ️ Documentation: https://GeoscienceAustralia.github.io/eo-tides/
- 📰 Paper: https://doi.org/10.21105/joss.07786
eo-tides provides powerful parallelized tools for integrating satellite Earth observation data with tide modelling. 🛠️🌊🛰️
eo-tides combines advanced tide modelling functionality from the pyTMD package with pandas, xarray and odc-geo, providing a suite of flexible tools for efficient analysis of coastal and ocean Earth observation data – from regional, continental, to global scale.
These tools can be applied to petabytes of freely available satellite data (e.g. from Digital Earth Australia or Microsoft Planetary Computer) loaded via Open Data Cube's odc-stac or datacube packages, supporting coastal and ocean earth observation analysis for any time period or location globally.
Highlights
- 🌊 Model tide heights and phases (e.g. high, low, ebb, flow) from multiple global ocean tide models in parallel, and return a
pandas.DataFramefor further analysis - 🛰️ "Tag" satellite data with tide heights based on the exact moment of image acquisition
- 🌐 Model tides for every individual satellite pixel through time, producing three-dimensional "tide height"
xarray-format datacubes that can be integrated with satellite data - 📈 Calculate statistics describing local tide dynamics, as well as biases caused by interactions between tidal processes and satellite orbits
- 🛠️ Validate modelled tides using measured sea levels from coastal tide gauges (e.g. GESLA Global Extreme Sea Level Analysis) <!-- - 🎯 Combine multiple tide models into a single locally-optimised "ensemble" model informed by satellite altimetry and satellite-observed patterns of tidal inundation -->
Supported tide models
eo-tides supports all ocean tide models supported by pyTMD. These include:
- Empirical Ocean Tide model (EOT20)
- Finite Element Solution tide models (FES2022, FES2014, FES2012)
- TOPEX/POSEIDON global tide models (TPXO10, TPXO9, TPXO8)
- Global Ocean Tide models (GOT5.6, GOT5.5, GOT4.10, GOT4.8, GOT4.7)
- Hamburg direct data Assimilation Methods for Tides models (HAMTIDE11)
- Technical University of Denmark tide models (DTU23)
For instructions on how to set up these models for use in eo-tides, refer to Setting up tide models.
Installing and setting up eo-tides
To get started with eo-tides, follow the Installation and Setting up tide models guides.
Jupyter Notebooks code examples
Interactive Jupyter Notebook usage examples and more complex coastal EO case studies can be found in the docs/notebooks/ directory, or rendered in the documentation here.
Citing eo-tides
To cite eo-tides in your work, please use the following Journal of Open Source Software citation:
Bishop-Taylor, R., Phillips, C., Sagar, S., Newey, V., & Sutterley, T., (2025). eo-tides: Tide modelling tools for large-scale satellite Earth observation analysis. Journal of Open Source Software, 10(109), 7786, https://doi.org/10.21105/joss.07786
BibTeX
``` @article{Bishop-Taylor2025, doi = {10.21105/joss.07786}, url = {https://doi.org/10.21105/joss.07786}, year = {2025}, publisher = {The Open Journal}, volume = {10}, number = {109}, pages = {7786}, author = {Robbi Bishop-Taylor and Claire Phillips and Stephen Sagar and Vanessa Newey and Tyler Sutterley}, title = {eo-tides: Tide modelling tools for large-scale satellite Earth observation analysis}, journal = {Journal of Open Source Software} } ```In addition, please consider also citing the underlying pyTMD Python package which powers the tide modelling functionality behind eo-tides:
Sutterley, T. C., Alley, K., Brunt, K., Howard, S., Padman, L., Siegfried, M. (2017) pyTMD: Python-based tidal prediction software. 10.5281/zenodo.5555395
Contributing
We welcome contributions to eo-tides, both through posting issues (e.g. bug reports or feature suggestions), or directly via pull requests (e.g. bug fixes and new features).
Read the Contributing guide for details about how you can get involved.
Acknowledgements
For a full list of acknowledgements, refer to Citations and Credits.
This repository was initialised using the cookiecutter-uv package.
Owner
- Name: Geoscience Australia
- Login: GeoscienceAustralia
- Kind: organization
- Location: Canberra, Australia
- Website: http://www.ga.gov.au/
- Repositories: 333
- Profile: https://github.com/GeoscienceAustralia
JOSS Publication
eo-tides: Tide modelling tools for large-scale satellite Earth observation analysis
Authors
Geoscience Australia, Australia
Geoscience Australia, Australia
Geoscience Australia, Australia
Geoscience Australia, Australia
University of Washington Applied Physics Laboratory, United States of America
Editor
Pierre de Buyl
Tags
Earth observation Tide modelling Remote sensing Coastal Satellite dataCitation (CITATION.cff)
cff-version: "1.2.0"
authors:
- family-names: Bishop-Taylor
given-names: Robbi
orcid: "https://orcid.org/0000-0002-1533-2599"
- family-names: Phillips
given-names: Claire
orcid: "https://orcid.org/0009-0003-9882-9131"
- family-names: Sagar
given-names: Stephen
orcid: "https://orcid.org/0000-0001-9568-9661"
- family-names: Newey
given-names: Vanessa
orcid: "https://orcid.org/0000-0003-3705-5665"
- family-names: Sutterley
given-names: Tyler
orcid: "https://orcid.org/0000-0002-6964-1194"
contact:
- family-names: Bishop-Taylor
given-names: Robbi
orcid: "https://orcid.org/0000-0002-1533-2599"
doi: 10.26186/150065
message: If you use this software, please cite our article in the
Journal of Open Source Software.
preferred-citation:
authors:
- family-names: Bishop-Taylor
given-names: Robbi
orcid: "https://orcid.org/0000-0002-1533-2599"
- family-names: Phillips
given-names: Claire
orcid: "https://orcid.org/0009-0003-9882-9131"
- family-names: Sagar
given-names: Stephen
orcid: "https://orcid.org/0000-0001-9568-9661"
- family-names: Newey
given-names: Vanessa
orcid: "https://orcid.org/0000-0003-3705-5665"
- family-names: Sutterley
given-names: Tyler
orcid: "https://orcid.org/0000-0002-6964-1194"
date-published: 2025-05-29
doi: 10.21105/joss.07786
issn: 2475-9066
issue: 109
journal: Journal of Open Source Software
publisher:
name: Open Journals
start: 7786
title: "eo-tides: Tide modelling tools for large-scale satellite Earth
observation analysis"
type: article
url: "https://joss.theoj.org/papers/10.21105/joss.07786"
volume: 10
title: "eo-tides: Tide modelling tools for large-scale satellite Earth
observation analysis"
GitHub Events
Total
- Fork event: 9
- Create event: 76
- Release event: 19
- Issues event: 71
- Watch event: 52
- Delete event: 52
- Member event: 4
- Issue comment event: 131
- Push event: 644
- Pull request review comment event: 2
- Pull request review event: 10
- Pull request event: 123
- Gollum event: 41
Last Year
- Fork event: 9
- Create event: 76
- Release event: 19
- Issues event: 71
- Watch event: 52
- Delete event: 52
- Member event: 4
- Issue comment event: 131
- Push event: 644
- Pull request review comment event: 2
- Pull request review event: 10
- Pull request event: 123
- Gollum event: 41
Committers
Last synced: 7 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Robbi Bishop-Taylor | R****r@g****u | 339 |
| github-actions[bot] | 4****] | 5 |
| dependabot[bot] | 4****] | 4 |
| Pierre de Buyl | p****l@m****e | 1 |
| Freya Muir | f****1@r****k | 1 |
| ClaireP | c****s@g****u | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 52
- Total pull requests: 121
- Average time to close issues: 20 days
- Average time to close pull requests: 2 days
- Total issue authors: 8
- Total pull request authors: 7
- Average comments per issue: 1.17
- Average comments per pull request: 0.92
- Merged pull requests: 109
- Bot issues: 5
- Bot pull requests: 20
Past Year
- Issues: 52
- Pull requests: 121
- Average time to close issues: 20 days
- Average time to close pull requests: 2 days
- Issue authors: 8
- Pull request authors: 7
- Average comments per issue: 1.17
- Average comments per pull request: 0.92
- Merged pull requests: 109
- Bot issues: 5
- Bot pull requests: 20
Top Authors
Issue Authors
- robbibt (38)
- daniloceano (5)
- github-actions[bot] (5)
- lucas-langlois (1)
- Baizitang (1)
- pdebuyl (1)
- jamespatrikrichards (1)
- onewhaleid (1)
Pull Request Authors
- robbibt (99)
- github-actions[bot] (10)
- dependabot[bot] (10)
- tsutterley (4)
- pdebuyl (2)
- erialC-P (2)
- fmemuir (2)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 4,089 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 112
- Total maintainers: 1
pypi.org: eo-tides
Tide modelling tools for large-scale satellite earth observation analysis
- Homepage: https://GeoscienceAustralia.github.io/eo-tides/
- Documentation: https://GeoscienceAustralia.github.io/eo-tides/
- License: Apache Software License
-
Latest release: 0.8.2
published 6 months ago