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

{geoai_py-0.22.0 → geoai_py-0.23.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.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoai-py
-Version: 0.22.0
+Version: 0.23.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.23.0}/geoai/__init__.py

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

{geoai_py-0.22.0 → geoai_py-0.23.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.23.0}/geoai_py.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoai-py
-Version: 0.22.0
+Version: 0.23.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.23.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.23.0}/mkdocs.yml

@@ -163,6 +163,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.23.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "geoai-py"
-version = "0.22.0"
+version = "0.23.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.23.0"
 commit = true
 tag = true
 

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

@@ -93,19 +93,190 @@ python -c "import samgeo; print('samgeo import successful')"
 
 #### Installation on Windows
 
-Windows + SAM3 often needs the PyTorch wheels from NVIDIA and PyPI:
+Windows installation requires some additional steps compared to Linux/macOS. Choose the appropriate section based on whether you have an NVIDIA GPU or want CPU-only installation.
+
+**Prerequisites (Required for all Windows users):**
+
+1. Install [Miniconda](https://docs.conda.io/en/latest/miniconda.html) or [Anaconda](https://www.anaconda.com/download) if you haven't already.
+2. Open **Anaconda Prompt** (not PowerShell or CMD) for all installation commands.
+3. For GPU users: Ensure you have the latest [NVIDIA GPU drivers](https://www.nvidia.com/Download/index.aspx) installed.
+
+##### Option A: Windows with NVIDIA GPU (CUDA)
+
+This option provides the best performance using your NVIDIA GPU for model inference and training.
+
+**Step 1: Create and activate the conda environment**
 
 ```bash
-conda create -n geo python=3.12
+conda create -n geo python=3.12 -y
 conda activate geo
-conda install pytorch torchvision pytorch-cuda=12.1 -c pytorch -c nvidia
-conda install -c conda-forge geoai
+```
+
+**Step 2: Install PyTorch with CUDA support**
+
+First, check your NVIDIA driver version to determine the compatible CUDA version:
+
+```bash
+nvidia-smi
+```
+
+Look for the "CUDA Version" in the output. Then install the appropriate PyTorch version:
+
+For CUDA 12.4 (recommended for newer drivers):
+
+```bash
+conda install pytorch torchvision pytorch-cuda=12.4 -c pytorch -c nvidia -y
+```
+
+For CUDA 12.1 (for older drivers):
+
+```bash
+conda install pytorch torchvision pytorch-cuda=12.1 -c pytorch -c nvidia -y
+```
+
+**Step 3: Verify PyTorch GPU installation**
+
+```bash
+python -c "import torch; print(f'PyTorch: {torch.__version__}'); print(f'CUDA available: {torch.cuda.is_available()}'); print(f'GPU: {torch.cuda.get_device_name(0) if torch.cuda.is_available() else \"None\"}')"
+```
+
+You should see `CUDA available: True` and your GPU name. If not, see the troubleshooting section below.
+
+**Step 4: Install QGIS and core dependencies**
+
+```bash
+conda install -c conda-forge qgis -y
+```
+
+**Step 5: Install GeoAI**
+
+```bash
+conda install -c conda-forge geoai -y
 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
 ```
 
+**Step 6: Install SamGeo with SAM3 support**
+
+```bash
+pip install -U triton-windows
+pip install -U "segment-geospatial[samgeo3]"
+pip install -U sam3
+python -c "import samgeo; print('samgeo import successful')"
+```
+
+##### Option B: Windows CPU-Only (No GPU)
+
+Use this option if you don't have an NVIDIA GPU or want a simpler installation.
+
+**Step 1: Create and activate the conda environment**
+
+```bash
+conda create -n geo python=3.12 -y
+conda activate geo
+```
+
+**Step 2: Install PyTorch (CPU version)**
+
+```bash
+conda install pytorch torchvision cpuonly -c pytorch -y
+```
+
+**Step 3: Verify PyTorch installation**
+
+```bash
+python -c "import torch; print(f'PyTorch: {torch.__version__}'); print('PyTorch CPU installation successful')"
+```
+
+**Step 4: Install QGIS and core dependencies**
+
+```bash
+conda install -c conda-forge qgis -y
+```
+
+**Step 5: Install GeoAI**
+
+```bash
+conda install -c conda-forge geoai -y
+python -c "import geoai; print('geoai import successful')"
+```
+
+**Step 6: Install SamGeo (without SAM3)**
+
+```bash
+pip install segment-geospatial
+python -c "import samgeo; print('samgeo import successful')"
+```
+
+##### Windows Troubleshooting
+
+**Common Issue 1: CUDA not detected after PyTorch installation**
+
+If `torch.cuda.is_available()` returns `False`:
+
+1. Verify NVIDIA drivers are installed: Run `nvidia-smi` in command prompt
+2. Ensure you installed the CUDA-enabled PyTorch (not CPU version)
+3. Try reinstalling PyTorch:
+
+```bash
+conda uninstall pytorch torchvision -y
+conda install pytorch torchvision pytorch-cuda=12.4 -c pytorch -c nvidia -y
+```
+
+**Common Issue 2: DLL load failed or missing dependencies**
+
+If you see errors like `DLL load failed` or `ImportError`:
+
+1. Install Microsoft Visual C++ Redistributable:
+    - Download and install [VC++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe)
+2. Restart your computer after installation
+
+**Common Issue 3: Triton installation fails**
+
+Triton is required for SAM3 on Windows. If `pip install triton-windows` fails:
+
+1. Ensure you're using Python 3.12 (not 3.13+)
+2. Try installing from conda-forge:
+
+```bash
+pip install triton-windows --no-cache-dir
+```
+
+If Triton still doesn't work, you can skip SAM3 and use SAM1/SAM2 instead.
+
+**Common Issue 4: Permission errors during installation**
+
+Run Anaconda Prompt as Administrator, or try:
+
+```bash
+pip install --user <package-name>
+```
+
+**Common Issue 5: QGIS fails to start or shows import errors**
+
+Make sure you launch QGIS from the activated conda environment:
+
+```bash
+conda activate geo
+qgis
+```
+
+Do NOT use the QGIS shortcut from the Start Menu—it won't have access to the conda packages.
+
+**Common Issue 6: Out of memory errors**
+
+If you run out of GPU memory:
+
+1. Use the **GPU** button in the GeoAI toolbar to clear memory
+2. Close other GPU-intensive applications
+3. Use smaller batch sizes in training/inference settings
+4. Switch to CPU mode in the plugin settings for smaller tasks
+
+##### Video Tutorial
+
+You can follow this [video tutorial](https://youtu.be/a-Ns9peiuu8) to install the GeoAI QGIS Plugin on Windows:
+
+[![windows](https://github.com/user-attachments/assets/8d89d535-1d66-45d2-a6c0-171416c259c9)](https://youtu.be/a-Ns9peiuu8)
+
 #### 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:
@@ -116,7 +287,19 @@ hf auth login
 
 ### 2) Install the QGIS plugin
 
-Option A — use the helper script (recommended):
+Option A — use QGIS Plugin Manager (recommended):
+
+GeoAI is available as an experimental plugin in the official [QGIS plugin repository](https://plugins.qgis.org/plugins/geoai). To install:
+
+1. Launch QGIS: `conda run qgis`
+2. Go to `Plugins` → `Manage and Install Plugins...` → `Settings` tab → check `Show also Experimental Plugins` → Click on `Reload all Repositories` button.
+3. Switch to the `All` tab, search for `GeoAI`, select it, and click `Install Experimental Plugin`.
+
+![](https://github.com/user-attachments/assets/c15c4b7e-1e8c-45de-9127-671c7c2c85a9)
+
+![](https://github.com/user-attachments/assets/ea101a82-5df7-4947-99b8-d4a83a1598ed)
+
+Option B — use the helper script:
 
 ```bash
 git clone https://github.com/opengeos/geoai.git
@@ -130,7 +313,7 @@ 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/`
@@ -143,6 +326,8 @@ Launch QGIS: `conda 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
@@ -243,6 +428,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: