Enhancement: Rasterization of Geometries & Geometry Module Improvements

Makefile

@@ -48,7 +48,7 @@ test:    ## Run tests and generate coverage report.
 
 .PHONY: coverage
 coverage:    ## Run tests and generate coverage report.
-	$(ENV_PREFIX)coverage run -m pytest  tests/
+	$(ENV_PREFIX)coverage run -m pytest tests/
 
 .PHONY: coverage-report
 coverage-report: coverage

docs/user_guide/3_computing_spectrograms.py

@@ -19,8 +19,7 @@
 # First, we will load a recording. We will use the
 # the example recording from the (audio loading tutorial)[audio_loading].
 
-import numpy as np
-from soundevent import audio, data, arrays
+from soundevent import arrays, audio, data
 
 recording = data.Recording.from_file("sample_audio.wav")
 wave = audio.load_recording(recording)

pyproject.toml

@@ -19,7 +19,11 @@ audio = [
     "soundfile>=0.12.1",
 ]
 evaluation = ["scikit-learn>=1.3.2"]
-geometry = ["shapely>=2.0.1"]
+geometry = [
+    "shapely>=2.0.1",
+    "rasterio>=1.3.10",
+    "xarray>=2023.1.0",
+]
 crowsetta = [
     "crowsetta>=4.0.0.post2,<5.0",
     "importlib-resources<6.0,>=5.0; python_version < \"3.9\"",
@@ -57,10 +61,11 @@ rye = { dev-dependencies = [
     "html5lib>=1.1",
     "pyright>=1.1.362",
     "pytest-xdist>=3.6.1",
+    "ipykernel>=6.29.4",
 ] }
 
 [tool.pytest.ini_options]
-addopts = "-vv -n auto"
+addopts = "-vv"
 
 [tool.ruff]
 line-length = 79

requirements-dev.lock

@@ -8,24 +8,31 @@
 #   with-sources: false
 
 -e file:.
+affine==2.4.0
+    # via rasterio
 annotated-types==0.6.0
     # via pydantic
 appdirs==1.4.4
     # via crowsetta
 asttokens==2.4.1
     # via icecream
+    # via stack-data
 astunparse==1.6.3
     # via griffe
 attrs==23.2.0
     # via crowsetta
     # via hypothesis
+    # via rasterio
 babel==2.14.0
     # via mkdocs-material
+backcall==0.2.0
+    # via ipython
 birdsong-recognition-dataset==0.3.2.post1
     # via crowsetta
 cachetools==5.3.3
     # via tox
 certifi==2024.2.2
+    # via rasterio
     # via requests
 cffi==1.16.0
     # via soundfile
@@ -34,14 +41,23 @@ chardet==5.2.0
 charset-normalizer==3.3.2
     # via requests
 click==8.1.7
+    # via click-plugins
+    # via cligj
     # via mkdocs
     # via mkdocstrings
+    # via rasterio
+click-plugins==1.1.1
+    # via rasterio
+cligj==0.7.2
+    # via rasterio
 colorama==0.4.6
     # via griffe
     # via icecream
     # via mkdocs-material
     # via pytest-watch
     # via tox
+comm==0.2.2
+    # via ipykernel
 contourpy==1.1.1
     # via matplotlib
 coverage==7.5.0
@@ -53,6 +69,10 @@ cycler==0.12.1
     # via matplotlib
 cython==3.0.10
     # via soundevent
+debugpy==1.8.1
+    # via ipykernel
+decorator==5.1.1
+    # via ipython
 distlib==0.3.8
     # via virtualenv
 dnspython==2.6.1
@@ -70,6 +90,7 @@ execnet==2.1.1
     # via pytest-xdist
 executing==2.0.1
     # via icecream
+    # via stack-data
 filelock==3.13.4
     # via tox
     # via virtualenv
@@ -86,24 +107,36 @@ idna==3.7
     # via email-validator
     # via requests
 importlib-metadata==7.1.0
+    # via jupyter-client
     # via markdown
     # via mkdocs
     # via mkdocs-get-deps
     # via mkdocstrings
+    # via rasterio
     # via typeguard
 importlib-resources==5.13.0
     # via crowsetta
     # via matplotlib
     # via soundevent
 iniconfig==2.0.0
     # via pytest
+ipykernel==6.29.4
+ipython==8.12.3
+    # via ipykernel
 isort==5.13.2
+jedi==0.19.1
+    # via ipython
 jinja2==3.1.3
     # via mkdocs
     # via mkdocs-material
     # via mkdocstrings
 joblib==1.4.0
     # via scikit-learn
+jupyter-client==8.6.1
+    # via ipykernel
+jupyter-core==5.7.2
+    # via ipykernel
+    # via jupyter-client
 kiwisolver==1.4.5
     # via matplotlib
 markdown==3.6
@@ -119,6 +152,9 @@ markupsafe==2.1.5
     # via mkdocstrings
 matplotlib==3.7.5
     # via soundevent
+matplotlib-inline==0.1.7
+    # via ipykernel
+    # via ipython
 memory-profiler==0.61.0
 mergedeep==1.3.4
     # via mkdocs
@@ -145,6 +181,8 @@ multimethod==1.10
     # via pandera
 mypy-extensions==1.0.0
     # via typing-inspect
+nest-asyncio==1.6.0
+    # via ipykernel
 nodeenv==1.8.0
     # via pyright
 numpy==1.24.4
@@ -155,11 +193,14 @@ numpy==1.24.4
     # via matplotlib
     # via pandas
     # via pandera
+    # via rasterio
     # via scikit-learn
     # via scipy
     # via shapely
+    # via snuggs
     # via xarray
 packaging==24.0
+    # via ipykernel
     # via matplotlib
     # via mkdocs
     # via mkdocs-gallery
@@ -176,20 +217,34 @@ pandas==2.0.3
     # via xarray
 pandera==0.18.3
     # via crowsetta
+parso==0.8.4
+    # via jedi
 pathspec==0.12.1
     # via mkdocs
+pexpect==4.9.0
+    # via ipython
+pickleshare==0.7.5
+    # via ipython
 pillow==10.3.0
     # via matplotlib
 platformdirs==4.2.1
+    # via jupyter-core
     # via mkdocs-get-deps
     # via mkdocstrings
     # via tox
     # via virtualenv
 pluggy==1.5.0
     # via pytest
     # via tox
+prompt-toolkit==3.0.43
+    # via ipython
 psutil==5.9.8
+    # via ipykernel
     # via memory-profiler
+ptyprocess==0.7.0
+    # via pexpect
+pure-eval==0.2.2
+    # via stack-data
 pycparser==2.22
     # via cffi
 pydantic==2.7.1
@@ -199,12 +254,14 @@ pydantic-core==2.18.2
     # via pydantic
 pygments==2.17.2
     # via icecream
+    # via ipython
     # via mkdocs-material
 pymdown-extensions==10.8
     # via mkdocs-material
     # via mkdocstrings
 pyparsing==3.1.2
     # via matplotlib
+    # via snuggs
 pyproject-api==1.6.1
     # via tox
 pyright==1.1.362
@@ -223,6 +280,7 @@ pytest-watch==4.2.0
 pytest-xdist==3.6.1
 python-dateutil==2.9.0.post0
     # via ghp-import
+    # via jupyter-client
     # via matplotlib
     # via pandas
 pytz==2024.1
@@ -235,6 +293,11 @@ pyyaml==6.0.1
     # via pyyaml-env-tag
 pyyaml-env-tag==0.1
     # via mkdocs
+pyzmq==26.0.3
+    # via ipykernel
+    # via jupyter-client
+rasterio==1.3.10
+    # via soundevent
 regex==2024.4.16
     # via mkdocs-material
 requests==2.31.0
@@ -249,32 +312,48 @@ scipy==1.10.1
     # via soundevent
 setuptools==69.5.1
     # via nodeenv
+    # via rasterio
 shapely==2.0.4
     # via soundevent
 six==1.16.0
     # via asttokens
     # via astunparse
     # via html5lib
     # via python-dateutil
+snuggs==1.4.7
+    # via rasterio
 sortedcontainers==2.4.0
     # via hypothesis
 soundfile==0.12.1
     # via crowsetta
     # via soundevent
+stack-data==0.6.3
+    # via ipython
 threadpoolctl==3.4.0
     # via scikit-learn
 tomli==2.0.1
     # via coverage
     # via pyproject-api
     # via pytest
     # via tox
+tornado==6.4
+    # via ipykernel
+    # via jupyter-client
 tox==4.15.0
 tqdm==4.66.2
     # via mkdocs-gallery
+traitlets==5.14.3
+    # via comm
+    # via ipykernel
+    # via ipython
+    # via jupyter-client
+    # via jupyter-core
+    # via matplotlib-inline
 typeguard==4.2.1
     # via pandera
 typing-extensions==4.11.0
     # via annotated-types
+    # via ipython
     # via mkdocstrings
     # via pydantic
     # via pydantic-core
@@ -291,6 +370,8 @@ virtualenv==20.26.0
 watchdog==4.0.0
     # via mkdocs
     # via pytest-watch
+wcwidth==0.2.13
+    # via prompt-toolkit
 webencodings==0.5.1
     # via html5lib
 wheel==0.43.0

requirements.lock

@@ -8,16 +8,29 @@
 #   with-sources: false
 
 -e file:.
+affine==2.4.0
+    # via rasterio
 annotated-types==0.6.0
     # via pydantic
 appdirs==1.4.4
     # via crowsetta
 attrs==23.2.0
     # via crowsetta
+    # via rasterio
 birdsong-recognition-dataset==0.3.2.post1
     # via crowsetta
+certifi==2024.2.2
+    # via rasterio
 cffi==1.16.0
     # via soundfile
+click==8.1.7
+    # via click-plugins
+    # via cligj
+    # via rasterio
+click-plugins==1.1.1
+    # via rasterio
+cligj==0.7.2
+    # via rasterio
 contourpy==1.1.1
     # via matplotlib
 crowsetta==4.0.0.post2
@@ -37,6 +50,7 @@ fonttools==4.51.0
 idna==3.7
     # via email-validator
 importlib-metadata==7.1.0
+    # via rasterio
     # via typeguard
 importlib-resources==5.13.0
     # via crowsetta
@@ -60,9 +74,11 @@ numpy==1.24.4
     # via matplotlib
     # via pandas
     # via pandera
+    # via rasterio
     # via scikit-learn
     # via scipy
     # via shapely
+    # via snuggs
     # via xarray
 packaging==24.0
     # via matplotlib
@@ -85,22 +101,29 @@ pydantic-core==2.18.2
     # via pydantic
 pyparsing==3.1.2
     # via matplotlib
+    # via snuggs
 python-dateutil==2.9.0.post0
     # via matplotlib
     # via pandas
 pytz==2024.1
     # via pandas
+rasterio==1.3.10
+    # via soundevent
 scikit-learn==1.3.2
     # via soundevent
 scipy==1.10.1
     # via crowsetta
     # via evfuncs
     # via scikit-learn
     # via soundevent
+setuptools==69.5.1
+    # via rasterio
 shapely==2.0.4
     # via soundevent
 six==1.16.0
     # via python-dateutil
+snuggs==1.4.7
+    # via rasterio
 soundfile==0.12.1
     # via crowsetta
     # via soundevent