# BIM 3D-viewer

De BIM 3D Viewer biedt een interactieve driedimensionale visualisatie van het IFC-model (Industry Foundation Classes) van uw gebouw. Aangedreven door **Speckle** stelt het stakeholders in staat om de geometrie van het gebouw te verkennen, afzonderlijke objecten te inspecteren, gestructureerde datavelden te beheren en samen te werken aan dataverrijking — allemaal binnen het Magma-platform.

***

## Toegang tot de BIM 3D Viewer

De BIM 3D Viewer is op twee manieren toegankelijk:

1. Vanuit de **Data Room** — Navigeer naar een IFC-submap en klik op **Open in BIM**.
2. Vanuit de **hoofdnavigatie van het gebouw** — Klik op het tabblad **3D Model** of **BIM** in het gebouwmenu.

***

## Ondersteund bestandsformaat en limieten

| Eigenschap               | Waarde                                                                                              |
| ------------------------ | --------------------------------------------------------------------------------------------------- |
| Bestandsformaat          | IFC (Industry Foundation Classes)                                                                   |
| Maximale bestandsgrootte | Tot 10 GB per IFC-bestand                                                                           |
| Uploadmethode            | Gesegmenteerde upload (grote bestanden worden opgesplitst in segmenten voor betrouwbare overdracht) |

***

## Magma Gebouwniveaus

De BIM 3D Viewer organiseert gebouwdata over 7 hiërarchische niveaus, elk overeenkomend met een discipline of laag van het gebouw:

| Code | Niveau                           | Beschrijving                                                           |
| ---- | -------------------------------- | ---------------------------------------------------------------------- |
| S    | Structure                        | Constructieve elementen (kolommen, balken, vloeren, funderingen).      |
| A    | Architecture                     | Architectonische elementen (wanden, deuren, ramen, plafonds, vloeren). |
| W1   | Wired 1 — Mechanisch             | HVAC-systemen, ventilatie, airconditioning.                            |
| W2   | Wired 2 — Sanitair               | Sanitaire systemen, watertoevoer, afvoer.                              |
| W3   | Wired 3 — Verlichting            | Elektrische systemen, verlichtingsarmaturen, stroomdistributie.        |
| W4   | Wired 4 — Apparaten & Toestellen | Geïnstalleerde apparaten, toestellen, uitrusting.                      |
| W5   | Wired 5 — Leven & Veiligheid     | Brandveiligheid, beveiligingssystemen, noodsystemen.                   |
| F    | Filled                           | Interieurontwerp, meubilair, niet-constructieve afwerkingselementen.   |

> **Belangrijk:** **Genesis** is GEEN BIM-niveau. Genesis-documenten (eigendom, juridisch, financieel) bestaan alleen in de Data Room en worden niet weergegeven in het 3D-model.

***

## Objectdatastructuur

Elk object in het BIM-model kan gestructureerde data opslaan die is georganiseerd in 12 secties:

| Sectie                         | Beschrijving                                                                      |
| ------------------------------ | --------------------------------------------------------------------------------- |
| **INDEX\_LEVEL**               | Het Magma-niveau waartoe dit object behoort (S, A, W1–W5, F).                     |
| **OBJECT\_IDENTIFICATION**     | Naam, IFC GUID, objecttype en unieke identificatoren.                             |
| **OBJECT\_CREATION**           | Fabrikant, merk, modelreferentie, serienummer, installatiedatum.                  |
| **SPATIAL\_DATA**              | Verdiepingsniveau, ruimte, zone, coördinaten, afmetingen.                         |
| **CONDITION\_ASSESSMENT**      | Huidige toestandsbeoordeling, inspectieopmerkingen, onderhoudsgeschiedenis.       |
| **COMPLIANCE**                 | Certificeringen, naleving van normen, wettelijke goedkeuringen.                   |
| **LIFECYCLE\_DATA**            | Garantie-informatie, verwachte levensduur, vervangingsschema.                     |
| **SMART\_DATA**                | IoT-sensoridentificatoren, verbonden apparaten, koppelingen naar slimgebouwdata.  |
| **CONTRACT\_AND\_MAINTENANCE** | Onderhoudscontracten, dienstverleners, SLA-details.                               |
| **FINANCIAL\_DATA**            | Aankoopkosten, huidige waarde, afschrijving, verzekeringswaarde.                  |
| **OBJECT\_LIVE\_DATA**         | Realtime datafeeds (sensormetingen, operationele status).                         |
| **ADVANCED\_DATA**             | Aangepaste of gespecialiseerde velden die niet door andere secties worden gedekt. |

### Veldtypen

Velden binnen elke sectie zijn getypeerd:

| Type        | Beschrijving                                       |
| ----------- | -------------------------------------------------- |
| **TEXT**    | Vrije tekststring.                                 |
| **NUMBER**  | Decimale numerieke waarde.                         |
| **INTEGER** | Geheel getal.                                      |
| **BOOLEAN** | Waar/onwaar-schakelaar.                            |
| **FILE**    | Bestandsbijlage (document, afbeelding, PDF).       |
| **SELECT**  | Vervolgkeuzelijst met vooraf gedefinieerde opties. |

***

## Objectdetailpaneel

Als u op een object in de 3D-viewer klikt, opent het **Objectdetailpaneel** aan de rechterzijde van het scherm. Dit paneel is georganiseerd in tabbladen:

### Tabblad OVERVIEW

Een samenvatting van de belangrijkste identificerende informatie van het object:

* Objectnaam en -type
* IFC GUID
* Magma-niveautoewijzing
* Huidige score voor datavolledigheid

### Tabblad BIM\_DATA

De primaire interface voor gegevensinvoer en -weergave, georganiseerd in subtabbladen:

| Subtabblad        | Inhoud                                                                               |
| ----------------- | ------------------------------------------------------------------------------------ |
| **Basic**         | Kernvelden uit OBJECT\_IDENTIFICATION, SPATIAL\_DATA en andere fundamentele secties. |
| **Smart Queries** | Geavanceerde query's die berekende of afgeleide data uit meerdere secties ophalen.   |
| **Live Basic**    | OBJECT\_LIVE\_DATA-velden met realtime sensor- en operationele data.                 |
| **Advanced**      | ADVANCED\_DATA-sectievelden voor gespecialiseerde of aangepaste data.                |

### Tabblad BIM\_ORIGINAL\_DATA

Geeft de onbewerkte, niet-verwerkte eigenschappen weer die rechtstreeks uit het originele IFC-bestand zijn geëxtraheerd zoals geüpload. Dit zijn de brondata vóór Magma-verrijking. Nuttig voor kruisverwijzingen tussen wat in het originele model stond en wat via het platform is toegevoegd.

### Tabblad CF\_DATA

Contract- en financiële data, georganiseerd in twee subtabbladen:

| Subtabblad    | Inhoud                                                                           |
| ------------- | -------------------------------------------------------------------------------- |
| **Contract**  | CONTRACT\_AND\_MAINTENANCE-sectievelden (servicecontracten, onderhoudsschema's). |
| **Financial** | FINANCIAL\_DATA-sectievelden (kosten, waarden, afschrijving).                    |

***

## Zijpaneel

De viewer bevat een inklapbaar zijpaneel aan de linkerzijde van het scherm:

* **Selectie verbergen / tonen** (oogpictogram) — Schakel de zichtbaarheid van de momenteel geselecteerde objecten in de 3D-scène in of uit.
* **Isoleren / Deisoleren** (filterpictogram) — Isoleer het/de geselecteerde object(en) zodat alle andere geometrie transparant of verborgen wordt, zodat u zich op een specifiek element kunt concentreren.
* Het zijpaneel is **aanpasbaar in grootte** — sleep de scheidingslijn om de breedte aan te passen.

***

## Viewer-hulpmiddelen

De werkbalk bovenaan of aan de zijkant van de viewer biedt toegang tot een reeks hulpmiddelen. Elk hulpmiddel is ook toegankelijk via een sneltoets:

### Weergaven (Alt + Nummer)

Schakel tussen vooraf ingestelde cameraweergaven:

| Sneltoets | Weergave        |
| --------- | --------------- |
| Alt+1     | Bovenaanzicht   |
| Alt+2     | Vooraanzicht    |
| Alt+3     | Linkeraanzicht  |
| Alt+4     | Achteraanzicht  |
| Alt+5     | Rechteraanzicht |

### Weergavemodi (Shift + Nummer)

Verander de visuele weergavemodus van het model:

| Sneltoets | Modus     | Beschrijving                                                    |
| --------- | --------- | --------------------------------------------------------------- |
| Shift+1   | Standaard | Standaard gearceerde weergave.                                  |
| Shift+2   | Randen    | Draadframe-stijl randweergave.                                  |
| Shift+3   | Gearceerd | Vloeiend gearceerd zonder randen.                               |
| Shift+4   | Pen       | Gestileerde pen/inkt-weergave.                                  |
| Shift+5   | Arctic    | Minimale wit/lichte weergave voor overzichtelijke documentatie. |
| Shift+6   | Kleuren   | Kleurcodering op basis van objecttype.                          |

### Aanvullende hulpmiddelen (Shift + Letter)

| Sneltoets   | Hulpmiddel        | Beschrijving                                                                        |
| ----------- | ----------------- | ----------------------------------------------------------------------------------- |
| Shift+R     | Metingen          | Activeer het meetgereedschap.                                                       |
| Shift+F     | Verdiepingen      | Open de verdiepingsniveauselectie.                                                  |
| Shift+P     | Projectie         | Schakel tussen perspectief- en orthografische projectie.                            |
| Shift+B     | Sectiedoos        | Activeer een knipvlak om door het model te snijden en interne ruimtes te onthullen. |
| Shift+Space | Zoom aanpassen    | Zoom en pan om het gehele model in beeld te brengen.                                |
| Shift+M     | Modellen          | Open het modelbeheerhulpmiddel.                                                     |
| Shift+S     | Zoeken / Filteren | Open het zoek- en filterpaneel.                                                     |
| Shift+E     | Verkenner         | Open de objectverkenner (hiërarchieboom).                                           |
| Shift+N     | Meldingen         | Open het meldingenpaneel.                                                           |
| Shift+T     | Taken             | Open het Takenpaneel (toont het aantal taken als badge).                            |

***

## Meetgereedschap

Geactiveerd via **Shift+R**. Het meetgereedschap maakt nauwkeurige afstandsmeting mogelijk tussen punten in het 3D-model.

### Meettypen

| Type              | Beschrijving                                                                 |
| ----------------- | ---------------------------------------------------------------------------- |
| **Punt-tot-punt** | Klik op twee punten in het model om de rechte-lijnafstand ertussen te meten. |
| **Loodrecht**     | Meet de loodrechte afstand van een punt tot een oppervlak of rand.           |

### Magnetisch snappen

Het gereedschap snapt naar **objecthoekpunten** voor nauwkeurige meting, zodat u exacte rand-tot-rand- of hoek-tot-hoekafstanden vastlegt.

### Eenheden

Metingen kunnen worden weergegeven in elk van de volgende eenheden, te selecteren via de gereedschapsopties:

`mm` | `cm` | `m` | `km` | `in` | `ft` | `yd` | `mi`

***

## Modellengereedschap (Shift+M)

Het Modellengereedschap beheert de IFC-bestanden die in de viewer zijn geladen.

### Een nieuw IFC-bestand uploaden

1. Open het Modellengereedschap (Shift+M).
2. Klik op **Model uploaden**.
3. Selecteer uw IFC-bestand (tot 10 GB). Grote bestanden worden automatisch in segmenten geüpload.
4. Het model verschijnt in de lijst met de status **PENDING** en een voortgangsbalk.

### Modelverwerking statussen

| Status        | Beschrijving                                                            |
| ------------- | ----------------------------------------------------------------------- |
| **PENDING**   | Het bestand is geüpload en staat in de wachtrij voor verwerking.        |
| **FAILED**    | Verwerking is mislukt. Een knop **Opnieuw proberen** wordt weergegeven. |
| **AVAILABLE** | Verwerking is voltooid. Het model is geladen in de viewer.              |

### Een model verwijderen

Een model kan worden verwijderd als er meer dan één model is geladen. Klik op het verwijderpictogram (prullenbak) naast het model in de lijst. Verwijdering verwijdert de geometrie uit de viewer, maar heeft geen invloed op documenten die zijn opgeslagen in de Data Room.

***

## Stakeholdergereedschap

Het Stakeholdergereedschap, toegankelijk vanuit de BIM 3D Viewer, biedt volledige functionaliteit voor stakeholderbeheer zonder de viewercontext te verlaten. U kunt:

* De huidige stakeholderlijst met hun rollen bekijken.
* Nieuwe stakeholders uitnodigen.
* Bestaande stakeholderrollen wijzigen.
* Stakeholders verwijderen.

Dit weerspiegelt het volledige stakeholderbeheerpaneel dat beschikbaar is in de gebouwinstellingen.

***

## Filtergereedschap (Shift+S)

Filter welke objecten zichtbaar zijn in de 3D-scène op basis van hun BIM-veldwaarden.

### Hoe te filteren

1. Open het Filtergereedschap (Shift+S).
2. Selecteer een **veld** uit de vervolgkeuzelijst (uit een van de 12 datasecties).
3. Selecteer een **operator** (gelijk aan, bevat, groter dan, kleiner dan, enz.).
4. Voer een **waarde** in om op te filteren.
5. Klik op **Toepassen**.

Objecten die overeenkomen met het filter worden gemarkeerd of geïsoleerd in het viewport. Meerdere filters kunnen worden gecombineerd met AND/OR-logica.

***

## Initialisatiewizard

Voor nieuwe gebouwen of nieuw geüploade IFC-bestanden begeleidt de **Initialisatiewizard** u door de initiële gegevensinvoer voor alle 12 secties over alle objecten.

### Hoe het werkt

1. De wizard presenteert een **formulier per sectie** voor elk object (of groepen objecten).
2. Voor elke sectie vult u de relevante velden in.
3. De **Originele BIM Data-assistent** is beschikbaar als hulppaneel — het toont de onbewerkte IFC-eigenschappen die uit het geüploade bestand zijn geëxtraheerd, die **doorzoekbaar** zijn en kunnen worden gebruikt als referentie of rechtstreeks gekoppeld om formuliervelden in te vullen.
4. Een **WebSocket-voortgangsindicator** toont de realtime verwerkingsstatus terwijl de data wordt opgeslagen en gesynchroniseerd.

De wizard kan worden gepauzeerd en hervat. Gedeeltelijk ingevulde objecten worden automatisch opgeslagen.

***

## Workflow voor veldwijzigingsverzoeken

Wanneer een stakeholder een veldwaarde op een BIM-object wil wijzigen, dienen zij een **Veldwijzigingsverzoek** in in plaats van de waarde rechtstreeks te bewerken. Dit zorgt voor data-integriteit via een goedkeuringsproces door validators.

### Een wijzigingsverzoek indienen

1. Klik in het Objectdetailpaneel op **Bewerken** bij het veld dat u wilt wijzigen.
2. Voer de voorgestelde nieuwe waarde in.
3. Voeg een optionele notitie toe ter verklaring van de reden voor de wijziging.
4. Dien het verzoek in.

### Stemmen door validators

* Validators die aan het object of het niveau zijn toegewezen, worden op de hoogte gesteld van de aanstaande wijziging.
* Elke validator brengt een stem uit: **Goedkeuren** of **Afwijzen**.
* Een afwijzingsreden moet worden opgegeven bij afwijzing.
* **Alle toegewezen validators moeten goedkeuren** voordat de wijziging wordt doorgevoerd. Als **een validator afwijst**, wordt het wijzigingsverzoek geblokkeerd.

### Pop-up voor aanstaande wijzigingen

Validators zien een pop-up **Aanstaande wijzigingen** wanneer zij het betreffende object openen. Deze pop-up toont:

* **Huidige waarde** — De bestaande veldwaarde.
* **Voorgestelde waarde** — De gevraagde nieuwe waarde.
* **Stemstatus** — Wie heeft gestemd, wie staat nog open.
* **Goedkeuren** en **Afwijzen**-knoppen (met verplicht redenenveld voor afwijzing).

### Taakintegratie

Veldwijzigingsverzoeken genereren automatisch **VALIDATE\_3D\_MODEL\_FIELD**-taken, zichtbaar in het [Takenpaneel](/magma-documentation/nl/functies/tasks.md) (Shift+T).

***

## Directe koppelingen naar objecten

Elk object in de BIM-viewer kan rechtstreeks worden gekoppeld. De URL-parameter `?objectId=` toegevoegd aan de viewer-URL opent de viewer met dat specifieke object vooraf geselecteerd en gefocust.

**Voorbeeld:**

```
https://app.mymagma.com/buildings/[building-id]/bim?objectId=abc123
```

Deze koppeling kan worden gedeeld met stakeholders — klikken erop opent de viewer en selecteert het opgegeven object onmiddellijk. Directe koppelingen worden ook gebruikt door de functie [Waardebijdragen](/magma-documentation/nl/functies/value-contributions.md), waarbij het klikken op een 3D-modelobjectrij in de bijdragentabel de viewer opent bij dat exacte object.

***

## Tips en aanbevolen werkwijzen

* Gebruik **Shift+B (Sectiedoos)** om door wanden en vloeren te snijden bij het inspecteren van MEP-systemen (Mechanisch, Elektrisch, Sanitair) die verborgen zijn in de constructie.
* Gebruik **Shift+F (Verdiepingen)** om een enkel verdiepingsniveau te isoleren en visuele ruis te verminderen bij het werken aan interieure elementen.
* Het **Filtergereedschap** is krachtig voor kwaliteitscontrole — filter objecten op `CONDITION_ASSESSMENT`-velden om snel elementen in slechte staat te identificeren.
* Voltooi altijd de **Initialisatiewizard** voor nieuw geüploade modellen voordat u stakeholders uitnodigt om de data te beoordelen — onvolledige data verlaagt de Magma Index-score.
* Gebruik **directe koppelingen** (`?objectId=`) bij coördinatie met stakeholders in e-mails of taakomschrijvingen om hen naar het exacte object in kwestie te leiden.
* Upload meerdere discipline-specifieke IFC-bestanden (één per niveau: S, A, W1–W5, F) in plaats van één gecombineerd model voor betere prestaties en dataorganisatie.


---

# 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/bim-3d-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.
