I preset di WebODM e le opzioni base spiegate

Il pannello Opzioni di WebODM contiene decine di parametri. Nessuno li imposta uno per uno: si parte da un preset, una combinazione già pronta per un tipo di lavoro, e al massimo si ritoccano due o tre valori. Questa guida ti spiega cosa c'è dietro ogni preset in modo qualitativo, con i nomi delle opzioni coinvolte. I valori esatti di ciascun preset possono cambiare tra versioni: quando un numero conta, aprilo e leggilo nel pannello Opzioni di WebODM, che li mostra tutti.

Le opzioni sono quelle del motore (ODX in WebODM, con la stessa base di ODM 3.6.0 alla data della separazione dei due progetti). Il riferimento completo è in docs.webodm.org/options-flags e docs.opendronemap.org/arguments; in italiano, con default e consigli per ogni voce, nella Guida completa alle opzioni.

Come si usano i preset#

Quando crei o riavvii un task, la voce Options mostra il preset attivo. Un menu a tendina elenca quelli disponibili; sotto, il pannello espanso elenca le opzioni con i valori impostati dal preset. Puoi modificarne alcune e salvare il risultato come preset personalizzato, con un tuo nome: comodo quando un ufficio elabora sempre lo stesso tipo di rilievo.

Pannello Opzioni di WebODM con il menu dei preset e le opzioni espanse — Il menu dei preset e, sotto, le opzioni che ciascuno imposta.

I preset, uno per uno#

Default#

Il punto di partenza. Produce ortofoto, DSM, nuvola di punti e modello 3D con texture con valori bilanciati: --feature-quality alta, --pc-quality media, risoluzioni di ortofoto e DEM al valore standard di 5 cm/px, DTM non attivo. È il preset giusto per il primo progetto e per la maggior parte dei rilievi generici. Se non sai cosa scegliere, scegli questo.

Fast Orthophoto#

Il più veloce. Attiva --fast-orthophoto, che salta la nuvola di punti densa e costruisce l'ortofoto direttamente dalla nuvola sparsa della ricostruzione. Il modello 3D e il DSM ne risentono (o mancano), l'ortofoto può essere meno precisa sui bordi di oggetti alti, ma il tempo di calcolo e la RAM necessaria crollano. Usalo per una verifica rapida in campo, per capire se un volo è buono prima di lanciare un'elaborazione lunga, o per aree pianeggianti dove serve solo la mappa.

High Resolution#

L'opposto: qualità al massimo, tempi e RAM di conseguenza. Alza --feature-quality e --pc-quality e abbassa il valore di --orthophoto-resolution e --dem-resolution (un numero più piccolo in cm/px significa più dettaglio). Ha senso solo se il GSD del volo lo giustifica: chiedere un'ortofoto a 1 cm/px da foto scattate con GSD di 3 cm/px produce file enormi senza dettaglio in più. Verifica i valori nel pannello Opzioni di WebODM e confrontali con il tuo GSD (Acquisire le immagini).

DSM + DTM#

Attiva --dsm e --dtm insieme. Il DSM (modello digitale di superficie) include edifici e vegetazione; il DTM (modello digitale del terreno) prova a rimuoverli con il filtro SMRF (opzioni --smrf-*) per stimare il suolo nudo. È il preset per curve di livello, analisi idrauliche, calcoli di pendenza. Il DTM è una stima: sotto un bosco fitto o tra edifici addossati il terreno vero non è visibile e il risultato va verificato. Approfondimento in DSM, DTM e curve di livello.

Buildings#

Pensato per edifici e aree urbane fotografati con camera obliqua. Privilegia una ricostruzione 3D più fedele delle facciate e degli spigoli: qualità della nuvola e della mesh più alte, e impostazioni orientate al modello 3D (si può incontrare --use-3dmesh, che usa la mesh 3D completa invece di quella 2.5D per l'ortofoto). Va di pari passo con un volo a doppia griglia e camera a 60–70°. I valori esatti sono nel pannello Opzioni di WebODM.

Field#

Per campi coltivati e terreni agricoli: superfici ampie, relativamente piatte, spesso omogenee. Punta a una ricostruzione stabile con poche feature distintive e a un'ortofoto pulita, senza spendere risorse sul 3D. Qualitativamente si colloca tra Fast Orthophoto e Default; confronta i valori nel pannello Opzioni di WebODM.

Forest#

Per aree boscate e vegetazione fitta, il caso più difficile per la fotogrammetria: le chiome cambiano da uno scatto all'altro e le feature scarseggiano. Il preset alza il numero minimo di feature (--min-num-features) e lavora con impostazioni più tolleranti nel matching, accettando tempi più lunghi. Anche qui il volo conta più delle opzioni: 80/80 di sovrapposizione e vento debole. Vedi Casi particolari.

3D Model#

Per chi vuole il modello 3D con texture come prodotto principale. Aumenta la densità della nuvola (--pc-quality), il numero di facce della mesh (--mesh-size) e il livello di dettaglio dell'octree (--mesh-octree-depth), e cura le texture (--texturing-*). Produce file grandi. Con l'opzione --gltf ottieni il modello anche in formato GLB, pronto per il web e per Blender. Approfondimento in Modello 3D con texture.

Multispectral#

Per camere multispettrali (bande separate, spesso una camera per banda). Attiva la calibrazione radiometrica (--radiometric-calibration, con i valori camera o camera+sun) e permette di indicare la banda di riferimento per l'allineamento (--primary-band). Con una normale camera RGB questo preset non aggiunge nulla. Il tema è trattato in NDVI e multispettrale in agricoltura.

Volume Analysis#

Per cumuli, scavi, depositi: serve un DSM affidabile su cui misurare i volumi. Attiva --dsm e privilegia una nuvola densa di buona qualità; il modello 3D con texture passa in secondo piano. Le misure si fanno poi con lo strumento di misura di WebODM (Misure, aree e volumi).

Point of Interest#

Per un singolo oggetto fotografato in orbita (una statua, una torre, una macchina): il modello 3D dell'oggetto conta, la mappa del terreno no. Imposta la ricostruzione per gestire camere che convergono verso un punto, invece della griglia parallela di un rilievo di area. Non usarlo per aree estese. Verifica i valori nel pannello Opzioni di WebODM.

Tabella di scelta rapida#

Cosa ti serve	Preset di partenza	Tempo e RAM
Solo la mappa, in fretta	Fast Orthophoto	minimi
Un rilievo generico	Default	medi
Massimo dettaglio (GSD lo consente)	High Resolution	alti
Curve di livello, pendenze	DSM + DTM	medi
Edifici, centro storico in 3D	Buildings	alti
Campo coltivato, ortofoto	Field	medio-bassi
Bosco, vegetazione	Forest	alti
Modello 3D da pubblicare	3D Model	alti
Camera multispettrale	Multispectral	medi
Cumuli e scavi	Volume Analysis	medi
Un oggetto in orbita	Point of Interest	medi

Le opzioni base da conoscere#

Dieci opzioni coprono la grande maggioranza delle esigenze. I default sono quelli documentati per ODM 3.6.0 / ODX.

Opzione	Default	A cosa serve
`--feature-quality`	high	Risoluzione a cui cerca le feature (ultra, high, medium, low…); più alta = più lento
`--pc-quality`	medium	Densità della nuvola di punti; è la leva più pesante su tempi e RAM
`--orthophoto-resolution`	5 cm/px	Risoluzione dell'ortofoto; non scendere sotto il GSD reale
`--dem-resolution`	5 cm/px	Risoluzione di DSM e DTM
`--dsm`, `--dtm`	disattivi	Genera i modelli di elevazione
`--fast-orthophoto`	disattivo	Salta la nuvola densa
`--skip-3dmodel`	disattivo	Non genera mesh e texture: risparmia tempo se ti serve solo il 2D
`--auto-boundary`	disattivo	Ritaglia automaticamente il modello intorno alle posizioni delle camere
`--crop`	3 m	Quanto tagliare dai bordi, dove la ricostruzione è debole
`--cog`	disattivo	Ortofoto come Cloud Optimized GeoTIFF, più comoda in QGIS e sul web

Altre due opzioni ricorrono spesso nei problemi di memoria: --optimize-disk-space elimina i file intermedi, e --max-concurrency (default 4) limita i processi paralleli. Il ridimensionamento delle immagini, invece, non è un'opzione del motore ma una casella nella finestra di caricamento di WebODM. Tutte le leve per tempi e RAM sono raccolte in Ottimizzare tempi e memoria.

Metodo di lavoro#

Elabora il primo task con Default (o Fast Orthophoto se hai fretta).
Leggi il report di qualità: se l'acquisizione ha problemi, nessun preset li corregge.
Riavvia il task (Restart) con il preset adatto al tuo obiettivo.
Se serve, cambia una opzione alla volta e salva il preset con un nome tuo.
Annota preset e opzioni nella documentazione del lavoro: tra sei mesi vorrai riprodurre lo stesso risultato.

Come verificare

Hai scelto bene se:

Il tempo di elaborazione è proporzionato allo scopo (una verifica rapida non deve durare una notte).
La risoluzione di ortofoto e DEM richiesta non è più fine del GSD del volo.
I prodotti che ti servono ci sono (DSM/DTM se richiesti, modello 3D se richiesto) e quelli che non ti servono non hanno consumato ore.

Problemi frequenti#

High Resolution fallisce per memoria dove Default riesce. Normale: --pc-quality e --feature-quality alte moltiplicano la RAM. Ridimensiona le immagini o passa a una macchina più grande.

Il DTM mostra "gobbe" dove c'erano edifici. Il filtro SMRF non ha rimosso del tutto gli oggetti: regola le opzioni --smrf-* o accetta il limite. Vedi DSM, DTM e curve di livello.

Fast Orthophoto produce bordi seghettati sugli edifici. È il compromesso del preset: senza nuvola densa gli oggetti alti sono approssimati. Per i centri urbani usa Default o Buildings.

Non trovo un preset tra quelli elencati. L'elenco può cambiare tra versioni: verifica nel tuo pannello Opzioni e nella documentazione ufficiale.

Prossimi passi#

Guida completa alle opzioni: ogni opzione con default e consigli.
Ottimizzare tempi e memoria: quali opzioni incidono davvero.
Leggere il report di qualità: giudicare il risultato prima di cambiare preset.