# adidhembre/column_design architecture

> Architecture diagram of the GitHub repository adidhembre/column_design, 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/adidhembre/column_design
- Repository: https://github.com/adidhembre/column_design

## Overview

Column Design is a desktop tool for sizing reinforced-concrete columns. Users enter section, material, load, reinforcement, and design-mode inputs; the application validates and forwards them to the design engine, then displays required reinforcement and an interaction ratio. A separate report action reruns the design, formats a detailed report, and sends it to the system print flow. The README also documents result validation via a PDF. The calculation engine is only partially excerpted, so internal calculation stages are not decomposed beyond the supported design entry point.

Main entry points: [`Source/main.py`](https://github.com/adidhembre/column_design/blob/main/Source/main.py) (Report Handler), [`Source/engine.py`](https://github.com/adidhembre/column_design/blob/main/Source/engine.py) (Design Engine), [`asset/Validation.pdf`](https://github.com/adidhembre/column_design/blob/main/asset/Validation.pdf) (Validation Problems), [`Source/template.py`](https://github.com/adidhembre/column_design/blob/main/Source/template.py) (Report Formatter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_inputs["Design Inputs<br/>[main.py]"]
  node_submit["Submit Handler<br/>[main.py]"]
  node_results["Output Data<br/>[main.py]"]
  node_report_ui["Report Inputs<br/>[main.py]"]
end

subgraph group_design["Column Design"]
  node_engine["Design Engine<br/>[engine.py]"]
end

subgraph group_reporting["Reports"]
  node_report_handler["Report Handler<br/>[main.py]"]
  node_report_template["Report Formatter<br/>[template.py]"]
  node_print_flow["Report Print Flow<br/>[main.py]"]
end

subgraph group_validation["Validation"]
  node_validation_doc["Validation Problems<br/>[Validation.pdf]"]
end

node_user(("Engineer"))
node_print_service["System Print Service"]

node_user -->|"enters values"| node_inputs
node_user -->|"submits design"| node_submit
node_inputs -->|"provides values"| node_submit
node_submit -->|"calls Execute"| node_engine
node_engine -->|"returns results"| node_results
node_user -->|"enters report details"| node_report_ui
node_user -->|"requests report"| node_report_handler
node_report_ui -->|"provides details"| node_report_handler
node_report_handler -->|"reruns design"| node_engine
node_report_handler -->|"calls formatter"| node_report_template
node_report_handler -->|"writes and prints"| node_print_flow
node_print_flow -->|"invokes system print"| node_print_service
node_validation_doc -->|"documents validation"| node_results

click node_inputs "https://github.com/adidhembre/column_design/blob/main/Source/main.py"
click node_submit "https://github.com/adidhembre/column_design/blob/main/Source/main.py"
click node_results "https://github.com/adidhembre/column_design/blob/main/Source/main.py"
click node_report_ui "https://github.com/adidhembre/column_design/blob/main/Source/main.py"
click node_report_handler "https://github.com/adidhembre/column_design/blob/main/Source/main.py"
click node_engine "https://github.com/adidhembre/column_design/blob/main/Source/engine.py"
click node_report_template "https://github.com/adidhembre/column_design/blob/main/Source/template.py"
click node_print_flow "https://github.com/adidhembre/column_design/blob/main/Source/main.py"
click node_validation_doc "https://github.com/adidhembre/column_design/blob/main/asset/Validation.pdf"

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_inputs,node_submit,node_results,node_report_ui toneBlue
class node_engine toneAmber
class node_report_handler,node_report_template,node_print_flow toneMint
class node_validation_doc toneRose
class node_user,node_print_service toneIndigo
```

## Components

### User Interface

- [Design Inputs](https://github.com/adidhembre/column_design/blob/main/Source/main.py): `Source/main.py`
- [Submit Handler](https://github.com/adidhembre/column_design/blob/main/Source/main.py): `Source/main.py`
- [Output Data](https://github.com/adidhembre/column_design/blob/main/Source/main.py): `Source/main.py`
- [Report Inputs](https://github.com/adidhembre/column_design/blob/main/Source/main.py): `Source/main.py`

### Column Design

- [Design Engine](https://github.com/adidhembre/column_design/blob/main/Source/engine.py): `Source/engine.py`

### Reports

- [Report Handler](https://github.com/adidhembre/column_design/blob/main/Source/main.py): `Source/main.py`
- [Report Formatter](https://github.com/adidhembre/column_design/blob/main/Source/template.py): `Source/template.py`
- [Report Print Flow](https://github.com/adidhembre/column_design/blob/main/Source/main.py): `Source/main.py`

### Validation

- [Validation Problems](https://github.com/adidhembre/column_design/blob/main/asset/Validation.pdf): `asset/Validation.pdf`

### Other components

- **Engineer**
- **System Print Service**

## Connections

- Engineer → Design Inputs: enters values (evidence: `Source/main.py`)
- Engineer → Submit Handler: submits design (evidence: `Source/main.py`)
- Design Inputs → Submit Handler: provides values (evidence: `Source/main.py`)
- Submit Handler → Design Engine: calls Execute (evidence: `Source/main.py`)
- Design Engine → Output Data: returns results (evidence: `Source/main.py`)
- Engineer → Report Inputs: enters report details (evidence: `Source/main.py`)
- Engineer → Report Handler: requests report (evidence: `Source/main.py`)
- Report Inputs → Report Handler: provides details (evidence: `Source/main.py`)
- Report Handler → Design Engine: reruns design (evidence: `Source/main.py`)
- Report Handler → Report Formatter: calls formatter (evidence: `Source/main.py`)
- Report Handler → Report Print Flow: writes and prints (evidence: `Source/main.py`)
- Report Print Flow → System Print Service: invokes system print (evidence: `Source/main.py`)
- Validation Problems → Output Data: documents validation (evidence: `README.md`)
