# aditya-donde/osdagbridge architecture

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

- Interactive diagram: https://gitdiagram.com/aditya-donde/osdagbridge
- Repository: https://github.com/aditya-donde/osdagbridge

## Overview

OsdagBridge is a shared-core bridge analysis and design application; the documented supported bridge type is plate girder. Its principal workflow takes bridge inputs through sizing, structural analysis and code checks, then produces design results, CAD geometry and reports. Desktop, CLI and web interfaces are described as clients of the shared core, though the web files are absent from this tree and CLI implementation was not sampled. The README establishes the broad workflow and capabilities; source-index references support selected internal connections, but unsampled implementations are not inferred in detail.

Main entry points: [`src/osdagbridge/core/bridge_types/plate_girder/analysis_results.py`](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/analysis_results.py) (Structural analysis), [`src/osdagbridge/core/bridge_types/plate_girder/designer.py`](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/designer.py) (Plate girder design), [`src/osdagbridge/core/bridge_types/plate_girder/dto.py`](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/dto.py) (Bridge inputs), [`src/osdagbridge/core/bridge_types/plate_girder/results_data.py`](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/results_data.py) (Design results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_cli["Command line<br/>[commands.py]"]
  node_desktop["Desktop GUI<br/>[template_page.py]"]
end

subgraph group_design["Bridge design"]
  node_bridge_inputs["Bridge inputs<br/>[dto.py]"]
  node_plate_defaults["Defaults and sizing<br/>[defaults.py]"]
  node_plate_sizing["Initial sizing<br/>[initial_sizing.py]"]
  node_plate_design["Plate girder design<br/>[designer.py]"]
  node_plate_components["Bridge components"]
  node_box_girder["Box girder plugin"]
  node_truss["Truss plugin"]
end

subgraph group_analysis["Analysis and standards"]
  node_loads["Bridge loads"]
  node_plate_analysis["Structural analysis"]
  node_graph_engine["Analysis engine<br/>[graph_engine.py]"]
  node_solver_adapters["Solver adapters"]
  node_standards["Design standards"]
end

subgraph group_outputs["Design outputs"]
  node_results["Design results<br/>[results_data.py]"]
  node_cad["CAD geometry<br/>[cad_generator.py]"]
  node_ifc_export["IFC export"]
  node_reports["Reports"]
  node_boq["Bill of quantities<br/>[boq_generator.py]"]
end

subgraph group_shared["Shared infrastructure"]
  node_common["Core utilities<br/>[common.py]"]
  node_location[("Location data<br/>[database.py]")]
end

node_engineer(("Bridge engineer"))

node_engineer -->|"runs analysis"| node_cli
node_engineer -->|"uses application"| node_desktop
node_cli -->|"submits project"| node_bridge_inputs
node_desktop -->|"collects inputs"| node_bridge_inputs
node_bridge_inputs -->|"sets defaults"| node_plate_defaults
node_bridge_inputs -->|"sizes bridge"| node_plate_sizing
node_plate_defaults -->|"provides defaults"| node_plate_sizing
node_plate_sizing -->|"informs design"| node_plate_design
node_plate_design -->|"configures analysis"| node_plate_analysis
node_plate_analysis -->|"uses engine"| node_graph_engine
node_plate_analysis -->|"selects backend"| node_solver_adapters
node_plate_analysis -.->|"applies loads"| node_loads
node_plate_analysis -->|"checks standards"| node_standards
node_plate_analysis -->|"produces results"| node_results
node_plate_design -->|"uses components"| node_plate_components
node_plate_design -.->|"extends plugin system"| node_box_girder
node_plate_design -.->|"extends plugin system"| node_truss
node_results -->|"generates geometry"| node_cad
node_cad -->|"exports model"| node_ifc_export
node_results -->|"generates report"| node_reports
node_plate_design -.->|"generates quantities"| node_boq
node_desktop -->|"displays results"| node_results
node_plate_analysis -->|"uses utilities"| node_common
node_plate_defaults -->|"uses code data"| node_standards

click node_cli "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/cli/commands.py"
click node_desktop "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/desktop/ui/template_page.py"
click node_bridge_inputs "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/dto.py"
click node_plate_defaults "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/defaults.py"
click node_plate_sizing "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/initial_sizing.py"
click node_plate_design "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/designer.py"
click node_plate_components "https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/bridge_components"
click node_box_girder "https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/bridge_types/box_girder"
click node_truss "https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/bridge_types/truss"
click node_loads "https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/loads"
click node_plate_analysis "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/analysis_results.py"
click node_graph_engine "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/graph_engine.py"
click node_solver_adapters "https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/solvers"
click node_standards "https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/utils/codes"
click node_results "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/results_data.py"
click node_cad "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/cad_generator.py"
click node_ifc_export "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/ifc_export_bridge/export_ifc_handler.py"
click node_reports "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/reports/report_generator.py"
click node_boq "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/boq/boq_generator.py"
click node_common "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/utils/common.py"
click node_location "https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/data/project_location/database.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_cli,node_desktop toneBlue
class node_bridge_inputs,node_plate_defaults,node_plate_sizing,node_plate_design,node_plate_components,node_box_girder,node_truss toneAmber
class node_loads,node_plate_analysis,node_graph_engine,node_solver_adapters,node_standards toneMint
class node_results,node_cad,node_ifc_export,node_reports,node_boq toneRose
class node_common,node_location,node_engineer toneIndigo
```

## Components

### User interfaces

- [Command line](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/cli/commands.py): `src/osdagbridge/cli/commands.py`
- [Desktop GUI](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/desktop/ui/template_page.py): `src/osdagbridge/desktop/ui/template_page.py`

### Bridge design

- [Bridge inputs](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/dto.py): `src/osdagbridge/core/bridge_types/plate_girder/dto.py`
- [Defaults and sizing](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/defaults.py): `src/osdagbridge/core/bridge_types/plate_girder/defaults.py`
- [Initial sizing](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/initial_sizing.py): `src/osdagbridge/core/bridge_types/plate_girder/initial_sizing.py`
- [Plate girder design](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/designer.py): `src/osdagbridge/core/bridge_types/plate_girder/designer.py`
- [Bridge components](https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/bridge_components): `src/osdagbridge/core/bridge_components`
- [Box girder plugin](https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/bridge_types/box_girder): `src/osdagbridge/core/bridge_types/box_girder`
- [Truss plugin](https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/bridge_types/truss): `src/osdagbridge/core/bridge_types/truss`

### Analysis and standards

- [Bridge loads](https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/loads): `src/osdagbridge/core/loads`
- [Structural analysis](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/analysis_results.py): `src/osdagbridge/core/bridge_types/plate_girder/analysis_results.py`
- [Analysis engine](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/graph_engine.py): `src/osdagbridge/core/bridge_types/plate_girder/graph_engine.py`
- [Solver adapters](https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/solvers): `src/osdagbridge/core/solvers`
- [Design standards](https://github.com/aditya-donde/osdagbridge/tree/dev/src/osdagbridge/core/utils/codes): `src/osdagbridge/core/utils/codes`

### Design outputs

- [Design results](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/results_data.py): `src/osdagbridge/core/bridge_types/plate_girder/results_data.py`
- [CAD geometry](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/bridge_types/plate_girder/cad_generator.py): `src/osdagbridge/core/bridge_types/plate_girder/cad_generator.py`
- [IFC export](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/ifc_export_bridge/export_ifc_handler.py): `src/osdagbridge/core/ifc_export_bridge/export_ifc_handler.py`
- [Reports](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/reports/report_generator.py): `src/osdagbridge/core/reports/report_generator.py`
- [Bill of quantities](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/boq/boq_generator.py): `src/osdagbridge/core/boq/boq_generator.py`

### Shared infrastructure

- [Core utilities](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/utils/common.py): `src/osdagbridge/core/utils/common.py`
- [Location data](https://github.com/aditya-donde/osdagbridge/blob/dev/src/osdagbridge/core/data/project_location/database.py): `src/osdagbridge/core/data/project_location/database.py`

### Other components

- **Bridge engineer**

## Connections

- Bridge engineer → Command line: runs analysis (evidence: `README.md`)
- Bridge engineer → Desktop GUI: uses application (evidence: `README.md`)
- Command line → Bridge inputs: submits project (evidence: `README.md`)
- Desktop GUI → Bridge inputs: collects inputs (evidence: `src/osdagbridge/desktop/ui/template_page.py`)
- Bridge inputs → Defaults and sizing: sets defaults (evidence: `src/osdagbridge/core/bridge_types/plate_girder/defaults.py`)
- Bridge inputs → Initial sizing: sizes bridge (evidence: `README.md`)
- Defaults and sizing → Initial sizing: provides defaults (evidence: `src/osdagbridge/core/bridge_types/plate_girder/defaults.py`)
- Initial sizing → Plate girder design: informs design (evidence: `README.md`)
- Plate girder design → Structural analysis: configures analysis (evidence: `README.md`)
- Structural analysis → Analysis engine: uses engine (evidence: `src/osdagbridge/core/bridge_types/plate_girder/analysis_results.py`)
- Structural analysis → Solver adapters: selects backend (evidence: `README.md`)
- Structural analysis → Bridge loads: applies loads
- Structural analysis → Design standards: checks standards (evidence: `README.md`)
- Structural analysis → Design results: produces results (evidence: `src/osdagbridge/core/bridge_types/plate_girder/analysis_results.py`)
- Plate girder design → Bridge components: uses components (evidence: `README.md`)
- Plate girder design → Box girder plugin: extends plugin system
- Plate girder design → Truss plugin: extends plugin system
- Design results → CAD geometry: generates geometry (evidence: `src/osdagbridge/desktop/ui/cad_3d.py`)
- CAD geometry → IFC export: exports model (evidence: `src/osdagbridge/core/ifc_export_bridge/export_ifc_handler.py`)
- Design results → Reports: generates report (evidence: `README.md`)
- Plate girder design → Bill of quantities: generates quantities
- Desktop GUI → Design results: displays results (evidence: `src/osdagbridge/desktop/ui/template_page.py`)
- Structural analysis → Core utilities: uses utilities (evidence: `src/osdagbridge/core/bridge_types/plate_girder/analysis_results.py`)
- Defaults and sizing → Design standards: uses code data (evidence: `src/osdagbridge/core/bridge_types/plate_girder/defaults.py`)
