README.md

Digitalbuildings Ontology

This section of the digitalbuildings tree contains configuration files and documentation for the digitalbuildings model.

The model is provided in the following file formats:

• A yaml version, which is the primary configuration source
• A RDF version that is generated from the yaml version using the RDF Generator

Documentation for the model can be found in the docs folder.

• Ontology Overview: provides an overview of the structure and first principles of the ontology
• Ontology Configuration: explains how to write and validate the .yaml configuration files
• Model: describes the conventions used in the provided abstract model
  • Model HVAC: specifically describes the application of the model in the HVAC namespace
    • AHU: example of the model applied to an air handling unit (AHU)
    • CHWS: example of the model applied to a chilled water system (CHWS)
    • FCU: example of the model applied to a fan coil unit (FCU)
    • HWS: example of the model applied to a heating water system (HWS)
• Building Configuration: describes the configuration format for mapping concrete assets to a model and validating the mapping
• Frequenty Asked Questions: centralized answers to frequently asked questions regarding the ontology

Learning Modules

The learning modules provide an overview of the following key concepts:

• The main concepts and components of the Digital Buildings Ontology
• How to model entities and extend types in the ontology
• The components of building configuration files
• How to use the validation tools for ontology extensions and building configuration files

Module 1: Digital Buildings Ontology (DBO)

In this module, you’ll fully explore the core modeling and organizational concepts of the DBO. These are essential concepts for data modeling and creating building configuration files.

• Lesson 1: Introduction to the DBO
• Lesson 2: Conceptual model
• Lesson 3: Subfields
• Lesson 4: Fields
• Lesson 5: States and multi-states
• Lesson 6: Entity types
• Lesson 7: Mappings
• Lesson 8: Connections
• Lesson 9: Namespaces

Module 2: Module 2: Data Modeling with the DBO

In this module, you’ll deepen your understanding of the DBO and practice applying it. Through several hands-on activities, you'll walk through the recommended workflow for creating a building configuration file

• Lesson 1: Get ready to data model
• Lesson 2: Determine which devices need to be modeled
• Lesson 3: Determine which data points are required
• Lesson 4: Name each data point using the DBO
• Lesson 5: Propose an ontology extension
• Lesson 6: Construct and finalize the building configuration file
• Lesson 7: Validate the instance and telemetry

Enjoy!