Semantic bSDD

Improving the GraphQL, JSON and RDF Representations of buildingSmart Data Dictionary

Vladimir Alexiev, Mihail Radkov, Nataliya Keberle

The buildingSmart Data Dictionary (bSDD) is an important shared resource in the Architecture, Engineering, Construction, and Operations (AECO) domain. It is a collection of datasets (“domains”) that define various classifications (objects representing building components, products, and materials), their properties, allowed values, etc. bSDD defines a GraphQL API, as well as REST APIs that return JSON and RDF representations. This improves the interoperability of bSDD and its easier deployment in architectural Computer Aided Design (CAD) and other AECO software.

However, bSDD data is not structured as well as possible, and data retrieved via different APIs is not identical in content and structure. This lowers bSDD data quality, usability and trust.

We conduct a thorough comparison and analysis of bSDD data related to fulfillment of FAIR (findable, accessible, interoperable, and reusable) principles. Based on this analysis, we suggest enhancements to make bSDD data better structured and more FAIR.

We implement many of the suggestions by refactoring the original data to make it better structured/interconnected, and more “semantic”. We provide a SPARQL endpoint using Ontotext GraphDB, and GraphQL endpoint using Ontotext Platform Semantic Objects.

This home page: schemas, data, sample queries
Technical work (open source): scripts to get and refactor data, obtain GraphQL schema, generate and refactor SOML
Detailed description of the work we did, 40 pages
new README.html new README: left navigation pane, but some minor typographic problems
Accepted at 11th Linked Data in Architecture and Construction Workshop (LDAC 2023), 15-16 June 2023
presentation: html, pdf, pptx
Presentation at LDAC 2023, 15 June 2023
Webinars: video, transcript (if important, ask us to edit it), brief notes * 24 Mar 2023 to ACCORD (17 participants from universities and industry, ACCORD project and external)
* 26 Apr 2023 to bSI (4 participants, including 2 from buildingSMART International)
* 15 May 2023 to W3C Linked Building Data CG (20 participants from universities and industry)
* 26 May 2023, Natural Language Querying with ChatGPT, SOML, and GraphQL Ontotext Last Friday presentation (40 participants from Ontotext)
* LDAC BSDD session We’re looking forward to see you at that session, and please vote for the topics to be discussed!
Discussion at bSI forum: please contribute! * Changes to bSDD data model names
* bSDD schema diagrams
* Semantic bSDD
Refactored Endpoints
Voyager Refactored
Refactored GraphQL schema visualization with Voyager
PlantUML Overview Diagram: png or svg
PlantUML Full Diagram: png or svg
Differences between original and refactored schema (as SOML)
Semantic Objects workbench: administrative interface for the Ontotext Platform implementing GraphQL (protected)
Refactored GraphQL endpoint
Refactored GraphQL query editor
GraphDB Workbench: administrative interface for our semantic database
GraphDB SPARQL endpoint
GraphDB SPARQL editor
Visual Graph visualizations
Original Endpoints
Voyager Original
Original GraphQL schema visualization with Voyager
Analysis Sheet
Analysis of differences between GraphQL, JSON and RDF representations
Original GraphQL endpoint
Original GraphQL query editor
Developed by Ontotext (Sirma AI)
Funded by Horizon Europe Project ACCORD (101056973)
Powered by Ontotext GraphDB
Powered by Ontotext Platform Semantic Objects
Data from buildingSMART Data Dictionary