Raise of Slopes — Guida utente

Questo plugin per QGIS esegue l'analisi di stabilità dei versanti con il Metodo dell'Equilibrio Limite (Bishop, Spencer, Morgenstern-Price) su superfici di scivolamento circolari. A partire da un DEM estrae un profilo altimetrico, modella la stratigrafia e la falda, e cerca la superficie critica che minimizza il Fattore di Sicurezza (FS) tramite una griglia di ricerca esaustiva oppure un ottimizzatore simplex di Nelder–Mead.

Flusso di lavoro rapido

  1. Caricare un raster DEM in QGIS.
  2. Aprire il plugin e andare su : selezionare due punti sulla mappa per estrarre la sezione.
  3. Inserire i parametri geotecnici nella scheda .
  4. Configurare eventualmente un secondo strato e/o la falda in .
  5. Eseguire l'analisi da o tramite il pulsante Run in basso.
  6. Ripetere su più sezioni e accumulare i risultati nella .
  7. Esportare i risultati (grafico, CSV, DXF, report testuale) dal menu Export.

Ringraziamenti

Questo lavoro è stato finanziato dall'Unione Europea — NextGenerationEU e dal Ministero dell'Università e della Ricerca (MUR), Piano Nazionale di Ripresa e Resilienza (PNRR), Missione 4, Componente 2, Investimento 1.5, progetto “RAISE — Robotics and AI for Socio-economic Empowerment” (ECS00000035). Andrea Bressan, Simone Pittaluga, Lorenzo Tamellini e Domenico Gallipoli fanno parte dell'Innovation Ecosystem RAISE.

Come citare

Se utilizzi questo plugin in attività di ricerca o in ambito professionale, cita il lavoro scientifico alla base della metodologia implementata:

Lalicata, L.M., Bressan, A., Pittaluga, S. et al. An Efficient Slope Stability Algorithm with Physically Consistent Parametrisation of Slip Surfaces. Int J Civ Eng 23, 671–682 (2025).
https://doi.org/10.1007/s40999-024-01053-1

Scheda: Elevation Profile

Punto di partenza obbligatorio: tutte le analisi si basano sul profilo calcolato in questa scheda.

Estrazione del profilo

Controlli del grafico

Menu Export

OpzioneOutput
Export CSVTabella distanza–quota del profilo campionato.
Export results (TXT)Report testuale con tutti i risultati, i parametri e il sommario delle superfici.
Export image (PNG/SVG)Grafico del profilo come immagine raster o vettoriale. Include opzionalmente la legenda stratigrafica.
Export DXFProfilo e superfici di scivolamento su layer DXF separati, con legenda. Usa ezdxf se disponibile, altrimenti scrive un DXF ASCII minimale.

Menu Project

Salva o carica lo stato completo del plugin in un file .rslope (JSON). Il file contiene il profilo campionato, tutti i parametri, le superfici calcolate, la visibilità delle superfici e la configurazione della mappa di pericolosità. Al caricamento, i layer raster referenziati vengono ricercati nel progetto QGIS corrente per nome; i layer mancanti vengono segnalati con la possibilità di proseguire comunque.

Scheda: Soil Parameters

Proprietà geotecniche dello strato primario (superficiale). I valori sono condivisi tra analisi Grid e Simplex.

ParametroSimboloUnitàIntervallo tipico
Peso di volumeγkN/m³15 – 22
CoesioneckPa0 – 50
Porositàn0,20 – 0,45
Angolo di attritoφ°15 – 40
Numero di conci20 – 100 (default 50)

Il blocco dei parametri del Secondo Strato (γ₂, c₂, n₂, φ₂) viene utilizzato quando il secondo strato è abilitato nella scheda Stratigraphy & Water Table.

Scheda: Stratigraphy & Water Table

Secondo strato

Abilita un modello bilivello. L'interfaccia tra strato 1 (terreno superficiale) e strato 2 (formazione più profonda) si può definire in tre modi:

Quando il secondo strato è attivo, l'interfaccia appare come linea tratteggiata marrone sul grafico del profilo.

Falda freatica

Abilita il calcolo delle pressioni interstiziali. La falda si può definire con gli stessi tre metodi del secondo strato. Quando attiva, viene disegnata come linea tratteggiata blu sul grafico e le pressioni interstiziali modificano le tensioni efficaci nel risolutore MEL.

💡 Il grafico si aggiorna in tempo reale mentre si modificano i parametri di stratigrafia e falda: è possibile vedere immediatamente l'effetto delle variazioni.

Scheda: Grid Analysis

Valuta il fattore di sicurezza per un ampio insieme discreto di superfici circolari campionate su una griglia regolare di coppie (ingresso, uscita). Fornisce una visione globale della stabilità del versante al costo di un tempo di calcolo più elevato.

ParametroDescrizione
Metodo di calcoloRisolutore MEL: Bishop (semplificato), Morgenstern–Price, o Spencer.
Entry pointsNumero di nodi della griglia nell'intervallo di ricerca per il punto di ingresso (monte).
Exit pointsNumero di nodi per il punto di uscita (valle).
Min η incrementPasso angolare minimo per il parametro di curvatura η. Valori minori esplorano archi più piatti.
In – min / max (frazione)Posizione frazionaria lungo il profilo [0 = P1, 1 = P2] entro cui le superfici possono entrare nel versante.
Out – min / max (frazione)Posizione frazionaria entro cui le superfici possono uscire.
Surfaces to displayNumero di superfici con FS più basso da visualizzare, colorate su scala rosso–verde.
💡 Per un'analisi tipica impostare In min=0.0, In max=0.5 e Out min=0.5, Out max=1.0 in modo che gli intervalli di ingresso e uscita non si sovrappongano. Iniziare con una griglia 10×10 e affinare una volta individuata la zona critica.

Scheda: Simplex Analysis

Utilizza un ottimizzatore Nelder–Mead inizializzato da una griglia rada per trovare la superficie con FS minimo. Molto più veloce di una griglia completa a parità di risoluzione finale; ideale per affinare la ricerca intorno a una zona critica già individuata.

ParametroDescrizione
Metodo di calcoloBishop, Morgenstern–Price, o Spencer.
x_in min / max (frazione)Limiti di ricerca per il punto di ingresso, come frazione della lunghezza del profilo.
x_out min / max (frazione)Limiti di ricerca per il punto di uscita.
η min / maxLimiti angolari per il parametro di curvatura dell'arco (gradi).
Max iterationsLimite di iterazioni per l'ottimizzatore (default 300).
Surfaces to displayNumero di superfici ottimizzate distinte da mostrare (deduplicate per punto di convergenza).

Scheda: Hazard Map

Accumula i risultati di più analisi di profilo in due raster GeoTIFF georeferenziati che coprono l'area di studio:

I raster vengono stilizzati automaticamente al caricamento in QGIS: il FS usa la rampa rosso–giallo–verde; la profondità usa la rampa bianco–blu.

Flusso di lavoro per una mappa multi-profilo

  1. Analizzare il primo profilo e passare alla scheda Hazard Map.
  2. Selezionare Create new rasters, definire estensione, risoluzione e percorsi di output, quindi premere Add current result to map.
  3. Abilitare Update rasters automatically after each analysis per i profili successivi.
  4. Analizzare ogni ulteriore sezione; i raster si aggiornano automaticamente.
  5. Per ricominciare da zero, passare a Update existing rasters e abilitare Overwrite.
⚠ La Hazard Map richiede GDAL (osgeo) nell'ambiente Python di QGIS. È incluso nelle installazioni standard di QGIS.

Metodi di stabilità

MetodoForze interstizialiEquilibrio soddisfattoNote
Bishop (semplificato)Solo orizzontaliMomentoRapido e accurato per superfici circolari. Scelta predefinita consigliata.
Morgenstern–PriceInclinate (f(x) costante)Forze + MomentoRigoroso. Adatto anche a superfici irregolari o non circolari.
SpencerInclinate (angolo costante)Forze + MomentoRigoroso. Accuratezza analoga a Morgenstern–Price.

Interpretazione dei Risultati

Sul grafico, le superfici di scivolamento sono colorate su una scala continua rosso–giallo–verde che copre l'intervallo di FS di tutte le superfici visualizzate. La superficie critica (FS minimo) è tracciata con linea più spessa ed etichettata #1.

Formati file

EstensioneContenuto
.rslopeStato completo del progetto (JSON): dati del profilo, parametri, superfici calcolate, configurazione della mappa di pericolosità.
.csvProfilo altimetrico: due colonne, distance (m) e elevation (m).
.txtReport testuale con parametri, risultati e CSV del profilo.
.png / .svgImmagine del grafico del profilo (raster o vettoriale).
.dxfProfilo e superfici di scivolamento come polilinee DXF su layer separati, con legenda.