Plugin di Matrice per QGIS

• 2026-11-02 — Versione 0.3.5 — la Verifica preventiva si chiama ora VPIA nei livelli (gruppo «VPIA»), nei nomi e nei testi del plugin. Nessuna modifica ai dati: i tuoi progetti QGIS continuano a funzionare.
• 2026-10-27 — Versione 0.3.1 — anteprime delle foto nella tabella attributi e nel form di Carotaggi, Colonne stratigrafiche e Sezioni e prospetti (scaricate in background al caricamento del livello).
• 2026-10-27 — Versione 0.3.0 — nuovo gruppo di livelli «VPIA» nei cantieri di Verifica preventiva: Area di progetto, Siti (punti, linee, poligoni), Unità di ricognizione e Rinvenimenti, modificabili da QGIS in WGS84.
• 2026-10-27 — Versione 0.2.1 — foto e file ora letti dal nuovo archivio (Cloudflare R2), con ritorno automatico al vecchio per i file non ancora copiati. Nessuna azione richiesta: reinstalla lo zip per aggiornare.
• 2026-10-19 — Versione 0.2.0 — flusso Progettazione completo: Trincea, Saggio e Carotaggio si posizionano con click ripetuti sul layer giusto (Esc o tasto destro per finire); Sposta e Ruota con gli strumenti nativi; livelli raggruppati in «Progettazione»; la mappa si ingrandisce da sola sul cantiere.
• 2026-10-19 — «Chiudi progettazione»: la progettazione va in stand-by e si può avviare la Lettura carotaggi (carotaggi previsti in mappa) o l'Assistenza in corso d'opera (trincee e saggi di progetto in mappa), in sola lettura. I rinvenimenti non si creano più da QGIS: arrivano dall'app da campo e da QGIS si possono solo spostare.
• 2026-10-12 — Menù «Progettazione»: crea Trincee e Saggi (rettangolo larghezza/lunghezza/profondità, posiziona con un click, ruota con lo strumento nativo QGIS). Attivo solo sui layer Progettazione - Trincee/Saggi.
• 2026-10-12 — Prima versione pubblica (MVP, 0.1.0): accesso ai dati Matrice da QGIS e modello GeoPackage.

Il plugin ha bisogno di una libreria chiamata «psycopg2» per collegarsi al database di Matrice. Questo passaggio va fatto PRIMA di installare il plugin qui sotto, altrimenti QGIS lo segnala come non funzionante. Si fa una volta sola.

Dopo averlo scaricato, fai doppio clic per eseguirlo: cerca QGIS sul tuo computer da solo e installa la libreria al suo interno. Se Windows mostra un avviso di sicurezza («Microsoft Defender SmartScreen»), è normale per un file non firmato digitalmente: clicca «Ulteriori informazioni» poi «Esegui comunque».

Non usi Windows, o il programma non trova QGIS da solo? Metodo alternativo: apri QGIS, menù Plugin → Console Python, e incolla questa riga (sostituendo PERCORSO con la cartella dove hai estratto il plugin, dopo averlo scaricato qui sotto):

exec(open(r"PERCORSO\matrice_qgis_plugin\scripts\install_dependencies.py").read())

Versione attuale: 0.3.5 (Progettazione, VPIA). Compatibile con QGIS 3.28 e successivi.

⬇️ Scarica matrice_qgis_plugin.zip

Il plugin è ancora in fase di test (MVP): funziona, ma qualche dettaglio può cambiare prima della versione definitiva. Per qualsiasi anomalia, segnalala pure.

⚠️ Prima di procedere qui, completa il passaggio «Prima di tutto» qui sopra: senza, il plugin non si avvia.

1. Scarica il file matrice_qgis_plugin.zip (non estrarlo).
2. Apri QGIS. Dal menù in alto: Plugin → Gestisci e installa plugin…
3. Nella finestra che si apre, seleziona la voce «Installa da ZIP» nel menù a sinistra.
4. Clicca il pulsante con i tre puntini, scegli il file matrice_qgis_plugin.zip appena scaricato, poi clicca «Installa plugin».
5. Se QGIS mostra un avviso perché il plugin è ancora "sperimentale", conferma: è normale per una versione MVP.
6. Il plugin compare come una nuova icona nella barra degli strumenti di QGIS: da lì si accede con le stesse credenziali di Matrice.

Un file .gpkg vuoto, con lo schema dati già pronto per digitalizzare in QGIS (numero US, categoria, fase, descrizione) e poi associarlo ai dati raccolti su Matrice. Il campo "Created by" riporta «Matrice».