eo-tides

Provides powerful parallelized tools for integrating satellite Earth observation data with tide modelling.
https://github.com/geoscienceaustralia/eo-tides

Category: Hydrosphere
Sub Category: Waves and Currents

Keywords

coastal coastal-modelling earth-observation ocean-modelling oceanography remote-sensing satellite-data tide-modelling tides tidesandcurrents

Keywords from Contributors

transforms measur reporting compose optimize products animals simulator generic archiving

Last synced: about 24 hours ago
JSON representation

Repository metadata

Tide modelling tools for large-scale satellite earth observation analysis

README.md

eo-tides: Tide modelling tools for large-scale satellite earth observation analysis

Release
Build status
Python Version from PEP 621 TOML
codecov
License
JOSS paper

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.

eo-tides abstract showing satellite data, tide data array and tide animation

Highlights

  • 🌊 Model tide heights and phases (e.g. high, low, ebb, flow) from multiple global ocean tide models in parallel, and return a pandas.DataFrame for 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)

Supported tide models

eo-tides supports all ocean tide models supported by pyTMD. These include:

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
@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.

Citation (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"

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 4 days ago

Total Commits: 342
Total Committers: 6
Avg Commits per committer: 57.0
Development Distribution Score (DDS): 0.026

Commits in past year: 342
Committers in past year: 6
Avg Commits per committer in past year: 57.0
Development Distribution Score (DDS) in past year: 0.026

Name Email Commits
Robbi Bishop-Taylor R****r@g****u 333
dependabot[bot] 4****] 4
github-actions[bot] 4****] 2
Pierre de Buyl p****l@m****e 1
Freya Muir f****1@r****k 1
ClaireP c****s@g****u 1

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 49
Total pull requests: 59
Average time to close issues: 19 days
Average time to close pull requests: 2 days
Total issue authors: 7
Total pull request authors: 7
Average comments per issue: 1.29
Average comments per pull request: 1.0
Merged pull request: 56
Bot issues: 5
Bot pull requests: 7

Past year issues: 49
Past year pull requests: 59
Past year average time to close issues: 19 days
Past year average time to close pull requests: 2 days
Past year issue authors: 7
Past year pull request authors: 7
Past year average comments per issue: 1.29
Past year average comments per pull request: 1.0
Past year merged pull request: 56
Past year bot issues: 5
Past year bot pull requests: 7

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/geoscienceaustralia/eo-tides

Top Issue Authors

  • robbibt (35)
  • daniloceano (5)
  • github-actions[bot] (5)
  • lucas-langlois (1)
  • Baizitang (1)
  • pdebuyl (1)
  • jamespatrikrichards (1)

Top Pull Request Authors

  • robbibt (47)
  • dependabot[bot] (5)
  • github-actions[bot] (2)
  • tsutterley (2)
  • pdebuyl (1)
  • erialC-P (1)
  • fmemuir (1)

Top Issue Labels

  • bug (15)
  • enhancement (13)
  • documentation (8)
  • link-checker (5)
  • question (4)
  • testing (1)

Top Pull Request Labels

  • enhancement (5)
  • dependencies (5)
  • python:uv (5)
  • documentation (4)
  • bug (1)

Package metadata

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/
  • Licenses: Apache Software License
  • Latest release: 0.7.4 (published 17 days ago)
  • Last Synced: 2025-06-14T01:02:05.057Z (2 days ago)
  • Versions: 95
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 3,263 Last month
  • Rankings:
    • Dependent packages count: 10.298%
    • Average: 34.128%
    • Dependent repos count: 57.959%
  • Maintainers (1)

Score: 14.226273607165735