geoai-py 0.22.0__tar.gz → 0.24.0__tar.gz

{geoai_py-0.22.0 → geoai_py-0.24.0}/.gitignore

@@ -21,6 +21,8 @@ docs/workshops/**/*.txt
 *.geojson
 *.gpkg
 *.csv
+*.mp4
+*.gif
 docs/examples/*.md
 *.xml
 docs/examples/output/

{geoai_py-0.22.0 → geoai_py-0.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoai-py
-Version: 0.22.0
+Version: 0.24.0
 Summary: A Python package for using Artificial Intelligence (AI) with geospatial data
 Author-email: Qiusheng Wu <giswqs@gmail.com>
 License: MIT License
@@ -38,6 +38,7 @@ Requires-Dist: rasterio
 Requires-Dist: rioxarray
 Requires-Dist: scikit-image
 Requires-Dist: scikit-learn
+Requires-Dist: smoothify
 Requires-Dist: timm
 Requires-Dist: tokenizers>=0.22.1
 Requires-Dist: torch
@@ -51,6 +52,7 @@ Requires-Dist: torchange; extra == "extra"
 Requires-Dist: lightly-train; extra == "extra"
 Requires-Dist: multiclean; extra == "extra"
 Requires-Dist: omnicloudmask; extra == "extra"
+Requires-Dist: smoothify; extra == "extra"
 Provides-Extra: agents
 Requires-Dist: strands-agents; extra == "agents"
 Requires-Dist: strands-agents-tools; extra == "agents"

{geoai_py-0.22.0 → geoai_py-0.24.0}/geoai/__init__.py

@@ -2,7 +2,7 @@
 
 __author__ = """Qiusheng Wu"""
 __email__ = "giswqs@gmail.com"
-__version__ = "0.22.0"
+__version__ = "0.24.0"
 
 
 import os

{geoai_py-0.22.0 → geoai_py-0.24.0}/geoai/utils.py

@@ -7848,3 +7848,70 @@ def empty_cache() -> None:
         torch.cuda.empty_cache()
     elif getattr(torch.backends, "mps", None) and torch.backends.mps.is_available():
         torch.mps.empty_cache()
+
+
+def smooth_vector(
+    vector_data: Union[str, gpd.GeoDataFrame],
+    output_path: str = None,
+    segment_length: float = None,
+    smooth_iterations: int = 3,
+    num_cores: int = 0,
+    merge_collection: bool = True,
+    merge_field: str = None,
+    merge_multipolygons: bool = True,
+    preserve_area: bool = True,
+    area_tolerance: float = 0.01,
+    **kwargs: Any,
+) -> gpd.GeoDataFrame:
+    """Smooth a vector data using the smoothify library.
+        See https://github.com/DPIRD-DMA/Smoothify for more details.
+
+    Args:
+        vector_data: The vector data to smooth.
+        output_path: The path to save the smoothed vector data. If None, returns the smoothed vector data.
+        segment_length: Resolution of the original raster data in map units. If None (default), automatically
+            detects by finding the minimum segment length (from a data sample). Recommended to specify explicitly when known.
+        smooth_iterations: The number of iterations to smooth the vector data.
+        num_cores: Number of cores to use for parallel processing. If 0 (default), uses all available cores.
+        merge_collection: Whether to merge/dissolve adjacent geometries in collections before smoothing.
+        merge_field: Column name to use for dissolving geometries. Only valid when merge_collection=True.
+            If None, dissolves all geometries together. If specified, dissolves geometries grouped by the column values.
+        merge_multipolygons: Whether to merge adjacent polygons within MultiPolygons before smoothing
+        preserve_area: Whether to restore original area after smoothing via buffering (applies to Polygons only)
+        area_tolerance: Percentage of original area allowed as error (e.g., 0.01 = 0.01% error = 99.99% preservation).
+            Only affects Polygons when preserve_area=True
+
+    Returns:
+        gpd.GeoDataFrame: The smoothed vector data.
+
+    Examples:
+        >>> import geoai
+        >>> gdf = geoai.read_vector("path/to/vector.geojson")
+        >>> smoothed_gdf = geoai.smooth_vector(gdf, smooth_iterations=3, output_path="path/to/smoothed_vector.geojson")
+        >>> smoothed_gdf.head()
+        >>> smoothed_gdf.explore()
+    """
+    try:
+        from smoothify import smoothify
+    except ImportError:
+        install_package("smoothify")
+        from smoothify import smoothify
+
+    if isinstance(vector_data, str):
+        vector_data = leafmap.read_vector(vector_data)
+
+    smoothed_vector_data = smoothify(
+        geom=vector_data,
+        segment_length=segment_length,
+        smooth_iterations=smooth_iterations,
+        num_cores=num_cores,
+        merge_collection=merge_collection,
+        merge_field=merge_field,
+        merge_multipolygons=merge_multipolygons,
+        preserve_area=preserve_area,
+        area_tolerance=area_tolerance,
+        **kwargs,
+    )
+    if output_path is not None:
+        smoothed_vector_data.to_file(output_path)
+    return smoothed_vector_data

{geoai_py-0.22.0 → geoai_py-0.24.0}/geoai_py.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoai-py
-Version: 0.22.0
+Version: 0.24.0
 Summary: A Python package for using Artificial Intelligence (AI) with geospatial data
 Author-email: Qiusheng Wu <giswqs@gmail.com>
 License: MIT License
@@ -38,6 +38,7 @@ Requires-Dist: rasterio
 Requires-Dist: rioxarray
 Requires-Dist: scikit-image
 Requires-Dist: scikit-learn
+Requires-Dist: smoothify
 Requires-Dist: timm
 Requires-Dist: tokenizers>=0.22.1
 Requires-Dist: torch
@@ -51,6 +52,7 @@ Requires-Dist: torchange; extra == "extra"
 Requires-Dist: lightly-train; extra == "extra"
 Requires-Dist: multiclean; extra == "extra"
 Requires-Dist: omnicloudmask; extra == "extra"
+Requires-Dist: smoothify; extra == "extra"
 Provides-Extra: agents
 Requires-Dist: strands-agents; extra == "agents"
 Requires-Dist: strands-agents-tools; extra == "agents"

{geoai_py-0.22.0 → geoai_py-0.24.0}/geoai_py.egg-info/SOURCES.txt

@@ -53,6 +53,7 @@ geoai_py.egg-info/top_level.txt
 qgis_plugin/README.md
 qgis_plugin/install.py
 qgis_plugin/install.sh
+qgis_plugin/package_plugin.py
 qgis_plugin/geoai_plugin/LICENSE
 qgis_plugin/geoai_plugin/__init__.py
 qgis_plugin/geoai_plugin/_geoai_lib.py

{geoai_py-0.22.0 → geoai_py-0.24.0}/geoai_py.egg-info/requires.txt

@@ -20,6 +20,7 @@ rasterio
 rioxarray
 scikit-image
 scikit-learn
+smoothify
 timm
 tokenizers>=0.22.1
 torch
@@ -41,6 +42,7 @@ torchange
 lightly-train
 multiclean
 omnicloudmask
+smoothify
 
 [sr]
 opensr-model

{geoai_py-0.22.0 → geoai_py-0.24.0}/mkdocs.yml

@@ -136,6 +136,7 @@ nav:
           - examples/water_dynamics.ipynb
           - examples/wetland_mapping.ipynb
           - examples/wetland_dynamics.ipynb
+          - examples/wetland_sam3.ipynb
           - examples/regularization.ipynb
           - examples/globe_projection.ipynb
           - examples/samgeo.ipynb
@@ -163,6 +164,8 @@ nav:
           - examples/moondream.ipynb
           - examples/moondream_gui.ipynb
           - examples/AutoModel.ipynb
+          - examples/smooth_vector.ipynb
+          - examples/timelapse.ipynb
     - Workshops:
           - workshops/GeoAI_Workshop_2025.ipynb
           - workshops/AWS_2025.ipynb

{geoai_py-0.22.0 → geoai_py-0.24.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "geoai-py"
-version = "0.22.0"
+version = "0.24.0"
 dynamic = [
     "dependencies",
 ]
@@ -36,7 +36,7 @@ exclude = ["docs*"]
 dependencies = {file = ["requirements.txt"]}
 
 [project.optional-dependencies]
-extra = ["overturemaps", "torchange", "lightly-train", "multiclean", "omnicloudmask"]
+extra = ["overturemaps", "torchange", "lightly-train", "multiclean", "omnicloudmask", "smoothify"]
 agents = ["strands-agents", "strands-agents-tools", "strands-agents[ollama]", "strands-agents[anthropic]", "strands-agents[openai]"]
 sr = ["opensr-model"]
 
@@ -45,7 +45,7 @@ universal = true
 
 
 [tool.bumpversion]
-current_version = "0.22.0"
+current_version = "0.24.0"
 commit = true
 tag = true
 

{geoai_py-0.22.0 → geoai_py-0.24.0}/qgis_plugin/README.md

@@ -4,21 +4,32 @@ A QGIS plugin that brings the [geoai](https://github.com/opengeos/geoai) models
 
 ## Quick Start
 
--   Create a fresh conda env (`conda create -n geo python=3.12`) and install QGIS + deps (see below).
--   Install the plugin (`python install.py`) from this repo.
--   Restart QGIS → `Plugins` → `Manage and Install Plugins...` → enable `GeoAI`.
+-   Create a Pixi project and install the dependencies.
+-   Install the QGIS plugin from the QGIS Plugin Manager.
+-   Enable the GeoAI plugin in QGIS.
+-   Restart QGIS.
 -   Open a GeoAI toolbar panel and try the sample datasets below.
 
 ## Video Tutorials
 
+### Installation Tutorial
+
+You can follow this [video tutorial](https://youtu.be/TJmZQXJK-IU) to install the GeoAI QGIS Plugin on Linux/Windows:
+
+[![installation](https://github.com/user-attachments/assets/6fa17c97-2ff5-40d6-be16-c6dcfe03f806)](https://youtu.be/TJmZQXJK-IU)
+
+### Usage Tutorial
+
 Check out this [short video demo](https://youtu.be/Esr_e6_P1is) and [full video tutorial](https://youtu.be/8-OhlqeoyiY) on how to use the GeoAI plugin in QGIS.
 
 [![demo](https://github.com/user-attachments/assets/5aabc3d3-efd1-4011-ab31-2b3f11aab3ed)](https://youtu.be/8-OhlqeoyiY)
 
+
+
 ## Requirements
 
 -   QGIS 3.28 or later
--   Python 3.10+ (conda recommended)
+-   Python 3.10+ (Pixi recommended)
 -   PyTorch (CUDA if you want GPU acceleration)
 -   `geoai` and `samgeo` packages
 
@@ -53,70 +64,192 @@ Each tool lives inside a dockable panel that can be attached to either side of t
 
 ## Installation
 
-### 1) Set up the environment
+### 1. Set up the environment
 
-#### Installation on Linux/macOS
+Installing the GeoAI QGIS plugin on can be challenging due to the complicated pytorch/cuda dependencies. Conda or mamba might take a while to resolve the dependencies, while pip might fail to install the dependencies properly. It is recommended to use [pixi](https://pixi.prefix.dev/latest) to install the dependencies to avoid these issues.
 
-Use a clean conda env dedicated to QGIS—mixing with an existing QGIS install often breaks dependencies.
+#### 1) Install Pixi
+
+#### Linux/macOS (bash/zsh)
 
 ```bash
-conda create -n geo python=3.12
-conda activate geo
+curl -fsSL https://pixi.sh/install.sh | sh
 ```
 
-Install core geospatial deps first:
+Close and re-open your terminal (or reload your shell) so `pixi` is on your `PATH`. Then confirm:
 
 ```bash
-conda install -c conda-forge --strict-channel-priority gdal rasterio libnetcdf netcdf4
-python -c "import rasterio; print('rasterio import successful')"
+pixi --version
 ```
 
-Install GeoAI:
+#### Windows (PowerShell)
 
-```bash
-conda install -c conda-forge geoai
-python -c "import geoai; print('geoai import successful')"
+Open **PowerShell** (preferably as a normal user, Admin not required), then run:
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm -useb https://pixi.sh/install.ps1 | iex"
 ```
 
-Install QGIS:
+Close and re-open PowerShell, then confirm:
 
-```bash
-conda install -c conda-forge qgis
+```powershell
+pixi --version
 ```
 
-Install SamGeo extras (PyPI is required for some parts):
+---
 
-```bash
-pip install -U "segment-geospatial[samgeo3]" sam3
-python -c "import samgeo; print('samgeo import successful')"
+#### 2) Create a Pixi project
+
+Navigate to a directory where you want to create the project and run:
+
+```powershell
+pixi init geo
+cd geo
 ```
 
-#### Installation on Windows
+---
 
-Windows + SAM3 often needs the PyTorch wheels from NVIDIA and PyPI:
+#### 3) Configure `pixi.toml`
 
-```bash
-conda create -n geo python=3.12
-conda activate geo
-conda install pytorch torchvision pytorch-cuda=12.1 -c pytorch -c nvidia
-conda install -c conda-forge geoai
-python -c "import geoai; print('geoai import successful')"
-conda install -c conda-forge qgis
-pip install -U "segment-geospatial[samgeo3]" triton-windows
-pip install -U sam3 geoai
+Open `pixi.toml` in the `geo` directory and replace its contents with the following depending on your system.
+
+If you have a NVIDIA GPU with CUDA, run `nvidia-smi` to check the CUDA version.
+
+- For GPU with CUDA 12.x:
+
+```toml
+[workspace]
+channels = ["https://prefix.dev/conda-forge"]
+name = "geo"
+platforms = ["linux-64", "win-64"]
+
+[system-requirements]
+cuda = "12.0"
+
+[dependencies]
+python = "3.12.*"
+pytorch-gpu = ">=2.9.1,<3"
+qgis = ">=3.44.5"
+geoai = ">=0.23.0"
+segment-geospatial = ">=0.10.8"
+sam3 = ">=0.1.0.20251211"
+libopenblas = ">=0.3.30"
+```
+
+- For GPU with CUDA 13.x:
+
+```toml
+[workspace]
+channels = ["https://prefix.dev/conda-forge"]
+name = "geo"
+platforms = ["linux-64", "win-64"]
+
+[system-requirements]
+cuda = "13.0"
+
+[dependencies]
+python = "3.12.*"
+pytorch-gpu = ">=2.9.1,<3"
+qgis = ">=3.44.5"
+geoai = ">=0.23.0"
+segment-geospatial = ">=0.10.8"
+sam3 = ">=0.1.0.20251211"
+libopenblas = ">=0.3.30"
+```
+
+- For CPU:
+
+```toml
+[workspace]
+channels = ["https://prefix.dev/conda-forge"]
+name = "geo"
+platforms = ["linux-64", "win-64"]
+
+[dependencies]
+python = "3.12.*"
+pytorch-cpu = ">=2.9.1,<3"
+qgis = ">=3.44.5"
+geoai = ">=0.23.0"
+segment-geospatial = ">=0.10.8"
+sam3 = ">=0.1.0.20251211"
+libopenblas = ">=0.3.30"
+```
+
+---
+
+#### 4) Install the environment
+
+From the `geo` folder:
+
+```powershell
+pixi install
+```
+
+This step may take several minutes on first install depending on your internet connection and system.
+
+---
+
+#### 5) Upgrade `segment-geospatial` via pip
+
+Install the latest `segment-geospatial` release on top of the resolved environment:
+
+```powershell
+pixi run pip install -U segment-geospatial
 ```
 
+---
+
+#### 6) Verify PyTorch + CUDA
+
+If you have a NVIDIA GPU with CUDA, run the following command to verify the PyTorch + CUDA installation:
+
+```powershell
+pixi run python -c "import torch; print('PyTorch:', torch.__version__); print('CUDA available:', torch.cuda.is_available()); print('GPU:', (torch.cuda.get_device_name(0) if torch.cuda.is_available() else 'None'))"
+```
+
+Expected output should be like this:
+
+-   `PyTorch: 2.9.1`
+-   `CUDA available: True`
+-   `GPU: NVIDIA RTX 4090`
+
+If CUDA is `False`, check:
+
+-   `nvidia-smi` works in PowerShell
+-   NVIDIA driver is up to date
+
+---
+
+
 #### Request access to SAM 3
 
 To use SAM 3, you will need to request access by filling out this form on Hugging Face at <https://huggingface.co/facebook/sam3>. Once your request has been approved, run the following command in the terminal to authenticate:
 
 ```bash
-hf auth login
+pixi run hf auth login
 ```
 
-### 2) Install the QGIS plugin
+After authentication, you can download the SAM 3 model from Hugging Face:
+
+```bash
+pixi run hf download facebook/sam3
+```
+
+**Important Note**: SAM 3 currently requires a NVIDIA GPU with CUDA support. You won't be able to use SAM 3 if you have a CPU only system ([source](https://github.com/facebookresearch/sam3/issues/164)). You will get an error message like this: `Failed to load model: Torch not compiled with CUDA enabled`.
+
+### 2. Install the QGIS plugin
+
+Option A — use QGIS Plugin Manager (recommended):
 
-Option A — use the helper script (recommended):
+GeoAI is available as a QGIS plugin in the official [QGIS plugin repository](https://plugins.qgis.org/plugins/geoai). To install:
+
+1. Launch QGIS: `pixi run qgis`
+2. Go to `Plugins` → `Manage and Install Plugins...`
+3. Switch to the `All` tab, search for `GeoAI`, select it, and click `Install Plugin`
+
+![](https://github.com/user-attachments/assets/b31d1d13-27ff-420a-84ab-9cc82ade9a8e)
+
+Option B — use the helper script:
 
 ```bash
 git clone https://github.com/opengeos/geoai.git
@@ -130,19 +263,21 @@ This links/copies the plugin into your active QGIS profile. Re-run after pulling
 python install.py --remove
 ```
 
-Option B — manual copy:
+Option C — manual copy:
 
 -   Copy the `qgis_plugin` folder to your QGIS plugins directory:
     -   Linux: `~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/`
     -   Windows: `C:\Users\<username>\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\`
     -   macOS: `~/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins/`
 
-### 3) Enable in QGIS
+### 3. Enable in QGIS
 
-Launch QGIS: `conda run qgis`
+Launch QGIS: `pixi run qgis`
 
 QGIS → `Plugins` → `Manage and Install Plugins...` → enable `GeoAI`. After updates, toggle the plugin off/on or restart QGIS to reload.
 
+![](https://github.com/user-attachments/assets/1b6dab14-311d-4f62-85aa-1faed73ead5b)
+
 ## Usage
 
 ### Moondream Vision-Language Model
@@ -174,7 +309,7 @@ Sample datasets:
 
 Steps:
 
-1. Download the sample datasets (links above) or prepare your own imagery/vector labels. Store them in a folder that is accessible to the conda environment.
+1. Download the sample datasets (links above) or prepare your own imagery/vector labels. Store them in a folder that is accessible to pixi project.
 2. Click the **Segmentation** button in the GeoAI toolbar (or `GeoAI` menu → `Segmentation`)
 3. Use the tabs at the top of the panel to switch between:
 
@@ -243,6 +378,12 @@ Click the **GPU** button in the GeoAI toolbar to release GPU memory from all loa
 
 ![](https://github.com/user-attachments/assets/76c9dd8a-581c-4975-9ecb-4bfe301447bd)
 
+### Plugin Update Checker
+
+Go to `GeoAI` menu → `Check for Updates...` to see if a newer version of the GeoAI plugin is available. Click on the `Check for Updates` button to fetch the latest version info from GitHub. If an update is found, click the `Download and Install Update` button to download and install the latest version automatically. Restart QGIS to apply the update.
+
+![](https://github.com/user-attachments/assets/cc0dfd38-9b41-4735-9af0-c49b7aa71b72)
+
 ## Supported Model Architectures (Segmentation)
 
 The QGIS plugin supports any models supported by [Pytorch Segmentation Models](https://smp.readthedocs.io/en/latest/models.html), including:
@@ -276,7 +417,6 @@ The QGIS plugin supports any models supported by [Pytorch Segmentation Models](h
 ## Troubleshooting
 
 -   Plugin missing after install: confirm the plugin folder exists in your QGIS profile path and that you restarted QGIS.
--   GDAL/rasterio errors: verify you launched QGIS from the conda env (`conda activate geo` then `qgis`) so it picks up the same Python libs.
 -   CUDA OOM: use the **GPU** button to clear cache, lower batch sizes, or switch to CPU for smaller runs.
 -   Model download failures: check network/firewall, then retry loading models from the panel.