SamGIS QGIS Plugin - Instance Segmentation con SAM2 sul tuo PC

Questo plugin per QGIS porta Segment Anything Model 2 (SAM2) di Meta dentro a QGIS permettendo di fare instance segmentation direttamente sul tuo PC e completamente offline. Nessuna API cloud, nessuna GPU dedicata — i modelli girano in locale tramite ONNX Runtime.

Il plugin fa parte dell'ecosistema SamGIS. Mentre la demo web si basa su un backend FastAPI usando dei tile provider remoti (es. OpenStreetMap) SamGIS per QGIS funziona interamente offline con qualsiasi immagine georeferenziata presente in un progetto QGIS.

I modelli vengono scaricati una sola volta da Hugging Face e salvati in locale in ~/.samgis/models/.

Screenshots

Selezione layer e prompt	Risultato instance segmentation

Come funziona

1. Installare il plugin QGIS =) (le dipendenze Python vengono gestite "sotto al cofano" dal plugin stesso)
2. Caricare un layer raster georeferenziato in QGIS
3. Creare layer vettoriali con prompt a punti singoli (foreground/background) o rettangoli (solo foreground)
4. Selezionare dalla finestra modale SamGIS il layer raster ed il (oppure i) layer vettoriali prescelti
5. Nel caso non sia presente neppure un modello SAM2 il plugin proporrà la scelta del modello di cui fare download (es. "SAM 2.1 Tiny uint8" ~32 MB per iniziare rapidamente)
6. Il processo a questo punto
   1. converte le coordinate geografiche (o proiettate, a seconda del CRS) in coordinate pixel
   2. esegue la fase di riconoscimento vero e proprio usando il modello selezionato
   3. restituisce la maschera di segmentazione convertita in un layer vettoriale poligonale avente come CRS "EPSG:4326"

Funzionalità principali

• Completamente offline — i modelli vengono scaricati una sola volta e salvati in locale
• 8 varianti di modello — 4 dimensioni (Tiny, Small, Base+, Large) x 2 precisioni (uint8, fp32)
• Prompt a punti — punti foreground (label=1) e background (label=0)
• Prompt a rettangolo — bounding box tramite layer vettoriale poligonale
• Inferenza in background — l'interfaccia resta reattiva durante l'esecuzione del modello
• Gestione multi-banda — supporta raster in scala di grigi, RGB e multi-banda (1-3 bande)
• Output EPSG:4326 — i risultati vengono aggiunti come layer vettoriali poligonali
• Gestione dei modelli — download e selezione tramite una modale dedicata alla configurazione

Risorse

• Codice sorgente e documentazione completa: trincadev/samgis-qgis-plugin
• Correlati: demo web SamGIS
• Richiede QGIS 3.40+ LTR