# yang-mingsong/bimcompnet architecture

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

- Interactive diagram: https://gitdiagram.com/yang-mingsong/bimcompnet
- Repository: https://github.com/yang-mingsong/bimcompnet

## Overview

BIMCompNet combines IFC-derived dataset construction with multimodal geometric-learning benchmarks. The main workflow prepares and samples IFC/component data, loads graph, image, mesh, point-cloud, or voxel representations, then trains or validates the corresponding classifier. README-level pipeline stages are retained, but source evidence here does not establish their ordering or invocation links. The bundled CloudComPy runtime is a separate utility capability; details of the native bindings and many data encoders were not sampled.

Main entry points: [`main.py`](https://github.com/yang-mingsong/bimcompnet/blob/main/main.py) (Training orchestration), [`dataset_construction_pipeline`](https://github.com/yang-mingsong/bimcompnet/tree/main/dataset_construction_pipeline) (Dataset pipeline), [`data/custom_dataset.py`](https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py) (Dataset loaders), [`scripts/train.py`](https://github.com/yang-mingsong/bimcompnet/blob/main/scripts/train.py) (Training loops)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_build["Dataset preparation"]
  node_pipeline["Dataset pipeline"]
  node_conversion["IFC conversion<br/>[conversion.py]"]
  node_correction["Model correction<br/>[correction.py]"]
  node_corroboration["Corroboration<br/>[corroboration.py]"]
  node_dedup["Deduplication<br/>[deduplication.py]"]
  node_desensitize["Desensitization<br/>[desensitization.py]"]
  node_extraction["Component extraction<br/>[extraction.py]"]
end

subgraph group_input["Data representations"]
  node_dataset["Dataset loaders<br/>[custom_dataset.py]"]
  node_graphdata["IFC graph data<br/>[custom_dataset.py]"]
  node_multiview["Multi-view data<br/>[custom_dataset.py]"]
  node_meshdata["Mesh data<br/>[custom_dataset.py]"]
  node_pointdata["Point data<br/>[custom_dataset.py]"]
  node_voxeldata["Voxel data<br/>[custom_dataset.py]"]
  node_objutils["OBJ utilities<br/>[objutils.py]"]
end

subgraph group_learn["Learning and evaluation"]
  node_training["Training orchestration<br/>[main.py]"]
  node_trainer["Training loops<br/>[train.py]"]
  node_rgcn["RGCN classifier<br/>[rgcn.py]"]
  node_mvcnn["MVCNN classifier<br/>[mvcnn.py]"]
  node_meshnet["MeshNet classifier<br/>[mesh_net.py]"]
  node_dgcnn["DGCNN classifier<br/>[dgcnn.py]"]
  node_voxnet["VoxNet classifier<br/>[voxnet.py]"]
  node_pointnet["PointNet model<br/>[point_net.py]"]
  node_validation["Validation<br/>[validation.py]"]
end

subgraph group_cloud["CloudComPy utilities"]
  node_cloudpy["CloudComPy API<br/>[__init__.py]"]
  node_bbox["Bounding box"]
end

node_researcher(("Researcher"))
node_cloudcompare["CloudCompare runtime"]

node_researcher -->|"starts run"| node_training
node_researcher -.->|"constructs data"| node_pipeline
node_pipeline -.->|"includes stage"| node_conversion
node_pipeline -.->|"includes stage"| node_correction
node_pipeline -.->|"includes stage"| node_corroboration
node_pipeline -.->|"includes stage"| node_dedup
node_pipeline -.->|"includes stage"| node_desensitize
node_pipeline -.->|"includes stage"| node_extraction
node_training -->|"loads datasets"| node_dataset
node_dataset -->|"provides graphs"| node_graphdata
node_dataset -->|"provides views"| node_multiview
node_dataset -->|"provides meshes"| node_meshdata
node_dataset -->|"provides points"| node_pointdata
node_dataset -.->|"provides voxels"| node_voxeldata
node_meshdata -->|"uses utilities"| node_objutils
node_training -->|"creates trainers"| node_trainer
node_trainer -.->|"trains model"| node_rgcn
node_trainer -.->|"trains model"| node_mvcnn
node_trainer -.->|"trains model"| node_meshnet
node_trainer -.->|"trains model"| node_dgcnn
node_trainer -.->|"trains model"| node_voxnet
node_training -->|"configures model"| node_rgcn
node_training -->|"configures model"| node_mvcnn
node_training -.->|"configures model"| node_meshnet
node_training -.->|"configures model"| node_voxnet
node_training -.->|"configures model"| node_dgcnn
node_validation -->|"loads test data"| node_dataset
node_validation -.->|"validates model"| node_rgcn
node_validation -->|"validates model"| node_mvcnn
node_validation -->|"validates model"| node_meshnet
node_validation -.->|"validates model"| node_voxnet
node_cloudpy -.->|"wraps runtime"| node_cloudcompare
node_bbox -->|"uses API"| node_cloudpy

click node_pipeline "https://github.com/yang-mingsong/bimcompnet/tree/main/dataset_construction_pipeline"
click node_conversion "https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/conversion.py"
click node_correction "https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/correction.py"
click node_corroboration "https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/corroboration.py"
click node_dedup "https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/deduplication.py"
click node_desensitize "https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/desensitization.py"
click node_extraction "https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/extraction.py"
click node_dataset "https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py"
click node_graphdata "https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py"
click node_multiview "https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py"
click node_meshdata "https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py"
click node_pointdata "https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py"
click node_voxeldata "https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py"
click node_objutils "https://github.com/yang-mingsong/bimcompnet/blob/main/utils/objutils.py"
click node_training "https://github.com/yang-mingsong/bimcompnet/blob/main/main.py"
click node_trainer "https://github.com/yang-mingsong/bimcompnet/blob/main/scripts/train.py"
click node_rgcn "https://github.com/yang-mingsong/bimcompnet/blob/main/model/rgcn.py"
click node_mvcnn "https://github.com/yang-mingsong/bimcompnet/blob/main/model/mvcnn.py"
click node_meshnet "https://github.com/yang-mingsong/bimcompnet/blob/main/model/mesh_net.py"
click node_dgcnn "https://github.com/yang-mingsong/bimcompnet/blob/main/model/dgcnn.py"
click node_voxnet "https://github.com/yang-mingsong/bimcompnet/blob/main/model/voxnet.py"
click node_pointnet "https://github.com/yang-mingsong/bimcompnet/blob/main/model/point_net.py"
click node_validation "https://github.com/yang-mingsong/bimcompnet/blob/main/validation.py"
click node_cloudpy "https://github.com/yang-mingsong/bimcompnet/blob/main/CloudComPy310/CloudCompare/cloudComPy/__init__.py"
click node_bbox "https://github.com/yang-mingsong/bimcompnet/blob/main/CloudComPy310/CloudCompare/cloudComPy/minimalBoundingBox.py"

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_pipeline,node_conversion,node_correction,node_corroboration,node_dedup,node_desensitize,node_extraction toneBlue
class node_dataset,node_graphdata,node_multiview,node_meshdata,node_pointdata,node_voxeldata,node_objutils toneAmber
class node_training,node_trainer,node_rgcn,node_mvcnn,node_meshnet,node_dgcnn,node_voxnet,node_pointnet,node_validation toneMint
class node_cloudpy,node_bbox toneRose
class node_researcher,node_cloudcompare toneIndigo
```

## Components

### Dataset preparation

- [Dataset pipeline](https://github.com/yang-mingsong/bimcompnet/tree/main/dataset_construction_pipeline): `dataset_construction_pipeline`
- [IFC conversion](https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/conversion.py): `dataset_construction_pipeline/conversion.py`
- [Model correction](https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/correction.py): `dataset_construction_pipeline/correction.py`
- [Corroboration](https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/corroboration.py): `dataset_construction_pipeline/corroboration.py`
- [Deduplication](https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/deduplication.py): `dataset_construction_pipeline/deduplication.py`
- [Desensitization](https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/desensitization.py): `dataset_construction_pipeline/desensitization.py`
- [Component extraction](https://github.com/yang-mingsong/bimcompnet/blob/main/dataset_construction_pipeline/extraction.py): `dataset_construction_pipeline/extraction.py`

### Data representations

- [Dataset loaders](https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py): `data/custom_dataset.py`
- [IFC graph data](https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py): `data/custom_dataset.py`
- [Multi-view data](https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py): `data/custom_dataset.py`
- [Mesh data](https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py): `data/custom_dataset.py`
- [Point data](https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py): `data/custom_dataset.py`
- [Voxel data](https://github.com/yang-mingsong/bimcompnet/blob/main/data/custom_dataset.py): `data/custom_dataset.py`
- [OBJ utilities](https://github.com/yang-mingsong/bimcompnet/blob/main/utils/objutils.py): `utils/objutils.py`

### Learning and evaluation

- [Training orchestration](https://github.com/yang-mingsong/bimcompnet/blob/main/main.py): `main.py`
- [Training loops](https://github.com/yang-mingsong/bimcompnet/blob/main/scripts/train.py): `scripts/train.py`
- [RGCN classifier](https://github.com/yang-mingsong/bimcompnet/blob/main/model/rgcn.py): `model/rgcn.py`
- [MVCNN classifier](https://github.com/yang-mingsong/bimcompnet/blob/main/model/mvcnn.py): `model/mvcnn.py`
- [MeshNet classifier](https://github.com/yang-mingsong/bimcompnet/blob/main/model/mesh_net.py): `model/mesh_net.py`
- [DGCNN classifier](https://github.com/yang-mingsong/bimcompnet/blob/main/model/dgcnn.py): `model/dgcnn.py`
- [VoxNet classifier](https://github.com/yang-mingsong/bimcompnet/blob/main/model/voxnet.py): `model/voxnet.py`
- [PointNet model](https://github.com/yang-mingsong/bimcompnet/blob/main/model/point_net.py): `model/point_net.py`
- [Validation](https://github.com/yang-mingsong/bimcompnet/blob/main/validation.py): `validation.py`

### CloudComPy utilities

- [CloudComPy API](https://github.com/yang-mingsong/bimcompnet/blob/main/CloudComPy310/CloudCompare/cloudComPy/__init__.py): `CloudComPy310/CloudCompare/cloudComPy/__init__.py`
- [Bounding box](https://github.com/yang-mingsong/bimcompnet/blob/main/CloudComPy310/CloudCompare/cloudComPy/minimalBoundingBox.py): `CloudComPy310/CloudCompare/cloudComPy/minimalBoundingBox.py`

### Other components

- **Researcher**
- **CloudCompare runtime**

## Connections

- Researcher → Training orchestration: starts run (evidence: `main.py`)
- Researcher → Dataset pipeline: constructs data (evidence: `README.md`)
- Dataset pipeline → IFC conversion: includes stage
- Dataset pipeline → Model correction: includes stage
- Dataset pipeline → Corroboration: includes stage
- Dataset pipeline → Deduplication: includes stage
- Dataset pipeline → Desensitization: includes stage
- Dataset pipeline → Component extraction: includes stage
- Training orchestration → Dataset loaders: loads datasets (evidence: `main.py`)
- Dataset loaders → IFC graph data: provides graphs (evidence: `data/custom_dataset.py`)
- Dataset loaders → Multi-view data: provides views (evidence: `data/custom_dataset.py`)
- Dataset loaders → Mesh data: provides meshes (evidence: `data/custom_dataset.py`)
- Dataset loaders → Point data: provides points (evidence: `data/custom_dataset.py`)
- Dataset loaders → Voxel data: provides voxels (evidence: `data/custom_dataset.py`)
- Mesh data → OBJ utilities: uses utilities (evidence: `data/custom_dataset.py`)
- Training orchestration → Training loops: creates trainers (evidence: `main.py`)
- Training loops → RGCN classifier: trains model
- Training loops → MVCNN classifier: trains model
- Training loops → MeshNet classifier: trains model
- Training loops → DGCNN classifier: trains model
- Training loops → VoxNet classifier: trains model
- Training orchestration → RGCN classifier: configures model (evidence: `main.py`)
- Training orchestration → MVCNN classifier: configures model (evidence: `main.py`)
- Training orchestration → MeshNet classifier: configures model (evidence: `main.py`)
- Training orchestration → VoxNet classifier: configures model (evidence: `main.py`)
- Training orchestration → DGCNN classifier: configures model (evidence: `main.py`)
- Validation → Dataset loaders: loads test data (evidence: `validation.py`)
- Validation → RGCN classifier: validates model (evidence: `validation.py`)
- Validation → MVCNN classifier: validates model (evidence: `validation.py`)
- Validation → MeshNet classifier: validates model (evidence: `validation.py`)
- Validation → VoxNet classifier: validates model (evidence: `validation.py`)
- CloudComPy API → CloudCompare runtime: wraps runtime
- Bounding box → CloudComPy API: uses API (evidence: `CloudComPy310/CloudCompare/cloudComPy/minimalBoundingBox.py`)
