Opzioni di ODM e ODX a confronto: come trovare le differenze

Il punto di partenza: opzioni identiche#

Al 6 aprile 2026 il motore ODX della linea WebODM e il motore ODM 3.6.0 della linea OpenDroneMap erano lo stesso codice. Ne segue che le opzioni di elaborazione (i parametri che passi al motore, come --dsm o --pc-quality) erano identiche: stessi nomi, stessi valori ammessi, stessi default. Le 93 opzioni documentate su docs.opendronemap.org/arguments per ODM 3.6.0 valevano anche per ODX.

Da allora i due motori divergono, e nessuna tabella scritta da noi può essere completa per sempre. Per questo la guida ti dà prima il metodo per vedere le differenze con i tuoi occhi, poi la tabella di riferimento datata, poi le novità annunciate da una sola linea, infine come scrivere preset validi su entrambe.

Termini usati: "opzione" (option, flag, argument) è un parametro della riga di comando; "preset" è un insieme di opzioni salvato con un nome; "diff" è un programma che confronta due file di testo riga per riga. Il glossario li raccoglie.

Il metodo: chiedere ai motori con --help#

La fonte più affidabile sulle opzioni non è una pagina web, che può essere in ritardo, ma l'immagine Docker che userai davvero.

1. Scarica le due immagini#

Il metodo è lo stesso; cambia l'immagine.

docker pull webodm/odm

docker pull opendronemap/odm

2. Salva l'output di --help in due file#

docker run --rm webodm/odm --help > odx-help.txt
docker run --rm opendronemap/odm --help > odm-help.txt

Ogni comando avvia un container temporaneo (--rm lo elimina alla fine) e salva l'aiuto in un file di testo.

3. Confronta i due file#

diff odm-help.txt odx-help.txt

Le righe precedute da < esistono solo nel primo file (ODM), quelle precedute da > solo nel secondo (ODX). Output vuoto: stesso aiuto. Per un confronto affiancato:

diff -y --suppress-common-lines odm-help.txt odx-help.txt

4. Estrai solo i nomi delle opzioni#

Descrizioni e a capo possono differire per motivi editoriali. Per confrontare solo i nomi:

grep -oE '^\s*--[a-z0-9-]+' odm-help.txt | tr -d ' ' | sort -u > odm-opts.txt
grep -oE '^\s*--[a-z0-9-]+' odx-help.txt | tr -d ' ' | sort -u > odx-opts.txt
diff odm-opts.txt odx-opts.txt

Il risultato è l'elenco delle opzioni presenti in un solo motore; le differenze di default o di valori ammessi emergono dal diff completo del passo 3.

5. Registra versioni e data#

Un confronto vale per le versioni confrontate. Annota:

docker run --rm webodm/odm --version
docker run --rm opendronemap/odm --version
docker inspect --format '{{index .RepoDigests 0}}' webodm/odm
docker inspect --format '{{index .RepoDigests 0}}' opendronemap/odm

Il digest identifica in modo univoco l'immagine, indipendentemente dal tag. Conservalo insieme ai file --help.

Le stesse opzioni in WebODM e in OpenDroneMap Desktop#

Le interfacce non hanno un proprio elenco di opzioni: lo chiedono al nodo a cui sono collegate. In WebODM il pannello di un task mostra ciò che il nodo scelto dichiara: con NodeODX le opzioni di ODX, con un nodo opendronemap/nodeodm (configurazione non supportata ufficialmente, vedi Repository, immagini Docker e migrazioni) quelle di ODM. Lo stesso vale per OpenDroneMap Desktop con il suo nodo. Il confronto da riga di comando resta il più pulito.

Tabella: le 93 opzioni identiche al 6 aprile 2026#

La fotografia al momento della separazione: le opzioni di ODM 3.6.0 con i loro default, identiche in ODX. È il riferimento storico e la base per i preset portabili. Per il significato di ogni opzione: Guida completa alle opzioni.

Due note dalla documentazione di ODM: --max-concurrency è documentato con default 4, ma in pratica il motore usa il numero di core disponibili; le opzioni --time, --resize-to e --depthmap-resolution, frequenti nei tutorial vecchi, non esistono più nella serie 3.x di nessuno dei due motori.

Opzioni annunciate da una sola linea#

Riportiamo solo annunci ufficiali, con la data; quando un annuncio non specifica la sintassi, rimandiamo alla documentazione della linea.

Il checkpoint dei GCP è l'unica novità del 12 luglio 2026 che tocca, per quanto dichiarato, l'uso di un file di input. Se passi a ODM 3.6.0 un file GCP scritto con la sintassi dei checkpoint di ODX, il comportamento dipende da come ODM tratta ciò che non riconosce: prova prima su un dataset piccolo. Sintassi su docs.webodm.org; formato base del file, comune alle due linee, in Punti di controllo a terra.

Per la linea OpenDroneMap la scheda non registra, alla data di verifica, opzioni nuove dopo la 3.6.0. Non significa che non esistano: controlla le release su github.com/OpenDroneMap/ODM e docs.opendronemap.org/arguments, e segnalaci via Contatti ciò che manca.

Preset portabili#

WebODM gestisce i preset nell'interfaccia (Preset e opzioni base); da riga di comando un preset è la stringa di opzioni che passi al motore. Se lavori con entrambe le linee, o vuoi restare libero di cambiare, segui tre regole.

Usa solo opzioni comuni#

Finché una novità è dichiarata da una sola linea, tienila fuori dal preset di base: le 93 opzioni della tabella sono il perimetro sicuro alla data. Se ti serve un'opzione esclusiva, crea una variante con un nome che lo dica, per esempio rilievo-gcp-odx, e conserva la versione comune.

Salva i preset come testo#

Un file di testo rende i preset leggibili, versionabili e trasferibili tra installazioni e linee. Esempio per un rilievo con DSM e ortofoto a 2 cm/px:

# preset: rilievo-standard
# valido per ODM 3.6.0 e ODX (opzioni comuni al 6 aprile 2026)
# verificato: 2 settembre 2026
--dsm
--dtm
--pc-quality high
--feature-quality high
--orthophoto-resolution 2
--dem-resolution 2
--pc-las
--cog
--auto-boundary

Da riga di comando lo usi con entrambe le immagini, cambiando solo il nome dell'immagine (webodm/odm o opendronemap/odm):

docker run -ti --rm -v /home/utente/datasets:/datasets opendronemap/odm --project-path /datasets progetto $(grep -v '^#' rilievo-standard.txt | tr '\n' ' ')

grep -v '^#' scarta i commenti e tr mette le opzioni su una riga. In WebODM le stesse opzioni si inseriscono nel pannello del task e si salvano come preset con lo stesso nome.

Documenta la linea e la versione#

Ogni preset deve dire per quale motore e versione è stato verificato, come nell'esempio. A ogni nuova versione riesegui il metodo --help: un'opzione sparita produce un errore all'avvio, ed è meglio scoprirlo su un dataset di prova.

Problemi frequenti#

Il diff mostra decine di differenze ma sono solo a capo e spazi. Usa il passo 4 (confronto dei soli nomi) oppure aggiungi a diff le opzioni -w (ignora gli spazi) e -B (ignora le righe vuote).

Un'opzione che vedo in WebODM non compare in --help del motore. Alcune voci del pannello sono dell'interfaccia, non del motore (per esempio la scelta del nodo).

Il preset funziona su una linea e fallisce sull'altra. Cerca nell'errore il nome dell'opzione non riconosciuta e controlla se è tra quelle annunciate da una sola linea. Spostala in una variante del preset.

Prossimi passi#

• Il significato e i valori di ogni opzione: Guida completa alle opzioni.
• Usa lo stesso preset per misurare i due motori sullo stesso dataset: Stesso dataset, due motori.
• Se lavori con GCP e checkpoint: Punti di controllo a terra.