# cubicasa/cubicasa5k architecture

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

- Interactive diagram: https://gitdiagram.com/cubicasa/cubicasa5k
- Repository: https://github.com/cubicasa/cubicasa5k

## Overview

CubiCasa5K is a floorplan-analysis dataset and multi-task neural-network project. Its user workflow turns annotated SVG plans into labels (optionally caching samples in LMDB), loads and augments image/label samples, and trains or evaluates a model that predicts room/icon segmentations and heatmaps. Evaluation includes metrics and polygon post-processing; plotting supports inspection. The graph follows README claims and indexed imports/calls; some training, evaluation, and post-processing internals were not fully sampled, so unsupported links are omitted.

Main entry points: [`floortrans/loaders/svg_loader.py`](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/loaders/svg_loader.py) (Dataset loader), [`train.py`](https://github.com/cubicasa/cubicasa5k/blob/master/train.py) (Training loop), [`eval.py`](https://github.com/cubicasa/cubicasa5k/blob/master/eval.py) (Evaluation runner), [`floortrans/metrics.py`](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/metrics.py) (Metrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Dataset and Loading"]
  node_house_parser["House parser<br/>[house.py]"]
  node_svg_geometry["SVG geometry<br/>[svg_utils.py]"]
  node_dataset_loader["Dataset loader<br/>[svg_loader.py]"]
  node_augmentations["Augmentations<br/>[augmentations.py]"]
  node_lmdb_builder["LMDB builder<br/>[create_lmdb.py]"]
  node_lmdb_store[("LMDB cache")]
end

subgraph group_learning["Model and Training"]
  node_trainer["Training loop<br/>[train.py]"]
  node_model_factory["Model selection<br/>[__init__.py]"]
  node_hourglass_model["Hourglass network"]
  node_model_blocks["Network blocks<br/>[model_1427.py]"]
  node_uncertainty_loss["Multi-task loss"]
end

subgraph group_prediction["Prediction Processing"]
  node_postprocessing["Polygon post-processing<br/>[post_prosessing.py]"]
end

subgraph group_evaluation["Evaluation and Outputs"]
  node_evaluator["Evaluation runner<br/>[eval.py]"]
  node_metrics["Metrics<br/>[metrics.py]"]
  node_plotting["Visualization<br/>[plotting.py]"]
end

node_dataset_user(("Dataset user"))
node_svg_annotations["SVG annotations"]
node_training_user(("Model developer"))
node_prediction_user(("Prediction user"))

node_dataset_user -->|"provides plans"| node_svg_annotations
node_svg_annotations -->|"parsed into labels"| node_house_parser
node_house_parser -->|"uses geometry"| node_svg_geometry
node_dataset_loader -->|"builds samples"| node_house_parser
node_dataset_loader -->|"applies transforms"| node_augmentations
node_dataset_loader -->|"reads cached samples"| node_lmdb_store
node_lmdb_builder -->|"writes cache"| node_lmdb_store
node_lmdb_builder -->|"uses dataset parsing"| node_dataset_loader
node_training_user -->|"starts training"| node_trainer
node_trainer -->|"loads samples"| node_dataset_loader
node_trainer -->|"requests model"| node_model_factory
node_model_factory -->|"constructs network"| node_hourglass_model
node_hourglass_model -->|"uses architecture"| node_model_blocks
node_trainer -->|"optimizes loss"| node_uncertainty_loss
node_prediction_user -->|"runs evaluation"| node_evaluator
node_evaluator -->|"loads samples"| node_dataset_loader
node_evaluator -->|"requests model"| node_model_factory
node_evaluator -->|"evaluates predictions"| node_metrics
node_metrics -->|"post-processes output"| node_postprocessing
node_metrics -->|"uses visualization"| node_plotting
node_prediction_user -.->|"receives vector output"| node_postprocessing

click node_house_parser "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/loaders/house.py"
click node_svg_geometry "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/loaders/svg_utils.py"
click node_dataset_loader "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/loaders/svg_loader.py"
click node_augmentations "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/loaders/augmentations.py"
click node_lmdb_builder "https://github.com/cubicasa/cubicasa5k/blob/master/create_lmdb.py"
click node_lmdb_store "https://github.com/cubicasa/cubicasa5k/tree/master/data"
click node_trainer "https://github.com/cubicasa/cubicasa5k/blob/master/train.py"
click node_model_factory "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/models/__init__.py"
click node_hourglass_model "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/models/hg_furukawa_original.py"
click node_model_blocks "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/models/model_1427.py"
click node_uncertainty_loss "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/losses/uncertainty_loss.py"
click node_evaluator "https://github.com/cubicasa/cubicasa5k/blob/master/eval.py"
click node_metrics "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/metrics.py"
click node_postprocessing "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/post_prosessing.py"
click node_plotting "https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/plotting.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_house_parser,node_svg_geometry,node_dataset_loader,node_augmentations,node_lmdb_builder,node_lmdb_store,node_dataset_user,node_prediction_user toneBlue
class node_trainer,node_model_factory,node_hourglass_model,node_model_blocks,node_uncertainty_loss toneAmber
class node_postprocessing toneMint
class node_evaluator,node_metrics,node_plotting toneRose
class node_svg_annotations,node_training_user toneIndigo
```

## Components

### Dataset and Loading

- [House parser](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/loaders/house.py): `floortrans/loaders/house.py`
- [SVG geometry](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/loaders/svg_utils.py): `floortrans/loaders/svg_utils.py`
- [Dataset loader](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/loaders/svg_loader.py): `floortrans/loaders/svg_loader.py`
- [Augmentations](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/loaders/augmentations.py): `floortrans/loaders/augmentations.py`
- [LMDB builder](https://github.com/cubicasa/cubicasa5k/blob/master/create_lmdb.py): `create_lmdb.py`
- [LMDB cache](https://github.com/cubicasa/cubicasa5k/tree/master/data): `data`

### Model and Training

- [Training loop](https://github.com/cubicasa/cubicasa5k/blob/master/train.py): `train.py`
- [Model selection](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/models/__init__.py): `floortrans/models/__init__.py`
- [Hourglass network](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/models/hg_furukawa_original.py): `floortrans/models/hg_furukawa_original.py`
- [Network blocks](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/models/model_1427.py): `floortrans/models/model_1427.py`
- [Multi-task loss](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/losses/uncertainty_loss.py): `floortrans/losses/uncertainty_loss.py`

### Prediction Processing

- [Polygon post-processing](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/post_prosessing.py): `floortrans/post_prosessing.py`

### Evaluation and Outputs

- [Evaluation runner](https://github.com/cubicasa/cubicasa5k/blob/master/eval.py): `eval.py`
- [Metrics](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/metrics.py): `floortrans/metrics.py`
- [Visualization](https://github.com/cubicasa/cubicasa5k/blob/master/floortrans/plotting.py): `floortrans/plotting.py`

### Other components

- **Dataset user**
- **SVG annotations**
- **Model developer**
- **Prediction user**

## Connections

- Dataset user → SVG annotations: provides plans (evidence: `README.md`)
- SVG annotations → House parser: parsed into labels
- House parser → SVG geometry: uses geometry (evidence: `floortrans/loaders/house.py`)
- Dataset loader → House parser: builds samples (evidence: `floortrans/loaders/svg_loader.py`)
- Dataset loader → Augmentations: applies transforms (evidence: `floortrans/loaders/svg_loader.py`)
- Dataset loader → LMDB cache: reads cached samples (evidence: `floortrans/loaders/svg_loader.py`)
- LMDB builder → LMDB cache: writes cache (evidence: `README.md`)
- LMDB builder → Dataset loader: uses dataset parsing (evidence: `create_lmdb.py`)
- Model developer → Training loop: starts training (evidence: `README.md`)
- Training loop → Dataset loader: loads samples (evidence: `train.py`)
- Training loop → Model selection: requests model (evidence: `train.py`)
- Model selection → Hourglass network: constructs network (evidence: `floortrans/models/__init__.py`)
- Hourglass network → Network blocks: uses architecture (evidence: `floortrans/models/hg_furukawa_original.py`)
- Training loop → Multi-task loss: optimizes loss (evidence: `train.py`)
- Prediction user → Evaluation runner: runs evaluation (evidence: `README.md`)
- Evaluation runner → Dataset loader: loads samples (evidence: `eval.py`)
- Evaluation runner → Model selection: requests model (evidence: `eval.py`)
- Evaluation runner → Metrics: evaluates predictions (evidence: `eval.py`)
- Metrics → Polygon post-processing: post-processes output (evidence: `floortrans/metrics.py`)
- Metrics → Visualization: uses visualization (evidence: `floortrans/metrics.py`)
- Prediction user → Polygon post-processing: receives vector output
