| title | Converting ontologies |
|---|---|
| titleSuffix | Azure Digital Twins |
| description | Understand the process of converting industry-standard models into DTDL for Azure Digital Twins |
| author | baanders |
| ms.author | baanders |
| ms.date | 01/27/2025 |
| ms.topic | concept-article |
| ms.service | azure-digital-twins |
Most ontologies are based on semantic web standards such as OWL, RDF, and RDFS.
To use a model with Azure Digital Twins, it must be in DTDL format. This article describes general design guidance in the form of a conversion pattern for converting RDF-based models to DTDL so that they can be used with Azure Digital Twins.
The article also contains sample converter code for RDF and OWL converters, which can be extended for other schemas in the building industry.
Although the examples in this article are building-focused, you can apply similar processes to standard ontologies across different industries to convert them to DTDL as well.
There are several third-party libraries that can be used when converting RDF-based models to DTDL. Some of these libraries allow you to load your model file into a graph. You can loop through the graph looking for specific RDFS and OWL constructs, and convert them to DTDL.
The following table is an example of how RDFS and OWL constructs can be mapped to DTDL.
| RDFS/OWL concept | RDFS/OWL construct | DTDL concept | DTDL construct |
|---|---|---|---|
| Classes | owl:ClassIRI suffix rdfs:labelrdfs:comment |
Interface | @type:Interface@iddisplayNamecomment |
| Subclasses | owl:ClassIRI suffix rdfs:labelrdfs:commentrdfs:subClassOf |
Interface | @type:Interface@iddisplayNamecommentextends |
| Datatype Properties | owl:DatatypePropertyrdfs:label or INoderdfs:labelrdfs:range |
Interface Properties | @type:PropertynamedisplayNameschema |
| Object Properties | owl:ObjectPropertyrdfs:label or INoderdfs:rangerdfs:commentrdfs:label |
Relationship | type:Relationshipnametarget (or omitted if no rdfs:range)commentdisplayName |
The following C# code snippet shows how an RDF model file is loaded into a graph and converted to DTDL, using the dotNetRDF library.
:::code language="csharp" source="~/digital-twins-docs-samples/other/csharp/convertRDF.cs":::
This section contains sample converter code for RDF and OWL converters, which can be extended for other schemas in the building industry.
There's a sample application available that converts an RDF-based model file to DTDL Version 2 (v2). DTDL v2 is supported by Azure Digital Twins, but you can also follow these instructions afterwards to convert DTDL v2 models to the newer DTDL v3.
The sample application has been validated for the Brick schema and can be extended for other schemas in the building industry (such as Building Topology Ontology (BOT), Semantic Sensor Network, or buildingSmart Industry Foundation Classes (IFC)).
The sample is a .NET Core command-line application called RdfToDtdlConverter.
To download the code to your machine, select the Browse code button underneath the title on the sample page, which will take you to the GitHub repo for the sample. Select the Code button and Download ZIP to download the sample as a .zip file called RdfToDtdlConverter-main.zip. You can then unzip the file and explore the code.
:::image type="content" source="media/concepts-ontologies-convert/download-repo-zip.png" alt-text="Screenshot of the RdfToDtdlConverter repo on GitHub. The Code button is selected, producing a dialog box where the Download ZIP button is highlighted." lightbox="media/concepts-ontologies-convert/download-repo-zip.png":::
You can use this sample to see the conversion patterns in context, and to have as a building block for your own applications doing model conversions according to your own specific needs.
The OWL2DTDL Converter is a sample code base that translates an OWL ontology into a set of DTDL interface declarations, which can be used with the Azure Digital Twins service. It also works for ontology networks, made of one root ontology reusing other ontologies through owl:imports declarations. This converter was used to translate the Real Estate Core Ontology to DTDL and can be used for any OWL-based ontology.
This sample code isn't a comprehensive solution that supports the entirety of the OWL spec, but it can give you ideas and starting code that you can use in developing your own ontology ingestion pipelines.
Continue on the path for developing models based on ontologies: Full model development path.