Skip to content

v2.0

Latest

Choose a tag to compare

@Fanchengyan Fanchengyan released this 22 Jun 07:06
· 4 commits to main since this release

Geo-SAM v2.0

A ground-up rewrite of the Geo-SAM QGIS plugin, built on the new geosam core library with the Ultralytics SAM backend.

🏗️ Architecture

  • Full backend rewrite — replaced in-plugin SAM implementation with the geosam core library
  • SAM backend switched to Ultralytics — model loading and inference now use the ultralytics SAM stack
  • Plugin-managed dependencies & models — one-click install/download, no manual pip or file management

✨ New Features

  • Live Encoding mode — segment directly from a raster layer without pre-encoding; features are encoded on the fly via QGIS background tasks and cached for fast re-queries
  • Pre-encoded mode — use Image Encoder to generate reusable feature files for repeated segmentation of the same image
  • Online tile layer support — XYZ, WMS, and WMTS tile layers can be used in live-encoding mode (supports arbitrary WMTS CRS)
  • SAM2 and SAM3 model support — added SAM2, SAM2.1, and SAM3 model families alongside the original SAM
  • Vectorization mode — choose between Pixel-Level and Simplified polygon output
  • Max Polygon Only mode — keep only the largest polygon from the current mask
  • Unified Settings dialog — four tabs (Dependencies, Model Management, Cache, Help)
  • In-app Model Management — download, delete, and unload SAM checkpoints with Ultralytics + ModelScope fallback
  • Feature cache management — configurable cache directory, maximum size, performance mode (Balanced / Fastest / Low Memory)
  • Split-panel UI — Segmentation dock widget with Input/Output + Prompts on the left, Styles + Options on the right
  • Multi-language UI — 中文, 日本語, 한국어, Français, Русский, العربية, Deutsch, Español, Português
  • Selectable realtime performance modes and async preview pipeline

🔧 Improvements

  • PyQt6 / QGIS 4 compatibility
  • Faster prompt response via feature cache reuse
  • Better memory management (Balanced vs Low Memory strategies)
  • Preserved polygon holes when saving SAM results
  • Tab key cycles prompt types; keyboard shortcuts work even when widget is not focused
  • Preview Mode — SAM predictions follow the mouse cursor in real time
  • Lazy-load Geo-SAM runtime dependencies for faster plugin startup
  • Improved dependency settings UI with install progress feedback
  • Backend abstraction layer for QGIS integration

🗑️ Removed

  • torchgeo and segment_anything as runtime dependencies (replaced by geosam + ultralytics)
  • Minimum Pixels parameter from the Segmentation tool UI
  • Load Demo option
  • Manual pip dependency installation (replaced by Settings dialog)

🐛 Bug Fixes

  • Fixed polygon holes not preserved when saving SAM results
  • Fixed SAM3 model image size handling
  • Fixed preview mode defaults and setting changes not persisting
  • Fixed online raster cache reuse across models
  • Fixed Windows QGIS Python interpreter resolution for dependency install
  • Fixed Conda QGIS runtime missing rasterio, geopandas, shapely, pyproj
  • Fixed crash on open widget due to tab key looping
  • Fixed second point not working in prompt
  • Fixed CRS comparison issues in realtime cache
  • Fixed user.json creation when file doesn't exist

📦 Dependencies

  • New: geosam core library
  • New: ultralytics for SAM model inference
  • Removed: torchgeo, segment_anything

Full Changelog: v1.3.2...v2.0