eo-tides 0.7.3.dev5__tar.gz → 0.7.4__tar.gz

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/.github/dependabot.yml

@@ -13,3 +13,6 @@ updates:
       python-deps:
         patterns:
           - "*"
+    labels:
+      - "dependencies"
+      - "packaging"

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/.github/release.yml

@@ -11,6 +11,9 @@ changelog:
     - title: Bug fixes
       labels:
         - bug
+    - title: Documentation updates
+      labels:
+        - documentation
     - title: Other changes
       labels:
         - "*"

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/.github/workflows/paper.yml

@@ -1,19 +1,5 @@
 name: Draft paper PDF
-on:
-  push:
-    branches:
-      - main
-      - JOSS_paper
-    paths:
-      - paper/**
-      - .github/workflows/paper.yml
-  pull_request:
-    branches:
-      - main
-      - JOSS_paper
-    paths:
-      - paper/**
-      - .github/workflows/paper.yml
+on: workflow_dispatch
 
 jobs:
   paper:

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/.pre-commit-config.yaml

@@ -10,16 +10,10 @@ repos:
       - id: trailing-whitespace
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    # Ruff version.
     rev: v0.6.4
     hooks:
-      # Run the linter.
-      - id: ruff
-        types_or: [python, pyi]
-        args: [--fix, --select=I] # --select=ALL, I
-      # Run the formatter.
-      - id: ruff-format
-        types_or: [python, pyi]
+      - id: ruff # Run linter using pyproject.toml config
+      - id: ruff-format # Run formatter using pyproject.toml config
 
   - repo: https://github.com/pre-commit/mirrors-prettier
     rev: "v3.0.3"

eo_tides-0.7.4/CITATION.cff

@@ -0,0 +1,56 @@
+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"

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eo-tides
-Version: 0.7.3.dev5
+Version: 0.7.4
 Summary: Tide modelling tools for large-scale satellite earth observation analysis
 Project-URL: Homepage, https://GeoscienceAustralia.github.io/eo-tides/
 Project-URL: Repository, https://github.com/GeoscienceAustralia/eo-tides
@@ -104,12 +104,33 @@ Interactive Jupyter Notebook usage examples and more complex coastal EO case stu
 
 ## Citing `eo-tides`
 
-To cite `eo-tides` in your work, please use the following citation:
+To cite `eo-tides` in your work, please use the following Journal of Open Source Software citation:
 
 ```
-Bishop-Taylor, R., Sagar, S., Phillips, C., & Newey, V. (2024). eo-tides: Tide modelling tools for large-scale satellite earth observation analysis. https://github.com/GeoscienceAustralia/eo-tides
+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
 ```
 
+<details>
+
+<summary>BibTeX</summary>
+
+```
+@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}
+}
+```
+
+</details>
+
 In addition, please consider also citing the underlying [`pyTMD` Python package](https://pytmd.readthedocs.io/en/latest/) which powers the tide modelling functionality behind `eo-tides`:
 
 ```

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/README.md

@@ -55,12 +55,33 @@ Interactive Jupyter Notebook usage examples and more complex coastal EO case stu
 
 ## Citing `eo-tides`
 
-To cite `eo-tides` in your work, please use the following citation:
+To cite `eo-tides` in your work, please use the following Journal of Open Source Software citation:
 
 ```
-Bishop-Taylor, R., Sagar, S., Phillips, C., & Newey, V. (2024). eo-tides: Tide modelling tools for large-scale satellite earth observation analysis. https://github.com/GeoscienceAustralia/eo-tides
+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
 ```
 
+<details>
+
+<summary>BibTeX</summary>
+
+```
+@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}
+}
+```
+
+</details>
+
 In addition, please consider also citing the underlying [`pyTMD` Python package](https://pytmd.readthedocs.io/en/latest/) which powers the tide modelling functionality behind `eo-tides`:
 
 ```

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/docs/changelog.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.7.3 - 2025-05-22
+
+### Changes
+
+- Use dynamic version handling via `hatch-vcs`, add automatic changelog update action by @robbibt in https://github.com/GeoscienceAustralia/eo-tides/pull/95
+- Bump the python-deps group with 2 updates by @dependabot in https://github.com/GeoscienceAustralia/eo-tides/pull/94
+
+**Full Changelog**: https://github.com/GeoscienceAustralia/eo-tides/compare/0.7.2...0.7.3
+
 ## 0.7.2 - 2025-05-19
 
 ### New features
@@ -101,6 +110,7 @@ Minor update to package dependencies
   - Added a new `point_col` parameter to `tide_stats` to control the colour of plotted points. If `plot_var` is also provided, points will now be coloured differently by default.
 
 - Added a new `crop_buffer` parameter to configure buffer distance when cropping model files with `crop=True` (defaults to 5 degrees)
+
 - Reorder `model_tides` parameters to provide more logical flow and move more common params like `mode`, `output_format` and `output_units` higher
 
 ### Bug fixes
@@ -162,5 +172,3 @@ Minor update to package dependencies
 ### Breaking changes
 
 See [Migrating from DEA Tools](migration.md) for a guide to updating your code from the original [`Digital Earth Australia Notebooks and Tools` repository](https://github.com/GeoscienceAustralia/dea-notebooks/).
-
-<!-- ### Bug fixes -->

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/docs/credits.md

@@ -1,10 +1,29 @@
 ## Citing `eo-tides`
 
-To cite `eo-tides` in your work, please use the following software citation:
-
-```
-Bishop-Taylor, R., Sagar, S., Phillips, C., & Newey, V. (2024). eo-tides: Tide modelling tools for large-scale satellite earth observation analysis. https://github.com/GeoscienceAustralia/eo-tides
-```
+To cite `eo-tides` in your work, please use the following Journal of Open Source Software citation:
+
+=== "Plain text"
+
+    ```
+    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](https://pytmd.readthedocs.io/en/latest/) which powers the tide modelling functionality behind `eo-tides`:
 

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/docs/index.md

@@ -41,11 +41,30 @@ For instructions on how to set up these models for use in `eo-tides`, refer to [
 
 ## 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. https://github.com/GeoscienceAustralia/eo-tides
-```
+To cite `eo-tides` in your work, please use the following Journal of Open Source Software citation:
+
+=== "Plain text"
+
+    ```
+    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](https://pytmd.readthedocs.io/en/latest/) which powers the tide modelling functionality behind `eo-tides`:
 

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/docs/notebooks/Case_study_intertidal.ipynb

@@ -49,10 +49,10 @@
    "metadata": {},
    "outputs": [],
    "source": [
+    "import matplotlib.pyplot as plt\n",
     "import odc.stac\n",
-    "import pystac_client\n",
     "import planetary_computer\n",
-    "import matplotlib.pyplot as plt\n",
+    "import pystac_client\n",
     "\n",
     "from eo_tides.eo import tag_tides\n",
     "from eo_tides.stats import tide_stats\n",
@@ -264,7 +264,7 @@
    ],
    "source": [
     "# Calculate NDWI\n",
-    "ds[[\"ndwi\"]] = (ds.green - ds.nir08) / (ds.green + ds.nir08) \n",
+    "ds[[\"ndwi\"]] = (ds.green - ds.nir08) / (ds.green + ds.nir08)\n",
     "\n",
     "# Plot a single timestep\n",
     "ds.ndwi.isel(time=1).plot.imshow(vmin=-0.5, vmax=0.5, cmap=\"RdBu\")"

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/docs/notebooks/Model_tides.ipynb

@@ -222,9 +222,10 @@
     }
    ],
    "source": [
-    "from eo_tides.model import model_tides\n",
     "import pandas as pd\n",
     "\n",
+    "from eo_tides.model import model_tides\n",
+    "\n",
     "tide_df = model_tides(\n",
     "    x=122.2186,\n",
     "    y=-18.0008,\n",
@@ -680,13 +681,11 @@
     }
    ],
    "source": [
-    "df = pd.DataFrame(\n",
-    "    {\n",
-    "        \"time\": pd.date_range(start=\"2018-01-01\", end=\"2018-01-31\", periods=2),\n",
-    "        \"x\": [122.21, 122.22],\n",
-    "        \"y\": [-18.20, -18.21],\n",
-    "    }\n",
-    ")\n",
+    "df = pd.DataFrame({\n",
+    "    \"time\": pd.date_range(start=\"2018-01-01\", end=\"2018-01-31\", periods=2),\n",
+    "    \"x\": [122.21, 122.22],\n",
+    "    \"y\": [-18.20, -18.21],\n",
+    "})\n",
     "df"
    ]
   },
@@ -1496,7 +1495,7 @@
     "    x=122.2186,\n",
     "    y=-18.0008,\n",
     "    time=pd.date_range(start=\"2018-01-01\", end=\"2018-01-02\", freq=\"5h\"),\n",
-    "    time_offset='30 min',\n",
+    "    time_offset=\"30 min\",\n",
     "    directory=directory,\n",
     ")"
    ]

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/docs/notebooks/Satellite_data.ipynb

@@ -109,8 +109,8 @@
    ],
    "source": [
     "import odc.stac\n",
-    "import pystac_client\n",
     "import planetary_computer\n",
+    "import pystac_client\n",
     "\n",
     "# Connect to STAC catalog\n",
     "catalog = pystac_client.Client.open(\n",
@@ -1031,7 +1031,7 @@
     ")\n",
     "\n",
     "# Plot the first four timesteps in our data\n",
-    "tides_lowres.isel(time=[0, 1, 2, 3]).plot.imshow(col=\"time\", vmin=-3, vmax=3, cmap=\"RdBu\")\n"
+    "tides_lowres.isel(time=[0, 1, 2, 3]).plot.imshow(col=\"time\", vmin=-3, vmax=3, cmap=\"RdBu\")"
    ]
   },
   {
@@ -2071,14 +2071,14 @@
     "import pandas as pd\n",
     "\n",
     "custom_times = pd.date_range(\n",
-    "    start=\"2022-01-01\", \n",
-    "    end=\"2022-01-02\", \n",
+    "    start=\"2022-01-01\",\n",
+    "    end=\"2022-01-02\",\n",
     "    freq=\"6h\",\n",
     ")\n",
     "\n",
     "# Model tides spatially\n",
     "tides_highres = pixel_tides(\n",
-    "    data=ds, \n",
+    "    data=ds,\n",
     "    time=custom_times,\n",
     "    model=model,\n",
     "    directory=directory,\n",

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/docs/notebooks/Tide_statistics.ipynb

@@ -701,8 +701,8 @@
    ],
    "source": [
     "import odc.stac\n",
-    "import pystac_client\n",
     "import planetary_computer\n",
+    "import pystac_client\n",
     "\n",
     "# Connect to STAC catalog\n",
     "catalog = pystac_client.Client.open(\n",
@@ -807,7 +807,7 @@
     "    data=ds_s2,\n",
     "    model=model,\n",
     "    directory=directory,\n",
-    ")\n"
+    ")"
    ]
   },
   {
@@ -1603,7 +1603,7 @@
     "    data=ds_s1,\n",
     "    model=model,\n",
     "    directory=directory,\n",
-    ")\n"
+    ")"
    ]
   },
   {
@@ -2411,7 +2411,7 @@
     "    plot_var=\"satellite_name\",\n",
     "    model=model,\n",
     "    directory=directory,\n",
-    ")\n"
+    ")"
    ]
   },
   {
@@ -3110,7 +3110,7 @@
     "import matplotlib.pyplot as plt\n",
     "\n",
     "stats_ds.spread.plot.imshow()\n",
-    "plt.gca().set_title(\"Spread (%)\");\n"
+    "plt.gca().set_title(\"Spread (%)\");"
    ]
   },
   {

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/docs/notebooks/Validating_tides.ipynb

@@ -158,9 +158,10 @@
     }
    ],
    "source": [
-    "from eo_tides.model import model_tides\n",
     "import pandas as pd\n",
     "\n",
+    "from eo_tides.model import model_tides\n",
+    "\n",
     "x, y = 122.2186, -18.0008\n",
     "start_time = \"2018-01-01\"\n",
     "end_time = \"2018-01-31\"\n",

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/eo_tides/__init__.py

@@ -26,6 +26,8 @@ utils : Utility functions and helper tools
 validation : Load observed tide gauge data to validate modelled tides
 """
 
+from importlib.metadata import version
+
 # Import commonly used functions for convenience
 from .eo import pixel_tides, tag_tides
 from .model import ensemble_tides, model_phases, model_tides
@@ -35,7 +37,6 @@ from .validation import eval_metrics, load_gauge_gesla
 
 # Define what should be imported with "from eo_tides import *"
 __all__ = [
-    "list_models",
     "model_tides",
     "model_phases",
     "ensemble_tides",
@@ -46,5 +47,9 @@ __all__ = [
     "eval_metrics",
     "load_gauge_gesla",
     "clip_models",
+    "list_models",
     "idw",
 ]
+
+# Add version metadata to package
+__version__ = version("eo-tides")

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/eo_tides/eo.py

@@ -58,7 +58,7 @@ def _standardise_inputs(
     """
 
     # If `data` is an xarray object, extract its GeoBox and time
-    if isinstance(data, (xr.DataArray, xr.Dataset)):
+    if isinstance(data, xr.DataArray | xr.Dataset):
         # Try to extract GeoBox
         try:
             gbox: GeoBox = data.odc.geobox
@@ -544,14 +544,13 @@ def pixel_tides(
     # Reproject into original high resolution grid
     if resample:
         print("Reprojecting tides into original resolution")
-        tides_highres = _pixel_tides_resample(
+        return _pixel_tides_resample(
             tides_lowres,
             gbox,
             resample_method,
             dask_chunks,
             dask_compute,
         )
-        return tides_highres
 
     print("Returning low resolution tide array")
     return tides_lowres

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/eo_tides/model.py

@@ -55,10 +55,7 @@ def _parallel_splits(
         raw_value = os.environ.get("CPU_GUARANTEE") or psutil.cpu_count(logical=False) or os.cpu_count() or 1
 
         # Convert to integer
-        if isinstance(raw_value, str):
-            parallel_max = int(float(raw_value))
-        else:
-            parallel_max = int(raw_value)
+        parallel_max = int(float(raw_value)) if isinstance(raw_value, str) else int(raw_value)
 
     # Calculate optimal number of splits based on constraints
     splits_by_size = total_points / min_points_per_split
@@ -66,8 +63,7 @@ def _parallel_splits(
     optimal_splits = min(splits_by_size, splits_by_cpu)
 
     # Convert to integer and ensure at least 1 split
-    final_split_count = int(max(1, optimal_splits))
-    return final_split_count
+    return int(max(1, optimal_splits))
 
 
 def _model_tides(
@@ -170,12 +166,7 @@ def _model_tides(
     hc = amp * np.exp(cph)
 
     # Compute delta times based on model
-    if pytmd_model.corrections in ("OTIS", "ATLAS", "TMD3", "netcdf"):
-        # Use delta time at 2000.0 to match TMD outputs
-        deltat = np.zeros_like(ts.tt_ut1)
-    else:
-        # Use interpolated delta times
-        deltat = ts.tt_ut1
+    deltat = np.zeros_like(ts.tt_ut1) if pytmd_model.corrections in ("OTIS", "ATLAS", "TMD3", "netcdf") else ts.tt_ut1
 
     # In "one-to-many" mode, extracted tidal constituents and timesteps
     # are repeated/multiplied out to match the number of input points and

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/eo_tides/stats.py

@@ -44,7 +44,7 @@ def _tide_statistics(obs_tides, all_tides, min_max_q=(0.0, 1.0), dim="time"):
     offset_high = offset_high_m / tr
 
     # Combine into a single dataset
-    stats_ds = xr.merge(
+    return xr.merge(
         [
             mot.rename("mot"),
             mat.rename("mat"),
@@ -61,8 +61,6 @@ def _tide_statistics(obs_tides, all_tides, min_max_q=(0.0, 1.0), dim="time"):
         compat="override",
     )
 
-    return stats_ds
-
 
 def _stats_plain_english(mot, mat, hot, hat, lot, lat, otr, tr, spread, offset_low, offset_high):
     # Plain text descriptors
@@ -568,7 +566,7 @@ def pixel_stats(
     # Reproject statistics into original high resolution grid
     if resample:
         print("Reprojecting statistics into original resolution")
-        stats_highres = _pixel_tides_resample(
+        return _pixel_tides_resample(
             stats_lowres,
             gbox,
             resample_method,
@@ -576,7 +574,6 @@ def pixel_stats(
             dask_compute,
             None,
         )
-        return stats_highres
 
     print("Returning low resolution statistics array")
     return stats_lowres

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/eo_tides/utils.py

@@ -7,7 +7,7 @@ import pathlib
 import textwrap
 import warnings
 from collections import Counter
-from typing import List, Union
+from typing import TypeAlias
 
 import numpy as np
 import odc.geo
@@ -21,7 +21,7 @@ from scipy.spatial import cKDTree as KDTree
 from tqdm import tqdm
 
 # Type alias for all possible inputs to "time" params
-DatetimeLike = Union[np.ndarray, pd.DatetimeIndex, pd.Timestamp, datetime.datetime, str, List[str]]
+DatetimeLike: TypeAlias = np.ndarray | pd.DatetimeIndex | pd.Timestamp | datetime.datetime | str | list[str]
 
 
 def _get_duplicates(array):
@@ -54,8 +54,7 @@ def _set_directory(
     directory = pathlib.Path(directory).expanduser()
     if not directory.exists():
         raise FileNotFoundError(f"No valid tide model directory found at path `{directory}`")
-    else:
-        return directory
+    return directory
 
 
 def _standardise_time(
@@ -161,7 +160,7 @@ def _standardise_models(
             raise ValueError(error_text)
 
         # Return set of all ensemble plus any other requested models
-        models_to_process = sorted(list(set(ensemble_models + [m for m in models_requested if m != "ensemble"])))
+        models_to_process = sorted(set(ensemble_models + [m for m in models_requested if m != "ensemble"]))
 
     # Otherwise, models to process are the same as those requested
     else:
@@ -271,7 +270,7 @@ def _clip_model_file(
         for i in ["lat_z", "lat_v", "lat_u", "con"]:
             try:
                 nc_clipped[i] = nc_clipped[i].isel(nx=0)
-            except:
+            except KeyError:
                 pass
 
     return nc_clipped
@@ -558,8 +557,7 @@ def list_models(
 
         if raise_error:
             raise Exception(warning_msg)
-        else:
-            warnings.warn(warning_msg, UserWarning)
+        warnings.warn(warning_msg, UserWarning)
 
     # Return list of available and supported models
     return available_models, supported_models

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/eo_tides/validation.py

@@ -164,7 +164,7 @@ def _load_gesla_dataset(site, path, na_value):
     )
 
     # Combine two date fields
-    gesla_df = (
+    return (
         gesla_df.assign(
             time=pd.to_datetime(gesla_df["date"] + " " + gesla_df["time"]),
             site_code=site,
@@ -173,8 +173,6 @@ def _load_gesla_dataset(site, path, na_value):
         .set_index("time")
     )
 
-    return gesla_df
-
 
 def _nearest_row(gdf, x, y, max_distance=None):
     # Create a point to find the nearest neighbor for
@@ -288,7 +286,7 @@ def load_gauge_gesla(
         site_code = [site_code] if not isinstance(site_code, list) else site_code
 
     # If x and y are tuples, use xy bounds to identify sites
-    elif isinstance(x, (tuple, list)) & isinstance(y, (tuple, list)):
+    elif isinstance(x, tuple | list) & isinstance(y, tuple | list):
         bbox = BoundingBox.from_xy(x, y)
         site_code = metadata_gdf.cx[bbox.left : bbox.right, bbox.top : bbox.bottom].index
 
@@ -317,7 +315,7 @@ def load_gauge_gesla(
     # Prepare times
     if time is None:
         time = ["1800", str(datetime.datetime.now().year)]
-    time = [time] if not isinstance(time, (list, tuple)) else time
+    time = [time] if not isinstance(time, list | tuple) else time
     start_time = _round_date_strings(time[0], round_type="start")
     end_time = _round_date_strings(time[-1], round_type="end")
 

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/paper/benchmarking.ipynb

@@ -27,9 +27,11 @@
    "source": [
     "import os\n",
     "import platform\n",
-    "import psutil\n",
-    "import pandas as pd\n",
+    "\n",
     "import numpy as np\n",
+    "import pandas as pd\n",
+    "import psutil\n",
+    "\n",
     "from eo_tides.model import model_tides"
    ]
   },

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/paper/paper.bib

@@ -20,7 +20,7 @@
 
 @InProceedings{ mckinney-proc-scipy-2010,
   author    = { {W}es {M}c{K}inney },
-  title     = { {D}ata {S}tructures for {S}tatistical {C}omputing in {P}ython },
+  title     = { {D}ata structures for statistical computing in {P}ython },
   booktitle = { {P}roceedings of the 9th {P}ython in {S}cience {C}onference },
   pages     = { 56 - 61 },
   year      = { 2010 },
@@ -34,7 +34,7 @@
   journal = {Journal of Open Research Software},
   month = apr,
   number = {1},
-  title = {{xarray}: N-D labeled Arrays and Datasets in Python},
+  title = {{xarray}: {N-D} labeled arrays and datasets in {Python}},
   volume = {5},
   year = {2017}
 }
@@ -50,7 +50,7 @@
 }
 
 @article{murray2012continental,
-  title={Continental scale mapping of tidal flats across East Asia using the Landsat archive},
+  title={Continental scale mapping of tidal flats across {East Asia} using the {Landsat} archive},
   author={Murray, Nicholas J and Phinn, Stuart R and Clemens, Robert S and Roelfsema, Chris M and Fuller, Richard A},
   journal={Remote Sensing},
   volume={4},
@@ -62,7 +62,7 @@
 }
 
 @article{sagar2017item,
-  title={Extracting the intertidal extent and topography of the Australian coastline from a 28 year time series of Landsat observations},
+  title={Extracting the intertidal extent and topography of the {Australian} coastline from a 28 year time series of {Landsat} observations},
   author={Sagar, S. and Roberts, D. and Bala, B. and Lymburner, L.},
   journal={Remote Sensing of Environment},
   volume={195},
@@ -140,7 +140,7 @@
 }
 
 @article{bishop2021mapping,
-  title={Mapping {Australia}'s {Dynamic Coastline} at {Mean Sea Level} Using {Three Decades of Landsat Imagery}},
+  title={Mapping {Australia}'s dynamic coastline at {Mean Sea Level} using three decades of {Landsat} imagery},
   author={Bishop-Taylor, R. and Nanson, R. and Sagar, S. and Lymburner, L.},
   journal={Remote Sensing of Environment},
   volume={267},
@@ -152,7 +152,7 @@
 }
 
 @article{bishop2019NIDEM,
-  title={Between the tides: Modelling the elevation of Australia's exposed intertidal zone at continental scale},
+  title={Between the tides: Modelling the elevation of {Australia}'s exposed intertidal zone at continental scale},
   author={Bishop-Taylor, R. and Sagar, S. and Lymburner, L. and Beaman, R.J.},
   journal={Estuarine, Coastal and Shelf Science},
   volume={223},
@@ -164,7 +164,7 @@
 }
 
 @article{sagar2018composites,
-  title={Generating Continental Scale Pixel-Based Surface Reflectance Composites in Coastal Regions with the Use of a Multi-Resolution Tidal Model},
+  title={Generating continental scale pixel-based surface reflectance composites in coastal regions with the use of a multi-resolution tidal model},
   author={Sagar, S. and Phillips, C. and Bala, B. and Roberts, D. and Lymburner, L. and Beaman, R.J.},
   journal={Remote Sensing},
   volume={10(3)},
@@ -200,7 +200,7 @@
 }
 
 @article{vos2023benchmark,
-  title = {Benchmarking Satellite-Derived Shoreline Mapping Algorithms},
+  title = {Benchmarking satellite-derived shoreline mapping algorithms},
   author = {Vos, Kilian and Splinter, Kristen D. and {Palomar-V{\'a}zquez}, J. E. and {Almonacid-Caballer}, Jaime and {Cabezas-Rabad{\'a}n}, C. and Kras, Etienne C. and Luijendijk, Arjen P. and Calkoen, Floris and Almeida, Lu{\'i}s Pedro and Pais, D. and Klein, Antonio H.F. and Mao, Y. and Harris, D. and Castelle, Bruno and Buscombe, Daniel and Vitousek, Sean},
   year = {2023},
   journal = {Communications Earth \& Environment},
@@ -229,7 +229,7 @@ year = {2024}
 }
 
 @article{fitton2021intertidal,
-  title = {Remotely Sensed Mapping of the Intertidal Zone: {{A Sentinel-2}} and {{Google Earth Engine}} Methodology},
+  title = {Remotely sensed mapping of the intertidal zone: {{a Sentinel-2}} and {{Google Earth Engine}} methodology},
   author = {Fitton, James M. and Rennie, Alistair F. and Hansom, James D. and Muir, Freya M. E.},
   year = {2021},
   journal = {Remote Sensing Applications: Society and Environment},

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/pyproject.toml

@@ -107,18 +107,42 @@ allow_redefinition = true
 testpaths = ["tests"]
 
 [tool.ruff]
-target-version = "py310"
-line-length = 120
-fix = true
-
-[tool.ruff.format]
-preview = true
+target-version = "py310"     # Target Python 3.10 syntax
+line-length = 120            # Set max line length
+fix = true                   # Allow auto-fix when used without pre-commit
+lint.select = [
+  "I",        # Import sorting
+  "W",        # PyCodeStyle warnings
+  "F",        # Pyflakes (unused vars, imports, etc.)
+  "E",        # pycodestyle (spacing, etc.)
+  "UP",       # Modern Python idioms
+  "B006",     # Mutable default args
+  "B007",     # Reusing loop variables
+  "C4",       # Catch incorrect use of comprehensions, dict, list, etc
+  "FA",       # Enforce from __future__ import annotations
+  "ISC",      # Correct use of string concatenation
+  "ICN",      # Common import conventions
+  "RET",      # Good return practices
+  "SIM",      # Common simplification rules
+  "TID",      # Some good import practices
+  "PTH",      # Use pathlib instead of os.path
+  "NPY",      # Some numpy-specific things
+]
+lint.ignore = [
+  "E501",     # Don't enforce line length
+  "SIM105",   # contextlib.suppress
+]
+exclude = ["tests/testing.ipynb"]  # Don't modify testing notebook
 
 [tool.ruff.lint.per-file-ignores]
 "tests/*" = [
-    "S101"   # Assert
+  "S101",     # Allow `assert` in test files
+  "NPY002"    # Allow legacy numpy random generation
 ]
 
+[tool.ruff.format]
+preview = true    # Enable experimental formatting improvements
+
 [tool.deptry.per_rule_ignores]
 DEP002 = [
     "folium",

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/tests/conftest.py

@@ -127,7 +127,7 @@ def satellite_ds_load(request):
         )
 
         # Search the STAC catalog for all items matching the query
-        ds = odc.stac.load(
+        return odc.stac.load(
             list(query.items()),
             bands=["nbart_red"],
             crs=crs,
@@ -138,8 +138,6 @@ def satellite_ds_load(request):
             chunks={},
         )
 
-        return ds
-
 
 @pytest.fixture
 def satellite_ds(satellite_ds_load):
@@ -250,7 +248,7 @@ def create_synthetic_eot20(base_dir="tests/data/tide_models_synthetic"):
                 "real": (("lat", "lon"), data),
             },
             coords={"lat": lat, "lon": lon},
-            attrs={"title": f"DGFI-TUM global empirical ocean tide model"},
+            attrs={"title": "DGFI-TUM global empirical ocean tide model"},
         )
 
         # Export

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/tests/test_eo.py

@@ -358,7 +358,7 @@ def test_pixel_tides_ensemble(satellite_ds):
         ensemble_models=ENSEMBLE_MODELS,
     )
 
-    assert set(modelled_tides_ds.tide_model.values) == set([
+    assert set(modelled_tides_ds.tide_model.values) == {
         "EOT20",
         "HAMTIDE11",
         "ensemble-best",
@@ -366,4 +366,4 @@ def test_pixel_tides_ensemble(satellite_ds):
         "ensemble-mean-top2",
         "ensemble-mean-weighted",
         "ensemble-mean",
-    ])
+    }

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/tests/test_model.py

@@ -369,8 +369,8 @@ def test_model_tides_ensemble():
     # least one of the other models
     assert set(modelled_tides_df.columns) == set(models)
     assert all(
-        (modelled_tides_df.EOT20 == modelled_tides_df.ensemble)
-        | (modelled_tides_df.HAMTIDE11 == modelled_tides_df.ensemble)
+        (modelled_tides_df.ensemble == modelled_tides_df.EOT20)
+        | (modelled_tides_df.ensemble == modelled_tides_df.HAMTIDE11)
     )
 
     # Check that correct model is the closest at each row
@@ -404,7 +404,7 @@ def test_model_tides_ensemble():
     )
 
     # Check that expected models exist, and that valid data is produced
-    assert set(modelled_tides_df.columns) == set([
+    assert set(modelled_tides_df.columns) == {
         "EOT20",
         "HAMTIDE11",
         "ensemble-best",
@@ -412,7 +412,7 @@ def test_model_tides_ensemble():
         "ensemble-mean-top2",
         "ensemble-mean-weighted",
         "ensemble-mean",
-    ])
+    }
     assert all(modelled_tides_df.notnull())
 
     # Long mode, custom functions
@@ -427,7 +427,7 @@ def test_model_tides_ensemble():
     )
 
     # Check that expected models exist in "tide_model" column
-    assert set(modelled_tides_df.tide_model) == set([
+    assert set(modelled_tides_df.tide_model) == {
         "EOT20",
         "HAMTIDE11",
         "ensemble-best",
@@ -435,7 +435,7 @@ def test_model_tides_ensemble():
         "ensemble-mean-top2",
         "ensemble-mean-weighted",
         "ensemble-mean",
-    ])
+    }
 
 
 # Test ensemble dtype is set correctly

{eo_tides-0.7.3.dev5 → eo_tides-0.7.4}/tests/test_utils.py

@@ -1,9 +1,7 @@
 import pathlib
-import tempfile
 from datetime import datetime
 
 import numpy as np
-import odc.geo.geom
 import pandas as pd
 import pytest
 
@@ -67,8 +65,8 @@ def test_clip_models():
     )
 
     # Assert that files were exported for all available models
-    output_files = set([i.stem for i in out_dir.iterdir()])
-    assert output_files == set(["GOT5", "EOT20", "hamtide"])
+    output_files = {i.stem for i in out_dir.iterdir()}
+    assert output_files == {"GOT5", "EOT20", "hamtide"}
 
     # Set modelling location
     x, y = 122.28, -18.06

eo_tides-0.7.3.dev5/CITATION.cff

@@ -1,30 +0,0 @@
-# YAML 1.2
----
-abstract: ""
-authors:
-  - affiliation: "Geoscience Australia"
-    family-names: "Bishop-Taylor"
-    given-names: Robbi
-    orcid: "https://orcid.org/0000-0002-1533-2599"
-  - affiliation: "Geoscience Australia"
-    family-names: Sagar
-    given-names: Stephen
-  - affiliation: "Geoscience Australia"
-    family-names: Phillips
-    given-names: Claire
-  - affiliation: "Geoscience Australia"
-    family-names: Newey
-    given-names: Vanessa
-    orcid: "https://orcid.org/0000-0003-3705-5665"
-cff-version: "1.1.0"
-date-released: 2024-10-30
-doi: ""
-keywords:
-  - "Tide modelling"
-  - "Earth Observation"
-  - "Remote sensing"
-license: "Apache-2.0"
-message: "Please cite `eo-tides` using the citation below:"
-repository-code: "https://github.com/GeoscienceAustralia/eo-tides"
-title: "eo-tides: Tide modelling tools for large-scale satellite earth observation analysis"
-# version: "1.0.0"