Flusso di modellazione

Questa pagina descrive il flusso completo di un'attività di modellazione, dalla creazione al download degli output, le transizioni di stato dell'attività e il contenuto degli output della modellazione. Completa la configurazione descritta nella Guida all'accesso prima di chiamare le API.

Requisiti dei dati di input

Scegli i dati di input in base alle tue esigenze di modellazione:

Tipo di input	Descrizione	Consiglio
Pacchetto di scena LCC2	Directory completa della scena, incluse le risorse correlate come `info/poses.json`, con traiettoria di acquisizione	Da preferire quando servono modelli dettagliati, texture nitide e testo leggibile
Nuvola di punti LAS	Nuvola di punti LiDAR senza traiettoria di acquisizione. Deve contenere il colore RGB (Point Data Record Format 2 / 3 / 5 / 7 / 8 / 10). I file LAS senza colore non sono supportati	Da preferire quando serve un'elevata precisione dimensionale
Nuvola di punti PLY	Nuvola di punti 3DGS completa; può essere elaborata senza traiettoria di acquisizione	Da usare quando non sono disponibili né un pacchetto di scena LCC2 né una nuvola di punti LAS

Sono supportate due forme di caricamento:

Forma a directory: carica più file direttamente nella directory input, mantenendo i relativi percorsi.
Forma ad archivio: carica un file .zip; il server lo estrae automaticamente.

Flusso di integrazione minimo

Crea un'attività: chiama Crea attività e ottieni credenziali di caricamento. La modellazione automatica è attiva per impostazione predefinita (autoRebuild = 1). La risposta contiene il modelId dell'attività e le credenziali temporanee necessarie per il caricamento.
Carica i dati di input: con le credenziali temporanee del passaggio precedente, esegui un caricamento in più parti tramite l'API di object storage del provider cloud corrispondente. Vedi Credenziali di caricamento temporanee. La Key finale del file è savePath più il percorso relativo del file, ad esempio savePath + "render2/info/poses.json".
Segnala il completamento del caricamento: dopo aver caricato tutti i file, chiama Aggiorna stato di caricamento con status = 3. Il sistema avvia quindi automaticamente la modellazione.
Controlla l'avanzamento dell'attività: chiama Elenco attività paginato o Dettagli attività e osserva status e percent. status = 8 indica che la modellazione è completata; status = 9 indica che la modellazione non è riuscita. Esegui il polling non più spesso di ogni 5 secondi.
Scarica gli output: chiama Scarica risultati della modellazione per ottenere i link di download temporanei.

Nota: la concorrenza delle attività di modellazione non è limitata. Puoi inviare più attività contemporaneamente; ognuna entra in coda subito dopo l'invio e viene pianificata dal centro di calcolo man mano che i nodi si liberano.

Altri flussi supportati

Caricamento ripristinabile e credenziali scadute

Se un caricamento si interrompe o le credenziali temporanee scadono, chiama Ottieni di nuovo le credenziali di caricamento per ottenere nuove credenziali temporanee di caricamento, quindi prosegui il caricamento in più parti.

Avvio manuale della modellazione

Si applica quando l'attività è stata creata con autoRebuild = 0 e tutti i dati di input sono stati caricati. Chiama Avvia attività per avviare manualmente la modellazione.

Macchina a stati dell'attività

status	Significato	Descrizione
0	In attesa di caricamento	Attività creata, caricamento non avviato
1	Caricamento in corso	Stato predefinito dopo la creazione dell'attività
2	Caricamento in pausa	Pausa segnalata dall'integratore
3	Caricamento completato	Dopo la segnalazione, il server analizza la directory `input`; con `autoRebuild = 1` la modellazione si avvia automaticamente
4	Caricamento non riuscito	Errore segnalato dall'integratore
5	In attesa di accodamento	Stato riservato; non si verifica negli scenari Open API
6	In coda	Inviata al centro di calcolo, in attesa di un nodo libero
7	Modellazione in corso	Osserva `percent` per l'avanzamento della modellazione
8	Modellazione completata	Chiama l'API di download per ottenere gli output
9	Modellazione non riuscita	Leggi `errorCode` e `failedReason` per individuare la causa

Transizioni di stato con modellazione automatica:

0 Waiting for upload → 1 Uploading → 3 Upload completed → 6 Queued → 7 Modeling → 8 Modeling completed
                           ↓                                                 ↓
                     4 Upload failed                                 9 Modeling failed

Output della modellazione

Al termine della modellazione vengono prodotti i seguenti output. I download principali sono i tre file in coordinate native LCC.

File di output	Valore di type	Descrizione	Unità e coordinate
`model_align_scan.dxf`	`DXF`	Disegno vettoriale modificabile, mesh 3D 3DFACE	Millimetri, 1:1, coordinate native LCC
`model_align_scan.glb`	`GLB`	Modello 3D GLB, pronto per l'anteprima o per i motori grafici	Metri, asse Z esplicitamente verso l'alto, coordinate native LCC
`model_align_scan.blend`	`BLEND`	File di progetto Blender modificabile	Coordinate native LCC
`model_align_scan.rvt`	`RVT`	Modello Revit	Coordinate native LCC

Altri output ausiliari includono un'immagine BEV della pianta, un'immagine di sovrapposizione della nuvola di punti, un'immagine della disposizione degli arredi, un'anteprima renderizzata complessiva e i metadati di trasformazione delle coordinate coordinate_transform.json.