Modelleringsworkflow

Deze pagina beschrijft de volledige loop van een modelleringstaak, van aanmaken tot het downloaden van de uitvoer, de statusovergangen van een taak en wat de modelleringsuitvoer bevat. Rond eerst de voorbereiding uit de Integratiehandleiding af voordat je de API's aanroept.

Vereisten voor invoergegevens

Kies de invoergegevens op basis van je modelleringsbehoefte:

Invoertype	Beschrijving	Aanbeveling
LCC2-scènepakket	Volledige scènemap met bijbehorende bronnen zoals `info/poses.json`, inclusief opnametraject	Eerste keus als je fijne modeldetails, scherpe texturen en leesbare tekst nodig hebt
LAS-puntenwolk	LiDAR-puntenwolk zonder opnametraject. Moet RGB-kleur bevatten (Point Data Record Format 2 / 3 / 5 / 7 / 8 / 10). LAS zonder kleur wordt niet ondersteund	Eerste keus als je een hoge maatnauwkeurigheid nodig hebt
PLY-puntenwolk	Volledige 3DGS-puntenwolk; kan zonder opnametraject worden verwerkt	Gebruik deze als er geen LCC2-scènepakket en geen LAS-puntenwolk beschikbaar is

Er zijn twee uploadvormen:

Mapvorm: Upload meerdere bestanden rechtstreeks naar de map input en behoud hun relatieve paden.
Archiefvorm: Upload een .zip; de server pakt het automatisch uit.

Minimale integratievolgorde

Maak een taak aan: Roep Taak aanmaken en uploadreferenties ophalen aan. Automatisch modelleren staat standaard aan (autoRebuild = 1). De respons bevat de modelId van de taak en de tijdelijke referenties voor de upload.
Upload de invoergegevens: Upload met de tijdelijke referenties uit de vorige stap in delen via de objectopslag-API van de betreffende cloudprovider. Zie Tijdelijke uploadreferenties. De uiteindelijke bestands-Key is savePath plus het relatieve pad van het bestand, bijvoorbeeld savePath + "render2/info/poses.json".
Meld dat de upload klaar is: Roep na het uploaden van alle bestanden Uploadstatus bijwerken aan met status = 3. Het systeem start daarna automatisch met modelleren.
Volg de voortgang van de taak: Roep Takenlijst met paginering of Taakdetails aan en let op status en percent. status = 8 betekent dat het modelleren is voltooid; status = 9 betekent dat het modelleren is mislukt. Poll niet vaker dan eens per 5 seconden.
Download de uitvoer: Roep Modelleringsresultaten downloaden aan om tijdelijke downloadlinks te krijgen.

Opmerking: Het aantal gelijktijdige modelleringstaken is niet beperkt. Je kunt meerdere taken tegelijk indienen; elke taak komt direct na indienen in de wachtrij en wordt door het rekencentrum ingepland zodra er nodes vrijkomen.

Andere ondersteunde werkwijzen

Hervatbare upload en verlopen referenties

Als een upload wordt onderbroken of de tijdelijke referenties verlopen, roep dan Uploadreferenties opnieuw ophalen aan om nieuwe tijdelijke uploadreferenties te krijgen en ga verder met de upload in delen.

Modelleren handmatig starten

Geldt als de taak is aangemaakt met autoRebuild = 0 en alle invoergegevens zijn geüpload. Roep Taak starten aan om het modelleren handmatig te starten.

Statusmachine van een taak

status	Betekenis	Beschrijving
0	Wacht op upload	Taak aangemaakt, upload nog niet gestart
1	Bezig met uploaden	Standaardstatus na het aanmaken van de taak
2	Upload gepauzeerd	Pauze gemeld door de integrator
3	Upload voltooid	Na de melding scant de server de map `input`; met `autoRebuild = 1` start het modelleren automatisch
4	Upload mislukt	Mislukking gemeld door de integrator
5	Wacht op wachtrij	Gereserveerde status; komt niet voor in Open API-scenario's
6	In wachtrij	Ingediend bij het rekencentrum, wacht op een vrije node
7	Bezig met modelleren	Volg `percent` voor de voortgang van het modelleren
8	Modelleren voltooid	Roep de download-API aan om de uitvoer op te halen
9	Modelleren mislukt	Lees `errorCode` en `failedReason` om de oorzaak te vinden

Statusovergangen bij automatisch modelleren:

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

Modelleringsuitvoer

Na het modelleren wordt de volgende uitvoer gemaakt. De belangrijkste downloads zijn de drie bestanden in native LCC-coördinaten.

Uitvoerbestand	Waarde van type	Beschrijving	Eenheden en coördinaten
`model_align_scan.dxf`	`DXF`	Bewerkbare vectortekening, 3D-mesh van 3DFACE-vlakken	Millimeters, 1:1, native LCC-coördinaten
`model_align_scan.glb`	`GLB`	GLB-3D-model, geschikt voor preview of engines	Meters, expliciet Z-up, native LCC-coördinaten
`model_align_scan.blend`	`BLEND`	Bewerkbaar Blender-projectbestand	Native LCC-coördinaten
`model_align_scan.rvt`	`RVT`	Revit-model	Native LCC-coördinaten

Overige hulpuitvoer omvat een BEV-afbeelding van de plattegrond, een overlay-afbeelding van de puntenwolk, een afbeelding van de meubelindeling, een gerenderde totaalpreview en de metadata voor coördinatentransformatie coordinate_transform.json.