# Scan Viewer Der Scan Viewer ermöglicht es Ihnen, Gebäudedaten aus 3D-Punktwolkenscans zu visualisieren, analysieren und zu extrahieren, die vor Ort aufgenommen wurden. Er überbrückt die Lücke zwischen physischer Realität und dem digitalen Gebäudemodell, indem er KI-gestützte Segmentierung verwendet, um Gebäudeelemente zu identifizieren, sie mit BIM-Objekten abzugleichen und sie in den standardmäßigen Magma-Anreicherungs-Workflow einzuspeisen. *** ## Übersicht Punktwolkenscans (E57-Format) erfassen die physische Realität eines Gebäudes zu einem bestimmten Zeitpunkt. Der Scan Viewer ermöglicht Ihnen: * Den Scan in 3D zu erkunden. * KI-erkannte Elemente und ihre Klassifizierungen zu überprüfen. * Die gescannte Realität mit dem BIM-Entwurfsmodell zu vergleichen. * KI-Klassifizierungen bei Bedarf zu überschreiben. * Gescannte Elemente zu Gebäudemodelobjekten für die Anreicherung im BIM-Workflow zu befördern. *** ## Zugriff auf den Scan Viewer Der Scan Viewer ist auf zwei Wegen zugänglich: 1. Vom **Data Room** aus — Navigieren Sie zu einem IFC-Unterordner und klicken Sie auf **In Scan öffnen**. 2. Vom Scan-Dokumenteintrag (Dokument **2-006** auf der Architecture-Ebene), der die E57-Datei speichert. Der Viewer wird über das **Magma Scan Viewer SDK** (`magma-scan-viewer-sdk`) als iframe eingebettet. Das Authentifizierungstoken wird automatisch **30 Sekunden vor Ablauf** erneuert, sodass Ihre Sitzung bei langen Überprüfungssitzungen aktiv bleibt, ohne manuelle Neuanmeldung. *** ## Unterstütztes Dateiformat | Eigenschaft | Wert | | ----------- | --------------------------------------------------------------------------------------------------- | | Dateiformat | E57 (ASTM E57 3D-Bildgebungsdatenaustausch) | | Speicherort | Die E57-Datei wird auch als Dokument **2-006** auf der Architecture-Ebene im Data Room gespeichert. | *** ## KI-Segmentierung Wenn ein Scan geladen wird, führt der Scan Viewer automatisch KI-Segmentierung auf den Punktwolkendaten durch, um Gebäudeelemente zu erkennen und zu klassifizieren. ### Erkannte Elementtypen Die KI identifiziert die folgenden Elementkategorien und ordnet sie den Magma-Gebäudeebenen zu: | KI-erkanntes Element | Zugeordnete Ebene | | ----------------------------------------- | -------------------- | | Decke, Boden, Wand, Balken, Säule, Treppe | **Structure (S)** | | Fenster, Tür | **Architecture (A)** | | Tisch, Stuhl, Sofa, Bücherregal | **Filled (F) / W1** | | Möbel (allgemein) | **Wired 2 (W2)** | | Ausrüstung | **Wired 3 (W3)** | ### Daten pro Element Für jedes von der KI erkannte Element werden folgende Daten generiert und gespeichert: | Eigenschaft | Beschreibung | | ---------------------- | ---------------------------------------------------------------------------------------------------------------- | | **Konfidenzwert** | Ein Wert zwischen 0 und 1, der angibt, wie sicher die KI bei ihrer Klassifizierung ist. Höher bedeutet sicherer. | | **Zentroid (x, y, z)** | Die Mittelpunktkoordinaten des erkannten Elements im 3D-Raum. | | **Begrenzungsrahmen** | Der minimale 3D-Begrenzungsrahmen, der das Element einschließt. | | **Formmetriken** | Drei Formbeschreiber: **Planarität** (wie flach), **Linearität** (wie länglich), **Sphärizität** (wie rund). | | **Punktanzahl** | Anzahl der Punkte in der Punktwolke, die zu diesem Element gehören. | | **Raumnummer** | Der Raum, in dem das Element erkannt wurde. | | **Stockwerksebene** | Das Stockwerk, auf dem sich das Element befindet. | | **IFC GUID** | Wenn das Element mit einem BIM-Objekt übereinstimmt, wird hier die IFC GUID dieses Objekts aufgezeichnet. | *** ## Scan-zu-BIM-Abgleich Der Scan Viewer umfasst eine **Scan-zu-BIM-Abgleich**-Funktion, die erkannte Scan-Elemente mit ihren entsprechenden Objekten im BIM 3D-Modell abgleicht. ### Automatischer Abgleich Der Abgleich wird automatisch über die **IFC GUID** durchgeführt. Wenn die KI-Erkennung einem Scan-Element eine IFC GUID zuweist, sucht das System diese GUID im BIM-Modell und erstellt eine Verbindung zwischen dem physischen Scan-Element und seinem digitalen BIM-Pendant. ### Manueller Abgleich Wenn ein automatischer Abgleich nicht möglich ist (z.B. die GUID nicht erkannt wird oder das Element neu ist), können Sie einen manuellen Abgleich durchführen: 1. Wählen Sie das nicht abgeglichene Scan-Element im Viewer aus. 2. Klicken Sie auf **Mit BIM-Objekt abgleichen**. 3. Suchen Sie nach dem Ziel-BIM-Objekt nach Name, Typ oder GUID. 4. Bestätigen Sie den Abgleich. Manuelle Abgleiche werden im Prüfpfad zusammen mit dem Benutzer, der den Abgleich durchgeführt hat, aufgezeichnet. *** ## Klassifizierungsüberschreibung KI-Vorhersagen sind nicht immer perfekt. Die **Klassifizierungsüberschreibung**-Funktion ermöglicht es autorisierten Stakeholdern, eine KI-zugewiesene Klassifizierung zu korrigieren. ### Wie man eine Klassifizierung überschreibt 1. Wählen Sie das Element aus, dessen Klassifizierung Sie korrigieren möchten. 2. Klicken Sie im Detailpanel des Elements auf **Klassifizierung überschreiben**. 3. Wählen Sie den richtigen Elementtyp aus dem Dropdown (z.B. von "Möbel" zu "Ausrüstung" ändern). 4. Geben Sie eine **Notiz** ein, die den Korrekturgrund erklärt. 5. Bestätigen Sie die Überschreibung. ### Prüfpfad Jede Klassifizierungsüberschreibung wird in einem vollständigen **Prüfpfad** aufgezeichnet, der erfasst: * Die ursprüngliche KI-Klassifizierung und den Konfidenzwert. * Die korrigierte Klassifizierung. * Die vom Prüfer angegebene Notiz. * Den Zeitstempel der Überschreibung. * Den Namen und die Rolle des Stakeholders, der die Überschreibung durchgeführt hat. Dies gewährleistet vollständige Rückverfolgbarkeit und Rechenschaftspflicht für alle manuellen Korrekturen. *** ## Vergleich Scan-Realität vs. BIM-Entwurf Eine der leistungsfähigsten Funktionen des Scan Viewers ist die Möglichkeit, die **gescannte physische Realität** mit dem **entworfenen BIM-Modell** zu vergleichen. ### Wie der Vergleich funktioniert Wenn sowohl ein Scan (E57) als auch ein BIM-Modell (IFC) für das Gebäude geladen sind, überlagert der Viewer beide Datensätze. Der Vergleich hebt hervor: * **Im BIM vorhandene, im Scan aber nicht erkannte Elemente** — Möglicherweise fehlend, noch nicht installiert oder verdeckt. * **Im Scan erkannte, aber nicht im BIM vorhandene Elemente** — Möglicherweise neue Elemente, nicht autorisierte Änderungen oder KI-Falschpositive. * **Positionsabweichungen** — Elemente, die in beiden vorhanden sind, aber räumlich zwischen Entwurf und Realität versetzt sind (z.B. eine Wand, die 5 cm von ihrer geplanten Position entfernt gebaut wurde). Dieser Vergleich ist unschätzbar für: * **Bauprogress-Tracking** — Überprüfen, welche geplanten Elemente physisch installiert wurden. * **Als-gebaut-Verifizierung** — Bestätigen, dass das fertige Gebäude dem genehmigten Entwurf entspricht. * **Wartungs- und Renovierungsplanung** — Diskrepanzen identifizieren, bevor Arbeiten beginnen. *** ## Scan-Elemente zu Gebäudemodelobjekten befördern Erkannte und validierte Scan-Elemente können zu **Gebäudemodelobjekten** befördert werden und treten damit in den standardmäßigen BIM-Anreicherungs-Workflow ein. ### Beförderungs-Workflow 1. Wählen Sie ein Scan-Element (oder mehrere Elemente) aus. 2. Überprüfen Sie seine KI-Klassifizierung und überschreiben Sie sie bei Bedarf. 3. Klicken Sie auf **Zum Gebäudemodelobjekt befördern**. 4. Das Element tritt als BIM-Objekt in den standardmäßigen Anreicherungs-Workflow ein. 5. Stakeholder können es nun mit Daten über alle 12 Datensektionen über den Initialisierungs-Assistenten oder das Objekt-Detailpanel des BIM 3D-Viewers anreichern. Beförderte Objekte werden im Abschnitt **Wertbeiträge** verfolgt und tragen zum Magma Index-Score des Gebäudes bei, sobald ihre Datenfelder validiert sind. *** ## Element-Detailpanel Das Klicken auf ein erkanntes Element im Viewer öffnet sein Detailpanel: | Eigenschaft | Beschreibung | | ------------------------ | ------------------------------------------------------------------------------------------ | | Elementtyp | KI-zugewiesene oder überschriebene Klassifizierung. | | Konfidenz | KI-Konfidenzwert (0–1). | | Magma-Ebene | Zugewiesene Ebene (S, A, W1–W5, F). | | Zentroid | X-, Y-, Z-Koordinaten. | | Begrenzungsrahmen | Abmessungen (Breite × Höhe × Tiefe). | | Planarität | Formmetrik (0–1). | | Linearität | Formmetrik (0–1). | | Sphärizität | Formmetrik (0–1). | | Punktanzahl | Anzahl der Scan-Punkte in diesem Element. | | Raumnummer | Erkannter Raum. | | Stockwerksebene | Erkanntes Stockwerk. | | IFC GUID | BIM-Objekt-GUID (falls abgeglichen). | | Abgeglichenes BIM-Objekt | Link zum entsprechenden BIM-Objekt (falls abgeglichen). | | Überschreibungshistorie | Liste vergangener Klassifizierungsüberschreibungen mit Notizen, Zeitstempeln und Akteuren. | *** ## Integration mit dem Data Room Die E57-Scan-Datei ist nicht nur im Scan Viewer anzeigbar — sie wird auch als Dokument an einer bestimmten Stelle im Data Room gespeichert: * **Dokument:** `2-006` * **Ebene:** Architecture Das bedeutet, dass die Scan-Datei am standardmäßigen Dokumentlebenszyklus teilnimmt: Sie kann validiert, versioniert, ersetzt und auf der Blockchain geminted werden, genau wie jedes andere Dokument im Data Room. Der Hash des Scan-Dokuments wird während des DTT-Mintings on-chain aufgezeichnet und liefert einen manipulationssicheren Nachweis der physischen Realität des Gebäudes zum Zeitpunkt des Scans. *** ## Tipps und Best Practices * Scannen Sie das Gebäude in mehreren Bauphasen, um den Fortschritt zu verfolgen und den Als-gebaut-Zustand zu erfassen, bevor Bereiche geschlossen werden (z.B. vor dem Verkleiden von Strukturelementen scannen). * Überprüfen Sie KI-Konfidenzwerte sorgfältig — Elemente mit einem Score unter **0,7** sind Kandidaten für manuelle Überprüfung und potenzielle Klassifizierungsüberschreibung. * Geben Sie beim Überschreiben einer Klassifizierung immer eine detaillierte Notiz ein — diese Dokumentation ist wertvoll für zukünftige Audits und Qualitätsüberprüfungen. * Verwenden Sie den **Scan-zu-BIM-Vergleich**, bevor Sie ein Renovierungs- oder Nachrüstprojekt beginnen, um sicherzustellen, dass das BIM-Modell den aktuellen Zustand des Gebäudes genau widerspiegelt. * Befördern Sie Scan-Elemente zu Gebäudemodelobjekten schrittweise — beginnen Sie mit strukturellen Elementen mit hoher Konfidenz und arbeiten Sie sich zu Einrichtungsgegenständen mit niedrigerer Konfidenz vor. --- # 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/de/funktionen/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.