# bhom/bhom architecture

> Architecture diagram of the GitHub repository bhom/bhom, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bhom/bhom
- Repository: https://github.com/bhom/bhom

## Overview

BHoM Core is a collection of object-model definitions: a shared base for simple, extensible objects plus domain-specific schemas spanning engineering, the built environment, geometry, data, and computing. The principal workflow is that a model author creates and composes these objects, which provide a common language for downstream BHoM toolkits to consume. The sampled source confirms fragment storage and examples of domain metadata; it does not establish detailed runtime pipelines between the many domain modules, so those links are omitted.

Main entry points: [`BHoM/BHoMObject.cs`](https://github.com/bhom/bhom/blob/develop/BHoM/BHoMObject.cs) (BHoM objects), [`Geometry_oM`](https://github.com/bhom/bhom/tree/develop/Geometry_oM) (Geometry primitives), [`Environment_oM/Elements`](https://github.com/bhom/bhom/tree/develop/Environment_oM/Elements) (Environment models), [`Architecture_oM/Elements`](https://github.com/bhom/bhom/tree/develop/Architecture_oM/Elements) (Architecture models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core object model"]
  node_base["BHoM objects<br/>[BHoMObject.cs]"]
  node_fragments["Extensible fragments<br/>[FragmentSet.cs]"]
  node_attributes["Object metadata"]
end

subgraph group_built["Built environment"]
  node_geometry["Geometry primitives"]
  node_environment["Environment models"]
  node_architecture["Architecture models"]
  node_facade["Facade models"]
end

subgraph group_engineering["Engineering domains"]
  node_analytical["Analytical models"]
  node_acoustic["Acoustic models"]
  node_mep["MEP models"]
  node_ground["Ground models"]
  node_physical["Physical models"]
end

subgraph group_computation["Computation and data"]
  node_data["Data structures"]
  node_deeplearning["Deep learning"]
  node_diffing["Diffing and revisions"]
  node_graphics["Graphics and views"]
end

subgraph group_extensions["Other domains"]
  node_lca["Life-cycle assessment"]
  node_humans["Human models"]
  node_inspection["Inspection models"]
  node_planning["Planning models"]
end

node_author(("Model author"))
node_toolkits["BHoM toolkits"]

node_author -->|"creates"| node_base
node_author -->|"creates"| node_geometry
node_author -->|"creates"| node_environment
node_author -->|"creates"| node_architecture
node_author -->|"creates"| node_facade
node_author -->|"creates"| node_analytical
node_author -->|"creates"| node_acoustic
node_author -->|"creates"| node_mep
node_author -->|"creates"| node_ground
node_author -->|"creates"| node_physical
node_author -->|"creates"| node_data
node_author -->|"creates"| node_deeplearning
node_author -->|"creates"| node_diffing
node_author -->|"creates"| node_graphics
node_author -->|"creates"| node_lca
node_author -->|"creates"| node_humans
node_author -->|"creates"| node_inspection
node_author -->|"creates"| node_planning
node_base -->|"stores extensions"| node_fragments
node_base -->|"uses metadata"| node_attributes
node_base -->|"shared model language"| node_toolkits
node_geometry -->|"shared model language"| node_toolkits
node_environment -->|"shared model language"| node_toolkits
node_architecture -->|"shared model language"| node_toolkits
node_facade -->|"shared model language"| node_toolkits
node_analytical -->|"shared model language"| node_toolkits
node_acoustic -->|"shared model language"| node_toolkits
node_mep -->|"shared model language"| node_toolkits
node_ground -->|"shared model language"| node_toolkits
node_physical -->|"shared model language"| node_toolkits
node_data -->|"shared model language"| node_toolkits
node_deeplearning -->|"shared model language"| node_toolkits
node_diffing -->|"shared model language"| node_toolkits
node_graphics -->|"shared model language"| node_toolkits
node_lca -->|"shared model language"| node_toolkits
node_humans -->|"shared model language"| node_toolkits
node_inspection -->|"shared model language"| node_toolkits
node_planning -->|"shared model language"| node_toolkits

click node_base "https://github.com/bhom/bhom/blob/develop/BHoM/BHoMObject.cs"
click node_fragments "https://github.com/bhom/bhom/blob/develop/BHoM/FragmentSet.cs"
click node_attributes "https://github.com/bhom/bhom/tree/develop/BHoM/Attributes"
click node_geometry "https://github.com/bhom/bhom/tree/develop/Geometry_oM"
click node_environment "https://github.com/bhom/bhom/tree/develop/Environment_oM/Elements"
click node_architecture "https://github.com/bhom/bhom/tree/develop/Architecture_oM/Elements"
click node_facade "https://github.com/bhom/bhom/tree/develop/Facade_oM/Elements"
click node_analytical "https://github.com/bhom/bhom/tree/develop/Analytical_oM"
click node_acoustic "https://github.com/bhom/bhom/tree/develop/Acoustic_oM"
click node_mep "https://github.com/bhom/bhom/tree/develop/MEP_oM"
click node_ground "https://github.com/bhom/bhom/tree/develop/Ground_oM"
click node_physical "https://github.com/bhom/bhom/tree/develop/Physical_oM"
click node_data "https://github.com/bhom/bhom/tree/develop/Data_oM"
click node_deeplearning "https://github.com/bhom/bhom/tree/develop/DeepLearning_oM"
click node_diffing "https://github.com/bhom/bhom/tree/develop/Diffing_oM"
click node_graphics "https://github.com/bhom/bhom/tree/develop/Graphics_oM"
click node_lca "https://github.com/bhom/bhom/tree/develop/LifeCycleAssessment_oM"
click node_humans "https://github.com/bhom/bhom/tree/develop/Humans_oM"
click node_inspection "https://github.com/bhom/bhom/tree/develop/Inspection_oM"
click node_planning "https://github.com/bhom/bhom/tree/develop/Planning_oM"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_base,node_fragments,node_attributes toneBlue
class node_geometry,node_environment,node_architecture,node_facade toneAmber
class node_analytical,node_acoustic,node_mep,node_ground,node_physical toneMint
class node_data,node_deeplearning,node_diffing,node_graphics toneRose
class node_lca,node_humans,node_inspection,node_planning,node_author,node_toolkits toneIndigo
```

## Components

### Core object model

- [BHoM objects](https://github.com/bhom/bhom/blob/develop/BHoM/BHoMObject.cs): `BHoM/BHoMObject.cs`
- [Extensible fragments](https://github.com/bhom/bhom/blob/develop/BHoM/FragmentSet.cs): `BHoM/FragmentSet.cs`
- [Object metadata](https://github.com/bhom/bhom/tree/develop/BHoM/Attributes): `BHoM/Attributes`

### Built environment

- [Geometry primitives](https://github.com/bhom/bhom/tree/develop/Geometry_oM): `Geometry_oM`
- [Environment models](https://github.com/bhom/bhom/tree/develop/Environment_oM/Elements): `Environment_oM/Elements`
- [Architecture models](https://github.com/bhom/bhom/tree/develop/Architecture_oM/Elements): `Architecture_oM/Elements`
- [Facade models](https://github.com/bhom/bhom/tree/develop/Facade_oM/Elements): `Facade_oM/Elements`

### Engineering domains

- [Analytical models](https://github.com/bhom/bhom/tree/develop/Analytical_oM): `Analytical_oM`
- [Acoustic models](https://github.com/bhom/bhom/tree/develop/Acoustic_oM): `Acoustic_oM`
- [MEP models](https://github.com/bhom/bhom/tree/develop/MEP_oM): `MEP_oM`
- [Ground models](https://github.com/bhom/bhom/tree/develop/Ground_oM): `Ground_oM`
- [Physical models](https://github.com/bhom/bhom/tree/develop/Physical_oM): `Physical_oM`

### Computation and data

- [Data structures](https://github.com/bhom/bhom/tree/develop/Data_oM): `Data_oM`
- [Deep learning](https://github.com/bhom/bhom/tree/develop/DeepLearning_oM): `DeepLearning_oM`
- [Diffing and revisions](https://github.com/bhom/bhom/tree/develop/Diffing_oM): `Diffing_oM`
- [Graphics and views](https://github.com/bhom/bhom/tree/develop/Graphics_oM): `Graphics_oM`

### Other domains

- [Life-cycle assessment](https://github.com/bhom/bhom/tree/develop/LifeCycleAssessment_oM): `LifeCycleAssessment_oM`
- [Human models](https://github.com/bhom/bhom/tree/develop/Humans_oM): `Humans_oM`
- [Inspection models](https://github.com/bhom/bhom/tree/develop/Inspection_oM): `Inspection_oM`
- [Planning models](https://github.com/bhom/bhom/tree/develop/Planning_oM): `Planning_oM`

### Other components

- **Model author**
- **BHoM toolkits**

## Connections

- Model author → BHoM objects: creates
- Model author → Geometry primitives: creates
- Model author → Environment models: creates
- Model author → Architecture models: creates
- Model author → Facade models: creates
- Model author → Analytical models: creates
- Model author → Acoustic models: creates
- Model author → MEP models: creates
- Model author → Ground models: creates
- Model author → Physical models: creates
- Model author → Data structures: creates
- Model author → Deep learning: creates
- Model author → Diffing and revisions: creates
- Model author → Graphics and views: creates
- Model author → Life-cycle assessment: creates
- Model author → Human models: creates
- Model author → Inspection models: creates
- Model author → Planning models: creates
- BHoM objects → Extensible fragments: stores extensions
- BHoM objects → Object metadata: uses metadata
- BHoM objects → BHoM toolkits: shared model language
- Geometry primitives → BHoM toolkits: shared model language
- Environment models → BHoM toolkits: shared model language
- Architecture models → BHoM toolkits: shared model language
- Facade models → BHoM toolkits: shared model language
- Analytical models → BHoM toolkits: shared model language
- Acoustic models → BHoM toolkits: shared model language
- MEP models → BHoM toolkits: shared model language
- Ground models → BHoM toolkits: shared model language
- Physical models → BHoM toolkits: shared model language
- Data structures → BHoM toolkits: shared model language
- Deep learning → BHoM toolkits: shared model language
- Diffing and revisions → BHoM toolkits: shared model language
- Graphics and views → BHoM toolkits: shared model language
- Life-cycle assessment → BHoM toolkits: shared model language
- Human models → BHoM toolkits: shared model language
- Inspection models → BHoM toolkits: shared model language
- Planning models → BHoM toolkits: shared model language
