FAVAMOD — Fase 1: TopoIndex

La Fase 1 del flusso di lavoro FAVAMOD è dedicata alla preparazione dei dati altimetrici del versante e al calcolo degli indici topografici tramite il modulo TopoIndex (della suite USGS TRIGRS).

TopoIndex analizza le direzioni di drenaggio della superficie topografica del DEM ed elabora le informazioni di connettività necessarie per il modulo di instradamento del deflusso superficiale (runoff routing) di TRIGRS:

• Calcolo dei fattori di ponderazione (nwf): TopoIndex determina il numero effettivo di fattori di ponderazione del deflusso verso le celle adiacenti.
• Integrazione automatica in TRIGRS: il valore di nwf calcolato da TopoIndex viene automaticamente recepito ed impiegato dalla piattaforma nella generazione del file di input di TRIGRS (tr_in.txt) per le simulazioni con modulo di deflusso attivo.

---

Caricamento dei Dataset in BADA (Prerequisito)

Prima di avviare la configurazione della PIS, occorre caricare le griglie altimetriche in formato raster ASCII Grid (.asc) nella sezione Gestione dataset - BADA della piattaforma, associandole ai relativi template per FAVAMOD v1:

1. Griglia di elevazione (elevation_grid): Modello Digitale di Elevazione (DEM) del versante (es. dem_val4.asc).

2. Direzione di flusso (direction_grid): Griglia delle direzioni di drenaggio della superficie (es. dir_val4.asc).

---

Step 1 — Connessione BADA

Nel primo step della PIS (Step 1 — Connessione BADA) occorre selezionare il Sistema di Riferimento delle Coordinate (CRS) di destinazione e associare le griglie precedentemente caricate in BADA.

Configurazione Step 1

Campo UI	Parametro Interno	Descrizione
Sistema di riferimento (CRS)	target_crs	Sistema di riferimento di destinazione (es. WGS 84 / UTM zone 33N). Tutte le griglie verranno riproiettate in questo CRS.
Griglia di elevazione	elevation_grid	Selezione del dataset BADA contenente il DEM (dem).
Direzione di flusso	direction_grid	Selezione del dataset BADA contenente le direzioni di flusso (direction).

A completamento dello Step 1 (cliccando su Salva e prosegui), le griglie vengono elaborate e pubblicate automaticamente su GeoServer per la visualizzazione cartografica nel LabSit.

---

Step 2 — Configurazione file TopoIndex

Nello Step 2 — Configurazione file TopoIndex vengono impostati i parametri di calcolo idrologico e topografico per generare il file di configurazione tpx_in.txt.

Parametri di Configurazione

Campo UI	Parametro	Opzioni / Valore Default	Descrizione
Metodo direzione di flusso	flow_direction_scheme	ESRI (valori da 1 a 255) (Default) TopoIndex (valori da 1 a 9)	Schema di codifica utilizzato nella griglia delle direzioni di drenaggio.
Esponente	exponent	Numeric (default: 20)	Esponente per il calcolo della ponderazione del flusso.
Numero di iterazioni	iterations	Integer (default: 100)	Numero massimo di iterazioni per il calcolo della connettività topografica.
Salva lista pendenza del vicinato	save_d8_neighbors	Boolean (true/false)	Salvataggio dell'elenco dei vicini D8.
Salva griglia pendenza del vicinato	save_d8_grid	Boolean (true/false)	Salvataggio della griglia delle pendenze dei vicini D8.
Salva lista di identificativi	save_index_list	Boolean (true/false)	Salvataggio della lista dei numeri di cella e relativi indici.
Salva griglia di identificativi	save_index_grid	Boolean (true/false)	Salvataggio della griglia dei numeri di indice topografico.
Salva griglia rimappata delle linee di deflusso	save_remapped_directions	Boolean (true/false)	Salvataggio della griglia delle direzioni rimappate da ESRI a TopoIndex.

Cliccando su Genera File, la piattaforma elabora la richiesta e rende disponibili i pulsanti di download per tpx_in.txt e l'archivio ZIP delle griglie riproiettate (topoindex_input.zip).

---

Step 3 — Output di TopoIndex ed Esecuzione Locale

Nello Step 3 — Output di TopoIndex, la piattaforma fornisce le istruzioni guidate per eseguire in locale il codice di calcolo TopoIndex:

Procedura di Esecuzione Locale

1. Preparazione Cartella: Scaricare i file tpx_in.txt e topoindex_input.zip (ed estrarre i raster dem_val4.asc e dir_val4.asc) all'interno di una cartella di lavoro locale (es. Analisi_TopoIndex).
2. Ambiente CygWin: Verificare la presenza di CygWin sul proprio PC con il pacchetto libgfortran3 e assicurarsi che sia presente nel PATH di sistema.
3. Esecuzione: Inserire l'eseguibile TopoIndex.exe nella cartella locale ed eseguirlo.

Cartella Locale Prima dell'Esecuzione	Cartella Locale Dopo l'Esecuzione

L'esecuzione del programma genera nella cartella locale il file TopoIndexLog.txt (unitamente ai file accessori TldscellList_output.txt e TlwfactorList_output.txt).

---

Prossimi Passi

Con l'ottenimento del file TopoIndexLog.txt, è possibile procedere con la Fase 2 — TRIGRS per il caricamento delle mappe geotecniche e l'avvio della modellazione dell'infiltrazione e della stabilità.