# Visionneuse de scan

Le Scan Viewer vous permet de visualiser, analyser et extraire des données de bâtiment à partir de scans 3D en nuage de points capturés sur site. Il fait le lien entre la réalité physique et le modèle numérique du bâtiment en utilisant la segmentation par intelligence artificielle pour identifier les éléments constructifs, les associer aux objets BIM et les intégrer dans le flux d'enrichissement standard de Magma.

***

## Vue d'ensemble

Les scans en nuage de points (format E57) capturent la réalité physique d'un bâtiment à un instant précis. Le Scan Viewer vous permet de :

* Explorer le scan en 3D.
* Consulter les éléments détectés par l'IA et leurs classifications.
* Comparer la réalité scannée avec le modèle BIM de conception.
* Corriger les classifications attribuées par l'IA si nécessaire.
* Promouvoir les éléments scannés en objets du modèle de bâtiment pour enrichissement dans le flux de travail BIM.

***

## Accéder au Scan Viewer

Le Scan Viewer est accessible de deux façons :

1. Depuis la **Data Room** — Naviguez jusqu'à un sous-dossier IFC et cliquez sur **Ouvrir dans Scan**.
2. Depuis l'entrée du document de scan (document **2-006** au niveau Architecture), qui stocke le fichier E57.

Le visualiseur est intégré via le **Magma Scan Viewer SDK** (`magma-scan-viewer-sdk`) sous forme d'iframe. Le jeton d'authentification est automatiquement renouvelé **30 secondes avant son expiration**, de sorte que votre session reste active lors de longues sessions de révision sans nécessiter de reconnexion manuelle.

***

## Format de fichier pris en charge

| Propriété         | Valeur                                                                                                   |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| Format de fichier | E57 (ASTM E57 3D Imaging Data Exchange)                                                                  |
| Stockage          | Le fichier E57 est également stocké sous le document **2-006** au niveau Architecture dans la Data Room. |

***

## Segmentation par IA

Lorsqu'un scan est chargé, le Scan Viewer exécute automatiquement la segmentation par IA sur les données du nuage de points pour détecter et classifier les éléments constructifs.

### Types d'éléments détectés

L'IA identifie les catégories d'éléments suivantes et les associe aux niveaux Magma correspondants :

| Élément détecté par l'IA                      | Niveau associé       |
| --------------------------------------------- | -------------------- |
| Plafond, Sol, Mur, Poutre, Colonne, Escaliers | **Structure (S)**    |
| Fenêtre, Porte                                | **Architecture (A)** |
| Table, Chaise, Canapé, Bibliothèque           | **Filled (F) / W1**  |
| Mobilier (général)                            | **Wired 2 (W2)**     |
| Équipement                                    | **Wired 3 (W3)**     |

### Données par élément

Pour chaque élément détecté par l'IA, les données suivantes sont générées et stockées :

| Propriété               | Description                                                                                                                                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Score de confiance**  | Une valeur comprise entre 0 et 1 indiquant le niveau de certitude de l'IA dans sa classification. Plus la valeur est élevée, plus la certitude est grande.   |
| **Centroïde (x, y, z)** | Les coordonnées du point central de l'élément détecté dans l'espace 3D.                                                                                      |
| **Boîte englobante**    | La boîte englobante 3D minimale encadrant l'élément.                                                                                                         |
| **Métriques de forme**  | Trois descripteurs de forme : **planarité** (à quel point c'est plat), **linéarité** (à quel point c'est allongé), **sphéricité** (à quel point c'est rond). |
| **Nombre de points**    | Nombre de points du nuage de points appartenant à cet élément.                                                                                               |
| **Numéro de pièce**     | La pièce dans laquelle l'élément a été détecté.                                                                                                              |
| **Niveau d'étage**      | L'étage sur lequel l'élément est situé.                                                                                                                      |
| **IFC GUID**            | Si l'élément correspond à un objet BIM, le IFC GUID de cet objet est enregistré ici.                                                                         |

***

## Correspondance Scan-vers-BIM

Le Scan Viewer inclut une fonctionnalité de **correspondance Scan-vers-BIM** qui aligne les éléments scannés détectés avec leurs objets correspondants dans le modèle 3D BIM.

### Correspondance automatique

La correspondance est effectuée automatiquement à l'aide du **IFC GUID**. Lorsque la détection par IA assigne un IFC GUID à un élément scanné, le système recherche ce GUID dans le modèle BIM et crée un lien entre l'élément physique scanné et son équivalent numérique BIM.

### Correspondance manuelle

Lorsque la correspondance automatique n'est pas possible (par exemple, le GUID n'est pas détecté ou l'élément est nouveau), vous pouvez effectuer une correspondance manuelle :

1. Sélectionnez l'élément scanné sans correspondance dans le visualiseur.
2. Cliquez sur **Associer à l'objet BIM**.
3. Recherchez l'objet BIM cible par nom, type ou GUID.
4. Confirmez la correspondance.

Les correspondances manuelles sont enregistrées dans la piste d'audit avec l'identité de l'utilisateur ayant effectué l'association.

***

## Correction de classification

Les prédictions de l'IA ne sont pas toujours parfaites. La fonctionnalité de **correction de classification** permet aux parties prenantes autorisées de rectifier une classification attribuée par l'IA.

### Comment corriger une classification

1. Sélectionnez l'élément dont vous souhaitez corriger la classification.
2. Dans le panneau de détail de l'élément, cliquez sur **Corriger la classification**.
3. Sélectionnez le type d'élément correct dans le menu déroulant (par exemple, changer de « Mobilier » à « Équipement »).
4. Saisissez une **note** expliquant la raison de la correction.
5. Confirmez la correction.

### Piste d'audit

Chaque correction de classification est enregistrée dans une **piste d'audit** complète qui capture :

* La classification originale de l'IA et le score de confiance.
* La classification corrigée.
* La note fournie par le réviseur.
* L'horodatage de la correction.
* Le nom et le rôle de la partie prenante ayant effectué la correction.

Cela garantit une traçabilité et une imputabilité totales pour toutes les corrections manuelles.

***

## Comparaison réalité scannée vs. conception BIM

L'une des fonctionnalités les plus puissantes du Scan Viewer est la capacité de comparer la **réalité physique scannée** avec le **modèle BIM conçu**.

### Fonctionnement de la comparaison

Lorsqu'un scan (E57) et un modèle BIM (IFC) sont tous deux chargés pour le bâtiment, le visualiseur superpose les deux jeux de données. La comparaison met en évidence :

* **Les éléments présents dans le BIM mais non détectés dans le scan** — Peut-être absents, pas encore installés ou cachés.
* **Les éléments détectés dans le scan mais absents du BIM** — Peut-être de nouveaux éléments, des modifications non autorisées ou des faux positifs de l'IA.
* **Les écarts de position** — Des éléments qui existent dans les deux mais sont décalés spatialement entre la conception et la réalité (par exemple, un mur construit à 5 cm de sa position conçue).

Cette comparaison est indispensable pour :

* **Le suivi de l'avancement des travaux** — Vérifier quels éléments conçus ont été physiquement installés.
* **La vérification de la conformité** — Confirmer que le bâtiment terminé correspond à la conception approuvée.
* **La planification de la maintenance et des rénovations** — Identifier les écarts avant de commencer les travaux.

***

## Promotion des éléments scannés en objets du modèle de bâtiment

Les éléments scannés détectés et validés peuvent être promus en **objets du modèle de bâtiment**, les intégrant dans le flux d'enrichissement BIM standard.

### Flux de promotion

1. Sélectionnez un élément scanné (ou plusieurs éléments).
2. Vérifiez sa classification par l'IA et corrigez-la si nécessaire.
3. Cliquez sur **Promouvoir en objet du modèle de bâtiment**.
4. L'élément entre dans le flux d'enrichissement standard en tant qu'objet BIM.
5. Les parties prenantes peuvent désormais l'enrichir avec des données dans les 12 sections de données via l'assistant d'initialisation du BIM 3D Viewer ou le panneau de détail de l'objet.

Les objets promus sont suivis dans la section **Contributions de valeur** et contribuent au score Magma Index du bâtiment une fois leurs champs de données validés.

***

## Panneau de détail de l'élément

Cliquer sur un élément détecté dans le visualiseur ouvre son panneau de détail :

| Propriété                  | Description                                                                         |
| -------------------------- | ----------------------------------------------------------------------------------- |
| Type d'élément             | Classification attribuée par l'IA ou corrigée.                                      |
| Confiance                  | Score de confiance de l'IA (0–1).                                                   |
| Niveau Magma               | Niveau assigné (S, A, W1–W5, F).                                                    |
| Centroïde                  | Coordonnées X, Y, Z.                                                                |
| Boîte englobante           | Dimensions (largeur × hauteur × profondeur).                                        |
| Planarité                  | Métrique de forme (0–1).                                                            |
| Linéarité                  | Métrique de forme (0–1).                                                            |
| Sphéricité                 | Métrique de forme (0–1).                                                            |
| Nombre de points           | Nombre de points du scan dans cet élément.                                          |
| Numéro de pièce            | Pièce détectée.                                                                     |
| Niveau d'étage             | Étage détecté.                                                                      |
| IFC GUID                   | GUID de l'objet BIM (si associé).                                                   |
| Objet BIM associé          | Lien vers l'objet BIM correspondant (si associé).                                   |
| Historique des corrections | Liste des corrections de classification passées avec notes, horodatages et acteurs. |

***

## Intégration avec la Data Room

Le fichier de scan E57 n'est pas seulement consultable dans le Scan Viewer — il est également stocké en tant que document à un emplacement spécifique dans la Data Room :

* **Document :** `2-006`
* **Niveau :** Architecture

Cela signifie que le fichier de scan participe au cycle de vie standard des documents : il peut être validé, versionné, remplacé et minté sur la blockchain comme n'importe quel autre document dans la Data Room. Le hachage du document de scan est enregistré sur la chaîne lors du minting DTT®, fournissant un enregistrement infalsifiable de la réalité physique du bâtiment au moment du scan.

***

## Conseils et bonnes pratiques

* Scannez le bâtiment à plusieurs étapes de la construction pour suivre l'avancement et capturer les conditions telles que construites avant que des zones ne soient fermées (par exemple, scannez avant que le bardage ne dissimule les éléments structurels).
* Examinez attentivement les scores de confiance de l'IA — les éléments avec un score inférieur à **0,7** sont des candidats à la révision manuelle et à une éventuelle correction de classification.
* Saisissez toujours une note détaillée lors de la correction d'une classification — cette documentation est précieuse pour les audits futurs et les revues qualité.
* Utilisez la **comparaison Scan-vers-BIM** avant de commencer tout projet de rénovation ou de réhabilitation pour vous assurer que le modèle BIM reflète fidèlement l'état actuel du bâtiment.
* Promouvez les éléments scannés en objets du modèle de bâtiment progressivement — commencez par les éléments structurels à haute confiance et descendez vers les éléments de mobilier à confiance moindre.


---

# 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/fr/fonctionnalites/scan-viewer.md?ask=<question>
```

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.
