implementation and tests added

Author: konstntokas

CHANGES.md

@@ -1 +1,7 @@
 ## Changes in 0.1.0 (under development)
+
+- Added algorithm for **affine transformation**.
+- Added algorithm for **rectification of non-regular grids**.
+- Added algorithm for **reprojection to a different coordinate reference system (CRS)**.
+- Introduced main function `resample_in_space`, which dynamically selects the
+  appropriate resampling algorithm based on the input dataset.

environment.yml

@@ -4,4 +4,28 @@ channels:
 dependencies:
   # Python
   - python >=3.10
+  # Required
+  - affine >=2.2
+  - dask >=2021.6
+  - dask-image >=0.6
+  - numba >=0.52
+  - numpy >=1.16
+  - pyproj >=3.0
+  - xarray >=2024.7
+  - zarr >=2.11,<3  # until we can ensure zarr 3 compatibility
+  # Development Dependencies - Tools
+  - black
+  - isort
+  - mkdocs
+  - mkdocs-autorefs
+  - mkdocs-material
+  - mkdocs-jupyter
+  - mkdocstrings
+  - mkdocstrings-python
+  - pytest
+  - pytest-cov
+  - ruff
+  # Development Dependencies - Demos
+  - jupyterlab
+  - matplotlib
 

pyproject.toml

@@ -40,10 +40,34 @@ classifiers = [
 
 requires-python = ">=3.10"
 
-dependencies = []
+dependencies = [
+  "affine>=2.2",
+  "dask>=2021.6",
+  "dask-image>=0.6",
+  "numba>=0.52",
+  "numpy>=1.16",
+  "pyproj>=3.0",
+  "xarray>=2024.7",
+  "zarr>=2.11,<3"
+]
 
 [project.optional-dependencies]
-dev = []
+dev = [
+  # Build tools
+  "build",
+  "hatch",
+  "twine",
+  # Code Style / QA
+  "black",
+  "isort",
+  "ruff",
+  # Testing
+  "pytest",
+  "pytest-cov",
+  # Notebooks / Visualisation
+  "jupyterlab",
+  "matplotlib",
+]
 doc = [
   "mkdocs",
   "mkdocs-autorefs",

tests/__init__.py

@@ -0,0 +1,20 @@
+# The MIT License (MIT)
+# Copyright (c) 2025 by the xcube development team and contributors
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+# DEALINGS IN THE SOFTWARE.

tests/conftest.py

@@ -0,0 +1,3 @@
+import numba as nb
+
+nb.config.DISABLE_JIT = True

tests/gridmapping/__init__.py

@@ -0,0 +1,20 @@
+# The MIT License (MIT)
+# Copyright (c) 2025 by the xcube development team and contributors
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+# DEALINGS IN THE SOFTWARE.

tests/gridmapping/test_assertions.py

@@ -0,0 +1,65 @@
+# The MIT License (MIT)
+# Copyright (c) 2025 by the xcube development team and contributors
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+# DEALINGS IN THE SOFTWARE.
+
+import unittest
+
+from xcube_resampling.gridmapping import assertions
+
+
+class Testassertions(unittest.TestCase):
+    # --- assert_given ---
+    def test_assert_given_ok(self):
+        assertions.assert_given("hello")
+
+    def test_assert_given_fail(self):
+        with self.assertRaises(ValueError) as cm:
+            assertions.assert_given("", name="arg")
+        self.assertIn("arg must be given", str(cm.exception))
+
+    # --- assert_instance ---
+    def test_assert_instance_ok(self):
+        assertions.assert_instance(5, int)
+
+    def test_assert_instance_fail(self):
+        with self.assertRaises(TypeError) as cm:
+            assertions.assert_instance("s", int, name="val")
+        self.assertIn("val must be an instance of", str(cm.exception))
+
+    def test_assert_instance_tuple_dtype(self):
+        assertions.assert_instance(5, (int, float))  # should pass
+
+    # --- assert_in ---
+    def test_assert_in_ok(self):
+        assertions.assert_in(1, [1, 2, 3])
+
+    def test_assert_in_fail(self):
+        with self.assertRaises(ValueError) as cm:
+            assertions.assert_in("z", ["a", "b"], name="char")
+        self.assertIn("char must be one of", str(cm.exception))
+
+    # --- assert_true ---
+    def test_assert_true_ok(self):
+        assertions.assert_true(True, "must be true")
+
+    def test_assert_true_fail(self):
+        with self.assertRaises(ValueError) as cm:
+            assertions.assert_true(False, "bad value")
+        self.assertEqual(str(cm.exception), "bad value")