From 61f49d538daba0a0ffc69a657f43deb3f5ca57c0 Mon Sep 17 00:00:00 2001 From: Robbi Bishop-Taylor Date: Tue, 1 Oct 2024 03:47:02 +0000 Subject: [PATCH] Update readmes --- README.md | 35 ++++++++++++++++++++++++++++------- docs/index.md | 8 ++++---- 2 files changed, 32 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 3508b2f..4b1287c 100644 --- a/README.md +++ b/README.md @@ -14,14 +14,35 @@ The `eo-tides` package provides tools for analysing coastal and ocean satellite earth observation data using information about ocean tides. -`eo-tides` combines advanced tide modelling functionality from the [`pyTMD`](https://pytmd.readthedocs.io/en/latest/) package and integrates it with `pandas`, `xarray` and `odc-geo` to provide a powerful set of tools for integrating satellite imagery with tide data. +`eo-tides` combines advanced tide modelling functionality from the [`pyTMD`](https://pytmd.readthedocs.io/en/latest/) package and integrates it with `pandas`, `xarray` and `odc-geo` to provide a powerful set of parallelised tools for integrating satellite imagery with tide data – from local, regional to continental scale. -Some key functionality includes the ability to: +## Highlights -- Model tides from multiple global ocean tide models (e.g. FES2022, FES2014, TPXO9, EOT20 and many more) in parallel, and return tide heights in standardised `pandas.DataFrame` format for further analysis -- "Tag" satellite data timeseries with tide data based on the exact moment of each satellite acquisition -- Model tides for every individual satellite pixel, producing three-dimensional "tide height" `xarray`-format datacubes that can be combined 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 +- 🌊 Model tides from multiple global ocean tide models in parallel, and return tide heights in standardised `pandas.DataFrame` format for further analysis +- 🛰️ "Tag" satellite data with tide height and stage based on the exact moment of image acquisition +- 🌐 Model tides for every individual satellite pixel, producing three-dimensional "tide height" `xarray`-format datacubes that can be combined with satellite data +- 🎯 Combine multiple tide models into a single locally-optimised "ensemble" model informed by satellite altimetry and satellite-observed patterns of tidal inundation +- 📈 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) These tools can be applied directly 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. + +## Supported tide models + +`eo-tides` supports [all ocean tide models supported by `pyTMD`](https://pytmd.readthedocs.io/en/latest/getting_started/Getting-Started.html#model-database). These include: + +- [Finite Element Solution tide models](https://doi.org/10.5194/os-2020-96) (`FES2022`, `FES2014`, `FES2012`) +- [TOPEX/POSEIDON global tide models](https://www.tpxo.net/global) (`TPXO10`, `TPXO9`, `TPXO8`) +- [Global Ocean Tide models](https://doi.org/10.1002/2016RG000546) (`GOT5.6`, `GOT5.5`, `GOT4.10`) +- [Empirical Ocean Tide models](https://doi.org/10.5194/essd-13-3869-2021) (`EOT20`) +- [Hamburg direct data Assimilation Methods for Tides models](https://doi.org/10.1002/2013JC009766) (`HAMTIDE11`) + +For instructions on how to set up these models for use in `eo-tides`, refer to [Setting up tide models](https://geoscienceaustralia.github.io/eo-tides/setup/). + +## Citing `eo-tides` + +To cite `eo-tides` in your work, please use the following citation: + +``` +Bishop-Taylor, R., Sagar, S., Phillips, C., & Newey, V. (2024). eo-tides: Tide modelling tools for large-scale satellite earth observation analysis [Computer software]. https://github.com/GeoscienceAustralia/eo-tides +``` diff --git a/docs/index.md b/docs/index.md index 135bf6c..cf6a8af 100644 --- a/docs/index.md +++ b/docs/index.md @@ -18,10 +18,10 @@ The `eo-tides` package provides tools for analysing coastal and ocean satellite - 🌊 Model tides from multiple global ocean tide models in parallel, and return tide heights in standardised `pandas.DataFrame` format for further analysis - 🛰️ "Tag" satellite data with tide height and stage based on the exact moment of image acquisition -- 🧊 Model tides for every individual satellite pixel, producing three-dimensional "tide height" `xarray`-format datacubes that can be combined with satellite data -- ⚙️ Combine multiple tide models into a single locally-optimised "ensemble" model informed by satellite altimetry and satellite-observed patterns of tidal inundation -- 📊 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) +- 🌐 Model tides for every individual satellite pixel, producing three-dimensional "tide height" `xarray`-format datacubes that can be combined with satellite data +- 🎯 Combine multiple tide models into a single locally-optimised "ensemble" model informed by satellite altimetry and satellite-observed patterns of tidal inundation +- 📈 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) These tools can be applied directly 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.