# Scan Viewer De Scan Viewer stelt u in staat gebouwdata te visualiseren, analyseren en te extraheren uit 3D-puntenwolkscans die ter plaatse zijn vastgelegd. Het overbrugt de kloof tussen fysieke realiteit en het digitale gebouwmodel door gebruik te maken van AI-gestuurde segmentatie om gebouwelementen te identificeren, ze te koppelen aan BIM-objecten en ze te voeden in de standaard Magma-verrijkingsworkflow. *** ## Overzicht Puntenwolkscans (E57-formaat) leggen de fysieke realiteit van een gebouw vast op een specifiek moment in de tijd. Met de Scan Viewer kunt u: * De scan in 3D verkennen. * AI-gedetecteerde elementen en hun classificaties beoordelen. * De gescande realiteit vergelijken met het BIM-ontwerpmodel. * AI-classificaties overschrijven indien nodig. * Gescande elementen promoveren tot Gebouwmodelobjecten voor verrijking in de BIM-workflow. *** ## De Scan Viewer openen De Scan Viewer is op twee manieren toegankelijk: 1. Vanuit de **Data Room** — Navigeer naar een IFC-submap en klik op **Openen in Scan**. 2. Vanuit het scan-documentitem (document **2-006** op het Architecture-niveau), dat het E57-bestand opslaat. De viewer is ingesloten via de **Magma Scan Viewer SDK** (`magma-scan-viewer-sdk`) als een iframe. Het authenticatietoken wordt automatisch **30 seconden voor het verlopen** vernieuwd, zodat uw sessie actief blijft tijdens lange beoordelingssessies zonder handmatig opnieuw in te loggen. *** ## Ondersteund bestandsformaat | Eigenschap | Waarde | | --------------- | ------------------------------------------------------------------------------------------------------- | | Bestandsformaat | E57 (ASTM E57 3D Imaging Data Exchange) | | Opslag | Het E57-bestand wordt ook opgeslagen als document **2-006** op het Architecture-niveau in de Data Room. | *** ## AI-segmentatie Wanneer een scan wordt geladen, voert de Scan Viewer automatisch AI-segmentatie uit op de puntenwolkdata om gebouwelementen te detecteren en te classificeren. ### Gedetecteerde elementtypen De AI identificeert de volgende elementcategorieën en koppelt ze aan Magma-gebouwniveaus: | AI-gedetecteerd element | Gekoppeld niveau | | --------------------------------------- | -------------------- | | Plafond, Vloer, Muur, Balk, Kolom, Trap | **Structure (S)** | | Raam, Deur | **Architecture (A)** | | Tafel, Stoel, Bank, Boekenkast | **Filled (F) / W1** | | Meubilair (algemeen) | **Wired 2 (W2)** | | Apparatuur | **Wired 3 (W3)** | ### Gegevens per element Voor elk element dat door de AI is gedetecteerd, worden de volgende gegevens gegenereerd en opgeslagen: | Eigenschap | Beschrijving | | ------------------------- | ----------------------------------------------------------------------------------------------------------------- | | **Betrouwbaarheidsscore** | Een waarde tussen 0 en 1 die aangeeft hoe zeker de AI is in zijn classificatie. Hoger betekent zekerder. | | **Centroïde (x, y, z)** | De middelpuntcoördinaten van het gedetecteerde element in de 3D-ruimte. | | **Begrenzingskader** | Het minimale 3D-begrenzingskader dat het element omsluit. | | **Vormmaten** | Drie vormbeschrijvers: **planariteit** (hoe vlak), **lineariteit** (hoe langwerpig), **sfeericiteit** (hoe rond). | | **Puntentelling** | Aantal punten in de puntenwolk dat tot dit element behoort. | | **Kamernummer** | De kamer waarin het element is gedetecteerd. | | **Verdiepingsniveau** | De verdieping waarop het element zich bevindt. | | **IFC GUID** | Als het element overeenkomt met een BIM-object, wordt de IFC GUID van dat object hier vastgelegd. | *** ## Scan-naar-BIM-koppeling De Scan Viewer bevat een functie voor **Scan-naar-BIM-koppeling** die gedetecteerde scanelementen uitlijnt met hun overeenkomstige objecten in het BIM 3D-model. ### Automatische koppeling Koppeling wordt automatisch uitgevoerd met behulp van de **IFC GUID**. Wanneer de AI-detectie een IFC GUID toewijst aan een scanelement, zoekt het systeem die GUID op in het BIM-model en maakt een verbinding tussen het fysieke scanelement en zijn digitale BIM-tegenhanger. ### Handmatige koppeling Wanneer automatische koppeling niet mogelijk is (bijv. de GUID niet wordt gedetecteerd of het element nieuw is), kunt u handmatige koppeling uitvoeren: 1. Selecteer het niet-gekoppelde scanelement in de viewer. 2. Klik op **Koppelen aan BIM-object**. 3. Zoek naar het doel-BIM-object op naam, type of GUID. 4. Bevestig de koppeling. Handmatige koppelingen worden vastgelegd in het auditspoor samen met de gebruiker die de koppeling heeft uitgevoerd. *** ## Classificatieoverschrijving AI-voorspellingen zijn niet altijd perfect. Met de functie **Classificatieoverschrijving** kunnen geautoriseerde betrokkenen een AI-toegewezen classificatie corrigeren. ### Een classificatie overschrijven 1. Selecteer het element waarvan u de classificatie wilt corrigeren. 2. Klik in het detailpaneel van het element op **Classificatie overschrijven**. 3. Selecteer het juiste elementtype uit de dropdown (bijv. van "Meubilair" naar "Apparatuur"). 4. Voer een **notitie** in die de reden voor de correctie uitlegt. 5. Bevestig de overschrijving. ### Auditspoor Elke classificatieoverschrijving wordt vastgelegd in een volledig **auditspoor** dat het volgende vastlegt: * De originele AI-classificatie en betrouwbaarheidsscore. * De gecorrigeerde classificatie. * De notitie van de beoordelaar. * De tijdstempel van de overschrijving. * De naam en rol van de betrokkene die de overschrijving heeft uitgevoerd. Dit zorgt voor volledige traceerbaarheid en verantwoording voor alle handmatige correcties. *** ## Vergelijking scanrealiteit vs. BIM-ontwerp Een van de krachtigste functies van de Scan Viewer is de mogelijkheid om de **gescande fysieke realiteit** te vergelijken met het **ontworpen BIM-model**. ### Hoe de vergelijking werkt Wanneer zowel een scan (E57) als een BIM-model (IFC) voor het gebouw zijn geladen, legt de viewer beide datasets over elkaar. De vergelijking markeert: * **Elementen aanwezig in het BIM maar niet gedetecteerd in de scan** — Mogelijk ontbrekend, nog niet geïnstalleerd of verborgen. * **Elementen gedetecteerd in de scan maar niet in het BIM** — Mogelijk nieuwe elementen, niet-geautoriseerde wijzigingen of AI-valse positieven. * **Positieafwijkingen** — Elementen die in beide aanwezig zijn maar ruimtelijk verschoven zijn tussen het ontwerp en de realiteit (bijv. een muur die 5 cm van zijn ontworpen positie is gebouwd). Deze vergelijking is van onschatbare waarde voor: * **Bouwvoortgangsbewaking** — Controleren welke ontworpen elementen fysiek zijn geïnstalleerd. * **Als-gebouwd-verificatie** — Bevestigen dat het voltooide gebouw overeenkomt met het goedgekeurde ontwerp. * **Onderhouds- en renovatieplanning** — Discrepanties identificeren voordat werkzaamheden beginnen. *** ## Scanelementen promoveren tot Gebouwmodelobjecten Gedetecteerde en gevalideerde scanelementen kunnen worden gepromoveerd tot **Gebouwmodelobjecten**, waarmee ze de standaard BIM-verrijkingsworkflow betreden. ### Promotie-workflow 1. Selecteer een scanelement (of meerdere elementen). 2. Bekijk de AI-classificatie en overschrijf deze indien nodig. 3. Klik op **Promoveren tot Gebouwmodelobject**. 4. Het element treedt als BIM-object in de standaard verrijkingsworkflow. 5. Betrokkenen kunnen het nu verrijken met data over alle 12 datasecties via de Initialisatiewizard of het Objectdetailpaneel van de BIM 3D-viewer. Gepromoveerde objecten worden bijgehouden in het gedeelte **Waardebijdragen** en dragen bij aan de Magma Index-score van het gebouw zodra hun datavelden zijn gevalideerd. *** ## Elementdetailpaneel Als u op een gedetecteerd element in de viewer klikt, wordt het detailpaneel geopend: | Eigenschap | Beschrijving | | --------------------------- | -------------------------------------------------------------------------------------- | | Elementtype | AI-toegewezen of overschreven classificatie. | | Betrouwbaarheid | AI-betrouwbaarheidsscore (0–1). | | Magma-niveau | Toegewezen niveau (S, A, W1–W5, F). | | Centroïde | X-, Y-, Z-coördinaten. | | Begrenzingskader | Afmetingen (breedte × hoogte × diepte). | | Planariteit | Vormmaat (0–1). | | Lineariteit | Vormmaat (0–1). | | Sfeericiteit | Vormmaat (0–1). | | Puntentelling | Aantal scanpunten in dit element. | | Kamernummer | Gedetecteerde kamer. | | Verdiepingsniveau | Gedetecteerde verdieping. | | IFC GUID | BIM-object-GUID (indien gekoppeld). | | Gekoppeld BIM-object | Link naar het overeenkomstige BIM-object (indien gekoppeld). | | Overschrijvingsgeschiedenis | Lijst van eerdere classificatieoverschrijvingen met notities, tijdstempels en actoren. | *** ## Integratie met de Data Room Het E57-scanbestand is niet alleen zichtbaar in de Scan Viewer — het wordt ook opgeslagen als een document op een specifieke locatie in de Data Room: * **Document:** `2-006` * **Niveau:** Architecture Dit betekent dat het scanbestand deelneemt aan de standaard documentlevenscyclus: het kan worden gevalideerd, geversioneerd, vervangen en op de blockchain worden gemint, net als elk ander document in de Data Room. De hash van het scandocument wordt on-chain vastgelegd tijdens DTT-minting, waardoor een fraudebestendig record wordt verschaft van de fysieke realiteit van het gebouw op het moment van de scan. *** ## Tips en best practices * Scan het gebouw in meerdere bouwfasen om de voortgang bij te houden en de als-gebouwde conditie vast te leggen voordat gebieden worden gesloten (bijv. scannen voordat bekleding structurele elementen verbergt). * Bekijk AI-betrouwbaarheidsscores zorgvuldig — elementen met een score onder **0,7** zijn kandidaten voor handmatige beoordeling en mogelijke classificatieoverschrijving. * Voer altijd een gedetailleerde notitie in bij het overschrijven van een classificatie — deze documentatie is waardevol voor toekomstige audits en kwaliteitsbeoordelingen. * Gebruik de **Scan-naar-BIM-vergelijking** voordat u een renovatie- of retrofitproject start om te zorgen dat het BIM-model de huidige toestand van het gebouw nauwkeurig weerspiegelt. * Promoveer scanelementen tot Gebouwmodelobjecten stapsgewijs — begin met structurele elementen met hoge betrouwbaarheid en werk naar beneden toe naar inrichtingselementen met lagere betrouwbaarheid. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mymagma.com/magma-documentation/nl/functies/scan-viewer.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.