# kailasss2k05/coair architecture

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

- Interactive diagram: https://gitdiagram.com/kailasss2k05/coair
- Repository: https://github.com/kailasss2k05/coair

## Overview

CoAIR extends LEGO-Net inference: a user runs pretrained denoising on perturbed 3D-FRONT scenes, optionally applying collision and room-containment corrections during denoising, then evaluates layout validity and quality. Functional grouping supports correction; rendering is an optional output capability. The source index and README establish the main links; unsampled experiment and visualization scripts are not expanded into separate runtime components.

Main entry points: [`coair/inference_coair.py`](https://github.com/kailasss2k05/coair/blob/main/coair/inference_coair.py) (Denoising Loop), [`coair/eval_coair.py`](https://github.com/kailasss2k05/coair/blob/main/coair/eval_coair.py) (Evaluation CLI), [`coair/grouping.py`](https://github.com/kailasss2k05/coair/blob/main/coair/grouping.py) (Functional Grouping), [`LEGO-Net/data/TDFront.py`](https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/data/TDFront.py) (3D-FRONT Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inference["Scene Inference"]
  node_scene_data["3D-FRONT Data<br/>[TDFront.py]"]
  node_preprocess["Scene Preprocessing"]
  node_transformer["Denoising Model<br/>[transformer.py]"]
  node_inference_loop["Denoising Loop<br/>[inference_coair.py]"]
  node_representations["Pose Representation<br/>[representation.py]"]
  node_checkpoint["LEGO-Net Checkpoint"]
end

subgraph group_constraints["Geometric Constraints"]
  node_collision["Collision Correction<br/>[collision.py]"]
  node_containment["Room Containment<br/>[boundary.py]"]
  node_grouping_logic["Functional Grouping<br/>[grouping.py]"]
end

subgraph group_evaluation["Evaluation"]
  node_eval_cli["Evaluation CLI<br/>[eval_coair.py]"]
  node_base_metrics["Layout Metrics"]
  node_validity["Exact Validity<br/>[success_rate.py]"]
  node_distance["Distance Measures<br/>[distance.py]"]
  node_results["Metrics Results"]
end

subgraph group_rendering["Rendering"]
  node_mesh_renderer["3D Mesh Rendering<br/>[mesh_render.py]"]
  node_mesh_assets["3D-FUTURE Meshes"]
end

node_user(("User"))

node_user -->|"runs"| node_inference_loop
node_scene_data -->|"supplies scenes"| node_inference_loop
node_preprocess -->|"prepares data"| node_scene_data
node_inference_loop -->|"denoises with"| node_transformer
node_inference_loop -->|"applies correction"| node_collision
node_inference_loop -->|"applies correction"| node_containment
node_inference_loop -->|"uses grouping"| node_grouping_logic
node_grouping_logic -->|"supports correction"| node_collision
node_grouping_logic -->|"supports correction"| node_containment
node_checkpoint -.->|"loads weights"| node_transformer
node_inference_loop -.->|"uses poses"| node_representations
node_user -->|"runs metrics"| node_eval_cli
node_eval_cli -->|"computes metrics"| node_base_metrics
node_eval_cli -->|"computes validity"| node_validity
node_eval_cli -->|"loads scene data"| node_scene_data
node_base_metrics -->|"uses distances"| node_distance
node_eval_cli -.->|"writes metrics"| node_results
node_mesh_assets -.->|"provides meshes"| node_mesh_renderer

click node_scene_data "https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/data/TDFront.py"
click node_preprocess "https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/data/preprocess_TDFront.py"
click node_transformer "https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/model/transformer.py"
click node_inference_loop "https://github.com/kailasss2k05/coair/blob/main/coair/inference_coair.py"
click node_representations "https://github.com/kailasss2k05/coair/blob/main/coair/representation.py"
click node_collision "https://github.com/kailasss2k05/coair/blob/main/coair/collision.py"
click node_containment "https://github.com/kailasss2k05/coair/blob/main/coair/boundary.py"
click node_grouping_logic "https://github.com/kailasss2k05/coair/blob/main/coair/grouping.py"
click node_eval_cli "https://github.com/kailasss2k05/coair/blob/main/coair/eval_coair.py"
click node_base_metrics "https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/eval/denoise_res_eval.py"
click node_validity "https://github.com/kailasss2k05/coair/blob/main/coair/success_rate.py"
click node_distance "https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/data/distance.py"
click node_mesh_renderer "https://github.com/kailasss2k05/coair/blob/main/coair/mesh_render.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_scene_data,node_preprocess,node_transformer,node_inference_loop,node_representations,node_checkpoint,node_user toneBlue
class node_collision,node_containment,node_grouping_logic toneAmber
class node_eval_cli,node_base_metrics,node_validity,node_distance,node_results toneMint
class node_mesh_renderer,node_mesh_assets toneRose
```

## Components

### Scene Inference

- [3D-FRONT Data](https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/data/TDFront.py): `LEGO-Net/data/TDFront.py`
- [Scene Preprocessing](https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/data/preprocess_TDFront.py): `LEGO-Net/data/preprocess_TDFront.py`
- [Denoising Model](https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/model/transformer.py): `LEGO-Net/model/transformer.py`
- [Denoising Loop](https://github.com/kailasss2k05/coair/blob/main/coair/inference_coair.py): `coair/inference_coair.py`
- [Pose Representation](https://github.com/kailasss2k05/coair/blob/main/coair/representation.py): `coair/representation.py`
- **LEGO-Net Checkpoint**

### Geometric Constraints

- [Collision Correction](https://github.com/kailasss2k05/coair/blob/main/coair/collision.py): `coair/collision.py`
- [Room Containment](https://github.com/kailasss2k05/coair/blob/main/coair/boundary.py): `coair/boundary.py`
- [Functional Grouping](https://github.com/kailasss2k05/coair/blob/main/coair/grouping.py): `coair/grouping.py`

### Evaluation

- [Evaluation CLI](https://github.com/kailasss2k05/coair/blob/main/coair/eval_coair.py): `coair/eval_coair.py`
- [Layout Metrics](https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/eval/denoise_res_eval.py): `LEGO-Net/eval/denoise_res_eval.py`
- [Exact Validity](https://github.com/kailasss2k05/coair/blob/main/coair/success_rate.py): `coair/success_rate.py`
- [Distance Measures](https://github.com/kailasss2k05/coair/blob/main/LEGO-Net/data/distance.py): `LEGO-Net/data/distance.py`
- **Metrics Results**

### Rendering

- [3D Mesh Rendering](https://github.com/kailasss2k05/coair/blob/main/coair/mesh_render.py): `coair/mesh_render.py`
- **3D-FUTURE Meshes**

### Other components

- **User**

## Connections

- User → Denoising Loop: runs
- 3D-FRONT Data → Denoising Loop: supplies scenes (evidence: `coair/inference_coair.py`)
- Scene Preprocessing → 3D-FRONT Data: prepares data (evidence: `LEGO-Net/data/preprocess_TDFront.py`)
- Denoising Loop → Denoising Model: denoises with (evidence: `coair/inference_coair.py`)
- Denoising Loop → Collision Correction: applies correction (evidence: `coair/inference_coair.py`)
- Denoising Loop → Room Containment: applies correction (evidence: `coair/inference_coair.py`)
- Denoising Loop → Functional Grouping: uses grouping (evidence: `coair/inference_coair.py`)
- Functional Grouping → Collision Correction: supports correction (evidence: `coair/grouping.py`)
- Functional Grouping → Room Containment: supports correction (evidence: `coair/grouping.py`)
- LEGO-Net Checkpoint → Denoising Model: loads weights
- Denoising Loop → Pose Representation: uses poses
- User → Evaluation CLI: runs metrics
- Evaluation CLI → Layout Metrics: computes metrics (evidence: `coair/eval_coair.py`)
- Evaluation CLI → Exact Validity: computes validity (evidence: `coair/eval_coair.py`)
- Evaluation CLI → 3D-FRONT Data: loads scene data (evidence: `coair/eval_coair.py`)
- Layout Metrics → Distance Measures: uses distances (evidence: `LEGO-Net/eval/denoise_res_eval.py`)
- Evaluation CLI → Metrics Results: writes metrics
- 3D-FUTURE Meshes → 3D Mesh Rendering: provides meshes
