eo-tides 0.6.4.dev4__tar.gz → 0.6.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. eo_tides-0.6.5/.github/dependabot.yml +15 -0
  2. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/.gitignore +7 -1
  3. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/PKG-INFO +8 -3
  4. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/README.md +5 -0
  5. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/changelog.md +16 -0
  6. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/index.md +5 -0
  7. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/install.md +41 -22
  8. eo_tides-0.6.5/docs/notebooks/Case_study_intertidal.ipynb +695 -0
  9. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/notebooks/Model_tides.ipynb +33 -33
  10. eo_tides-0.6.5/docs/notebooks/Satellite_data.ipynb +2122 -0
  11. eo_tides-0.6.5/docs/notebooks/Tide_statistics.ipynb +3189 -0
  12. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/setup.md +120 -55
  13. eo_tides-0.6.5/paper/figures/joss_fig_list.png +0 -0
  14. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/paper/paper.bib +24 -11
  15. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/paper/paper.md +5 -5
  16. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/paper/paper.pdf +0 -0
  17. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/pyproject.toml +3 -3
  18. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/conftest.py +77 -29
  19. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/test_eo.py +14 -6
  20. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/test_model.py +19 -13
  21. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/test_stats.py +21 -9
  22. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/testing.ipynb +73 -8
  23. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/uv.lock +925 -877
  24. eo_tides-0.6.4.dev4/docs/notebooks/Case_study_intertidal.ipynb +0 -1288
  25. eo_tides-0.6.4.dev4/docs/notebooks/Satellite_data.ipynb +0 -903
  26. eo_tides-0.6.4.dev4/docs/notebooks/Tide_statistics.ipynb +0 -794
  27. eo_tides-0.6.4.dev4/paper/figures/joss_fig_list.png +0 -0
  28. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/.editorconfig +0 -0
  29. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  30. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
  31. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/.github/actions/setup-python-env/action.yml +0 -0
  32. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/.github/workflows/check-links.yml +0 -0
  33. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/.github/workflows/main.yml +0 -0
  34. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/.github/workflows/on-release-main.yml +0 -0
  35. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/.github/workflows/paper.yml +0 -0
  36. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/.pre-commit-config.yaml +0 -0
  37. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/CITATION.cff +0 -0
  38. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/CONTRIBUTING.md +0 -0
  39. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/Dockerfile +0 -0
  40. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/LICENSE +0 -0
  41. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/Makefile +0 -0
  42. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/codecov.yaml +0 -0
  43. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/api.md +0 -0
  44. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/dtu23_download.jpg +0 -0
  45. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/eo-tides-abstract.gif +0 -0
  46. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/eo-tides-logo-128.png +0 -0
  47. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/eo-tides-logo-256.png +0 -0
  48. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/eo-tides-logo.gif +0 -0
  49. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/eo-tides-logo.png +0 -0
  50. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/eot20_download.jpg +0 -0
  51. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/fes_ftp.jpg +0 -0
  52. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/fes_myproducts.jpg +0 -0
  53. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/fes_productselection.jpg +0 -0
  54. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/fes_subscriptions.jpg +0 -0
  55. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/got_download.jpg +0 -0
  56. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/tide_models_clipped.jpg +0 -0
  57. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/assets/tpxo_download.jpg +0 -0
  58. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/credits.md +0 -0
  59. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/migration.md +0 -0
  60. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/notebooks/Validating_tides.ipynb +0 -0
  61. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/docs/stylesheets/extra.css +0 -0
  62. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/eo_tides/__init__.py +0 -0
  63. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/eo_tides/eo.py +0 -0
  64. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/eo_tides/model.py +0 -0
  65. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/eo_tides/stats.py +0 -0
  66. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/eo_tides/utils.py +0 -0
  67. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/eo_tides/validation.py +0 -0
  68. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/mkdocs.yml +0 -0
  69. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/paper/benchmarking.ipynb +0 -0
  70. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/paper/figures/joss_abstract.png +0 -0
  71. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/paper/figures/joss_fig_gesla.png +0 -0
  72. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/paper/figures/joss_fig_pixel.png +0 -0
  73. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/paper/figures/joss_fig_stats.png +0 -0
  74. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/data/GESLA3_ALL 2.csv +0 -0
  75. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/data/IDO71013_2020.csv +0 -0
  76. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/data/broome-62650-aus-bom +0 -0
  77. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/data/san_diego_ca-569a-usa-uhslc +0 -0
  78. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/data/sydney_fort_denison-60370-aus-bom +0 -0
  79. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/data/tide_models.tar.gz +0 -0
  80. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/test_utils.py +0 -0
  81. {eo_tides-0.6.4.dev4 → eo_tides-0.6.5}/tests/test_validation.py +0 -0
@@ -0,0 +1,15 @@
1
+ # To get started with Dependabot version updates, you'll need to specify which
2
+ # package ecosystems to update and where the package manifests are located.
3
+ # Please see the documentation for all configuration options:
4
+ # https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
5
+
6
+ version: 2
7
+ updates:
8
+ - package-ecosystem: "uv" # See documentation for possible values
9
+ directory: "/" # Location of package manifests
10
+ schedule:
11
+ interval: "daily"
12
+ groups:
13
+ python-deps:
14
+ patterns:
15
+ - "*"
@@ -1,8 +1,14 @@
1
- # Ignore project-specific directories
1
+ # Ignore project-specific directories and files
2
+
2
3
  tests/data/tide_models
3
4
  tests/data/tide_models_clipped
4
5
  tests/data/tide_models_synthetic
6
+ tests/data/tide_models_synthetic_aus
7
+ tests/data/tide_models_synthetic_hawaii
8
+ tests/data/tide_models_synthetic_pacific
9
+ tests/data/tide_models_synthetic_uk
5
10
  docs/source
11
+ docs/notebooks/intertidal_map.tif
6
12
 
7
13
  # From https://raw.githubusercontent.com/github/gitignore/main/Python.gitignore
8
14
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: eo-tides
3
- Version: 0.6.4.dev4
3
+ Version: 0.6.5
4
4
  Summary: Tide modelling tools for large-scale satellite earth observation analysis
5
5
  Project-URL: Homepage, https://GeoscienceAustralia.github.io/eo-tides/
6
6
  Project-URL: Repository, https://github.com/GeoscienceAustralia/eo-tides
@@ -23,7 +23,7 @@ Classifier: Topic :: Scientific/Engineering :: Oceanography
23
23
  Classifier: Topic :: Scientific/Engineering :: Visualization
24
24
  Requires-Python: <4.0,>=3.10
25
25
  Requires-Dist: colorama>=0.4.3
26
- Requires-Dist: dask[complete]!=2025.3.0,>=2023.1.0
26
+ Requires-Dist: dask[complete]<2025.3.0,>=2023.1.0
27
27
  Requires-Dist: geopandas>=0.10.0
28
28
  Requires-Dist: matplotlib>=3.8.0
29
29
  Requires-Dist: numpy>=1.26.0
@@ -32,7 +32,7 @@ Requires-Dist: pandas>=2.2.0
32
32
  Requires-Dist: psutil>=5.8.0
33
33
  Requires-Dist: pyogrio>=0.10.0
34
34
  Requires-Dist: pyproj>=3.7.0
35
- Requires-Dist: pytmd==2.2.2
35
+ Requires-Dist: pytmd<2.2.5,>=2.2.2
36
36
  Requires-Dist: scikit-learn>=1.4.0
37
37
  Requires-Dist: scipy>=1.14.1
38
38
  Requires-Dist: shapely>=2.0.6
@@ -116,6 +116,11 @@ In addition, please consider also citing the underlying [`pyTMD` Python package]
116
116
  Sutterley, T. C., Alley, K., Brunt, K., Howard, S., Padman, L., Siegfried, M. (2017) pyTMD: Python-based tidal prediction software. 10.5281/zenodo.5555395
117
117
  ```
118
118
 
119
+ ## Contributing
120
+
121
+ 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).
122
+ Read the [Contributing guide](https://github.com/GeoscienceAustralia/eo-tides/blob/main/CONTRIBUTING.md) for details about how you can get involved.
123
+
119
124
  ## Acknowledgements
120
125
 
121
126
  For a full list of acknowledgements, refer to [Citations and Credits](https://geoscienceaustralia.github.io/eo-tides/credits/).
@@ -67,6 +67,11 @@ In addition, please consider also citing the underlying [`pyTMD` Python package]
67
67
  Sutterley, T. C., Alley, K., Brunt, K., Howard, S., Padman, L., Siegfried, M. (2017) pyTMD: Python-based tidal prediction software. 10.5281/zenodo.5555395
68
68
  ```
69
69
 
70
+ ## Contributing
71
+
72
+ 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).
73
+ Read the [Contributing guide](https://github.com/GeoscienceAustralia/eo-tides/blob/main/CONTRIBUTING.md) for details about how you can get involved.
74
+
70
75
  ## Acknowledgements
71
76
 
72
77
  For a full list of acknowledgements, refer to [Citations and Credits](https://geoscienceaustralia.github.io/eo-tides/credits/).
@@ -1,5 +1,21 @@
1
1
  # Changelog
2
2
 
3
+ ## v0.6.5
4
+
5
+ ### New features
6
+
7
+ - Support for `pyTMD` versions 2.2.3 and 2.2.4
8
+
9
+ ## v0.6.4
10
+
11
+ ### New features
12
+
13
+ - Updated installation documentation to improve reproducibility
14
+
15
+ ### Bug fixes
16
+
17
+ - Temporarily pinned Dask to avoid `odc-geo` and `odc-stac` errors
18
+
3
19
  ## v0.6.3
4
20
 
5
21
  ### New features
@@ -53,6 +53,11 @@ In addition, please consider also citing the underlying [`pyTMD` Python package]
53
53
  Sutterley, T. C., Alley, K., Brunt, K., Howard, S., Padman, L., Siegfried, M. (2017) pyTMD: Python-based tidal prediction software. 10.5281/zenodo.5555395
54
54
  ```
55
55
 
56
+ ## Contributing
57
+
58
+ 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).
59
+ Read the [Contributing guide](https://github.com/GeoscienceAustralia/eo-tides/blob/main/CONTRIBUTING.md) for details about how you can get involved.
60
+
56
61
  ## Next steps
57
62
 
58
63
  To get started, first follow the [guide to installing `eo-tides`](install.md), and then [set up one or multiple global ocean tide models](setup.md).
@@ -18,40 +18,54 @@ It is compatible with the following Python versions:
18
18
 
19
19
  === "Installing with `pip`"
20
20
 
21
- Install `eo-tides` with essential package dependencies only:
21
+ Install `eo-tides`:
22
22
  ```console
23
- python3 -m pip install eo-tides
23
+ python3 -m pip install eo-tides[notebooks]
24
24
  ```
25
25
 
26
- To install [additional package dependencies](https://github.com/GeoscienceAustralia/eo-tides/blob/main/pyproject.toml#L62-L69) required for running the included Jupyter Notebook examples (including `odc-stac` and `pystac-client` for loading freely available satellite data), run:
26
+ The code above will also install [additional package dependencies](https://github.com/GeoscienceAustralia/eo-tides/blob/main/pyproject.toml#L62-L69) required for running [Jupyter Notebook code examples](notebooks/Model_tides.ipynb) (including `odc-stac` and `pystac-client` for loading satellite data).
27
+
28
+ To install `eo-tides` with only essential package dependencies:
27
29
 
28
30
  ```console
29
- python3 -m pip install eo-tides[notebooks]
31
+ python3 -m pip install eo-tides
30
32
  ```
31
33
 
32
34
  === "Installing with `uv`"
33
35
 
34
36
  First, [install `uv` using the method of your choice](https://docs.astral.sh/uv/getting-started/installation/). Then:
35
37
 
36
- Create a new virtual environment:
38
+ Create a new virtual environment with your chosen version of Python:
37
39
  ```console
38
- uv venv
40
+ uv venv --python 3.13
39
41
  ```
40
42
 
41
43
  Activate your virtual environment:
44
+ === "Linux and macOS"
45
+ ```console
46
+ source .venv/bin/activate
47
+ ```
48
+ === "Windows"
49
+ ```console
50
+ .venv\Scripts\activate
51
+ ```
52
+
53
+ Install `eo-tides` into your virtual environment:
54
+
42
55
  ```console
43
- source .venv/bin/activate
56
+ uv pip install eo-tides[notebooks]
44
57
  ```
45
58
 
46
- Install `eo-tides` into your virtual environment, with essential package dependencies only:
59
+ The code above will also install [additional package dependencies](https://github.com/GeoscienceAustralia/eo-tides/blob/main/pyproject.toml#L62-L69) required for running [Jupyter Notebook code examples](notebooks/Model_tides.ipynb) (including `odc-stac` and `pystac-client` for loading satellite data).
60
+
61
+ To install `eo-tides` with only essential package dependencies:
47
62
  ```console
48
63
  uv pip install eo-tides
49
64
  ```
50
65
 
51
- To install [additional package dependencies](https://github.com/GeoscienceAustralia/eo-tides/blob/main/pyproject.toml#L62-L69) required for running the included Jupyter Notebook examples (including `odc-stac` and `pystac-client` for loading freely available satellite data), run:
52
-
66
+ You are now ready to run code using `eo-tides`! For example, you could launch your virtual environment with JupyterLab to run the [example Jupyter Notebooks](notebooks/Model_tides.ipynb):
53
67
  ```console
54
- uv pip install eo-tides[notebooks]
68
+ uv run --with jupyter jupyter lab
55
69
  ```
56
70
 
57
71
  ## Unstable development pre-releases
@@ -62,33 +76,38 @@ Unstable development pre-releases of `eo-tides` are also available:
62
76
 
63
77
  === "Installing with `pip`"
64
78
 
65
- Install an example `eo-tides` pre-release (see [full list here](https://pypi.org/project/eo-tides/#history)):
79
+ Install an example `eo-tides` pre-release (see [full list here](https://pypi.org/project/eo-tides/#history)), including additional `notebooks` dependencies:
66
80
  ```console
67
- python3 -m pip install eo-tides==0.6.3.dev5
81
+ python3 -m pip install eo-tides[notebooks]==0.6.3.dev5
68
82
  ```
69
83
 
70
84
  === "Installing with `uv`"
71
85
 
72
86
  First, [install `uv` using the method of your choice](https://docs.astral.sh/uv/getting-started/installation/). Then:
73
87
 
74
- Create a new virtual environment:
88
+ Create a new virtual environment with your chosen version of Python:
75
89
  ```console
76
- uv venv
90
+ uv venv --python 3.13
77
91
  ```
78
92
 
79
93
  Activate your virtual environment:
94
+ === "Linux and macOS"
95
+ ```console
96
+ source .venv/bin/activate
97
+ ```
98
+ === "Windows"
99
+ ```console
100
+ .venv\Scripts\activate
101
+ ```
102
+
103
+ Install an example `eo-tides` pre-release (see [full list here](https://pypi.org/project/eo-tides/#history)), including additional `notebooks` dependencies:
80
104
  ```console
81
- source .venv/bin/activate
82
- ```
83
-
84
- Install an example `eo-tides` pre-release (see [full list here](https://pypi.org/project/eo-tides/#history)):
85
- ```console
86
- uv pip install eo-tides==0.6.3.dev5
105
+ uv pip install eo-tides[notebooks]==0.6.3.dev5
87
106
  ```
88
107
 
89
108
  !!! important
90
109
 
91
- Unstable development pre-releases may contain bugs and untested new features. Unless you need access to a specific unpublished feature, we recommend installing the latest stable version instead.
110
+ Unstable development pre-releases may contain bugs and untested new features. Unless you need access to a specific unpublished feature, we recommend installing the latest [stable version](#stable-version) instead.
92
111
 
93
112
  ### Advanced: Developing locally
94
113