Skip to content

Ja. Sterker nog, ik denk dat we hem fundamenteel anders moeten schrijven.

Door jouw uitleg begrijp ik nu veel beter wat de rol van de JSON-transformatie is. Mijn eerste versie was nog te veel gebaseerd op een klassieke ETL-pipeline ("alles naar een canoniek model"). Dat is niet wat DAQS doet.

Ik zou de rode draad veranderen naar:

DAQS maakt geen kopie van een Revit-model; DAQS bouwt een analysemodel.

Dat is een heel ander verhaal.

Ik zou het hoofdstuk ongeveer als volgt opbouwen.

JSON Transformatie

Samenvatting

Revit bevat een enorme hoeveelheid informatie. Niet alle gegevens zijn relevant voor het beoordelen van de kwaliteit van bouwdata. Daarom extraheert DAQS uitsluitend de informatie die nodig is om analyses en validaties uit te voeren.

Deze informatie wordt vervolgens vastgelegd in een consistente JSON-structuur. Deze structuur vormt de interne analyse-representatie waarop alle volgende onderdelen van DAQS werken.

De JSON-structuur is daarmee geen volledige kopie van een Revit-project, maar een doelgerichte representatie van de gegevens die voor kwaliteitsanalyse relevant zijn.

Kernvraag

Waarom zet DAQS geëxtraheerde bouwdata om naar JSON?

Waarom dit belangrijk is

De Revit API is ontworpen om een BIM-model te beheren en te bewerken.

Voor kwaliteitsanalyse zijn echter andere eigenschappen belangrijk. Validatieregels willen snel kunnen bepalen:

  • welke objecten aanwezig zijn;
  • welke eigenschappen zij bevatten;
  • hoe objecten met elkaar zijn verbonden;
  • welke metadata beschikbaar is.

Rechtstreeks werken op de volledige Revit API zou iedere analyse afhankelijk maken van de interne datastructuur van Revit en onnodige complexiteit toevoegen.

Kernuitleg

Na de extractie wordt de geselecteerde informatie vastgelegd in een uniforme JSON-structuur.

Deze structuur bevat niet alle gegevens uit het model, maar uitsluitend de informatie die nodig is voor de analyses die DAQS ondersteunt.

In de loop van de ontwikkeling is deze structuur organisch gegroeid. Nieuwe validaties vroegen soms om aanvullende gegevens, waarna de extractie gericht werd uitgebreid. Ook klantvragen kunnen aanleiding zijn om nieuwe informatie beschikbaar te maken.

Hierdoor ontstaat een analysemodel dat voortdurend meegroeit met de mogelijkheden van het platform, zonder dat iedere analyse rechtstreeks afhankelijk is van de Revit API.

Voor iedere validatieregel vormt deze JSON-structuur het uitgangspunt.

Wat is JSON?

JSON (JavaScript Object Notation) is een veelgebruikt gegevensformaat om gestructureerde informatie op te slaan en uit te wisselen tussen softwaretoepassingen.

Je kunt JSON vergelijken met een digitale lijst waarin objecten en hun eigenschappen overzichtelijk zijn vastgelegd. Net zoals een spreadsheet gegevens in rijen en kolommen organiseert, organiseert JSON informatie in objecten met bijbehorende eigenschappen.

Voor DAQS is JSON geen uitwisselingsformaat voor eindgebruikers, maar een intern gegevensformaat waarmee bouwobjecten op een consistente manier kunnen worden verwerkt, geanalyseerd en gevalideerd.

Praktijkvoorbeeld

Een opdrachtgever wil controleren of alle brandscheidingen voldoen aan een nieuwe interne richtlijn.

Hiervoor blijkt aanvullende informatie nodig te zijn die nog niet in de bestaande extractie aanwezig is.

In plaats van de volledige extractie opnieuw te ontwerpen, wordt alleen de benodigde informatie toegevoegd aan de JSON-structuur. De nieuwe validatieregels kunnen vervolgens gebruikmaken van deze extra gegevens, terwijl bestaande analyses ongewijzigd blijven functioneren.

Daardoor groeit de analyse-representatie mee met nieuwe kwaliteitsvragen, zonder onnodige informatie op te nemen.

Belangrijkste inzichten

  • DAQS extraheert alleen relevante bouwdata.
  • JSON vormt de interne analyse-representatie.
  • De structuur is ontworpen voor validatie, niet voor modelleren.
  • Nieuwe informatie wordt alleen toegevoegd wanneer analyses daarom vragen.
  • De JSON-structuur evolueert samen met het platform.

Belangrijk om te onthouden

De JSON-structuur binnen DAQS is geen digitale kopie van een Revit-model, maar een zorgvuldig opgebouwde analyse-representatie van de bouwdata die nodig is om kwaliteit objectief te beoordelen.