# virajdesai0309/dwsim-automation-repo architecture

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

- Interactive diagram: https://gitdiagram.com/virajdesai0309/dwsim-automation-repo
- Repository: https://github.com/virajdesai0309/dwsim-automation-repo

## Overview

This repository is a set of DWSim process-simulation automation exercises, IDAES process-model examples, and heat-exchanger surrogate-model experiments, plus a browser-accessible cloud simulator. The principal interactive workflow is a user submitting a model’s inputs in the browser, the backend selecting and running the corresponding headless DWSim model, and returning results; the README also documents recorded-result fallback. The graph retains the major modeling and ML branches. Several exercise files and frontend behavior were not sampled, so their internal links are omitted rather than inferred.

Main entry points: [`09_Clould_Based_Simulations/backend/main.py`](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/09_Clould_Based_Simulations/backend/main.py) (Simulation API), [`09_Clould_Based_Simulations/frontend`](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/09_Clould_Based_Simulations/frontend) (Simulation UI), [`08 IDAES PSE Models/01 Flowstream Modelling/combustor_flowsheet.py`](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/01%20Flowstream%20Modelling/combustor_flowsheet.py) (Combustion Flowsheet), [`09_Clould_Based_Simulations/models`](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/09_Clould_Based_Simulations/models) (DWSim Runners)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cloud["Cloud Simulation"]
  node_frontend["Simulation UI"]
  node_api["Simulation API<br/>[main.py]"]
  node_registry["Model Registry<br/>[registry.py]"]
  node_runners["DWSim Runners"]
  node_recorded["Recorded Results"]
end

subgraph group_automation["DWSim Automation"]
  node_unitops["Unit-Operation Exercises"]
  node_material["Material-Stream Automation"]
  node_pump["Pump Automation"]
  node_hex["Heat-Exchanger Automation"]
  node_column["Column Automation"]
  node_turbines["Hydroelectric Turbines"]
  node_solar["Solar-Panel Automation"]
  node_parallel["Parallel Processing"]
end

subgraph group_idaes["IDAES Models"]
  node_mixer_model["Mixer Model<br/>[mixer_models.py]"]
  node_combustor["Combustion Flowsheet"]
  node_properties["Combustion Properties<br/>[materials.py]"]
  node_reaction["Reaction Package"]
  node_perry["DIPPR Correlation<br/>[perry.py]"]
  node_separator["Separator Flowsheet"]
  node_hydrocarbon["Hydrocarbon Properties<br/>[compounds.py]"]
end

subgraph group_ml["Surrogate Models"]
  node_ann["ANN Surrogate<br/>[02_ann_model.py]"]
  node_ann_verify["ANN Verification<br/>[03_verification.py]"]
  node_pinn_data["PINN Data Generation"]
  node_pinn["Heat-Exchanger PINN<br/>[02_PINN_model.py]"]
  node_pinn_verify["PINN Verification<br/>[03_verification.py]"]
end

node_user(("Browser User"))
node_dwsim["DWSim Solver"]

node_user -->|"enters inputs"| node_frontend
node_frontend -.->|"submits runs"| node_api
node_api -->|"loads registry"| node_registry
node_registry -->|"discovers models"| node_runners
node_api -.->|"dispatches runs"| node_runners
node_runners -->|"runs simulation"| node_dwsim
node_api -->|"serves interface"| node_frontend
node_frontend -->|"shows fallback"| node_recorded
node_user -->|"follows exercises"| node_unitops
node_user -->|"follows exercises"| node_material
node_user -->|"follows exercises"| node_pump
node_user -->|"follows exercises"| node_hex
node_user -->|"follows exercises"| node_column
node_user -->|"follows exercises"| node_turbines
node_user -->|"follows exercises"| node_solar
node_user -.->|"explores example"| node_parallel
node_combustor -->|"configures package"| node_properties
node_combustor -->|"configures reactions"| node_reaction
node_properties -->|"uses correlation"| node_perry
node_separator -->|"uses properties"| node_hydrocarbon
node_user -.->|"runs example"| node_mixer_model
node_user -.->|"runs example"| node_combustor
node_user -.->|"runs example"| node_separator
node_user -.->|"trains surrogate"| node_ann
node_ann_verify -->|"compares simulations"| node_dwsim
node_user -.->|"generates data"| node_pinn_data
node_user -.->|"trains network"| node_pinn
node_user -.->|"checks predictions"| node_pinn_verify

click node_frontend "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/09_Clould_Based_Simulations/frontend"
click node_api "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/09_Clould_Based_Simulations/backend/main.py"
click node_registry "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/09_Clould_Based_Simulations/backend/registry.py"
click node_runners "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/09_Clould_Based_Simulations/models"
click node_recorded "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/09_Clould_Based_Simulations/frontend/demo/runs"
click node_unitops "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/00%20FlowSheet%20Automation"
click node_material "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/00%20Automation%20for%20Material%20Stream"
click node_pump "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/01%20Automation%20of%20Pump"
click node_hex "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/02%20Automation%20of%20HEX"
click node_column "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/04%20Automation%20of%20Column"
click node_turbines "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/05%20Automation%20of%20Hydroelectric%20Turbines"
click node_solar "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/06%20Automation%20of%20Solar%20Panel"
click node_parallel "https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/07%20Parallel%20Processing"
click node_mixer_model "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/00%20Mixer%20Modelling/mixer_models.py"
click node_combustor "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/01%20Flowstream%20Modelling/combustor_flowsheet.py"
click node_properties "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/01%20Flowstream%20Modelling/materials.py"
click node_reaction "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/01%20Flowstream%20Modelling/combustion_reaction.py"
click node_perry "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/01%20Flowstream%20Modelling/perry.py"
click node_separator "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/02%20Separator%20Modelling/separator_modelling.py"
click node_hydrocarbon "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/02%20Separator%20Modelling/compounds.py"
click node_ann "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/10%20Surrogate%20Models/02_ann_model.py"
click node_ann_verify "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/10%20Surrogate%20Models/03_verification.py"
click node_pinn_data "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/11_PINN_Heat%20Exchanger/01_data_generation.py"
click node_pinn "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/11_PINN_Heat%20Exchanger/02_PINN_model.py"
click node_pinn_verify "https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/11_PINN_Heat%20Exchanger/03_verification.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_frontend,node_api,node_registry,node_runners,node_recorded,node_user toneBlue
class node_unitops,node_material,node_pump,node_hex,node_column,node_turbines,node_solar,node_parallel toneAmber
class node_mixer_model,node_combustor,node_properties,node_reaction,node_perry,node_separator,node_hydrocarbon toneMint
class node_ann,node_ann_verify,node_pinn_data,node_pinn,node_pinn_verify toneRose
class node_dwsim toneIndigo
```

## Components

### Cloud Simulation

- [Simulation UI](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/09_Clould_Based_Simulations/frontend): `09_Clould_Based_Simulations/frontend`
- [Simulation API](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/09_Clould_Based_Simulations/backend/main.py): `09_Clould_Based_Simulations/backend/main.py`
- [Model Registry](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/09_Clould_Based_Simulations/backend/registry.py): `09_Clould_Based_Simulations/backend/registry.py`
- [DWSim Runners](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/09_Clould_Based_Simulations/models): `09_Clould_Based_Simulations/models`
- [Recorded Results](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/09_Clould_Based_Simulations/frontend/demo/runs): `09_Clould_Based_Simulations/frontend/demo/runs`

### DWSim Automation

- [Unit-Operation Exercises](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/00%20FlowSheet%20Automation): `00 FlowSheet Automation`
- [Material-Stream Automation](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/00%20Automation%20for%20Material%20Stream): `00 Automation for Material Stream`
- [Pump Automation](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/01%20Automation%20of%20Pump): `01 Automation of Pump`
- [Heat-Exchanger Automation](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/02%20Automation%20of%20HEX): `02 Automation of HEX`
- [Column Automation](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/04%20Automation%20of%20Column): `04 Automation of Column`
- [Hydroelectric Turbines](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/05%20Automation%20of%20Hydroelectric%20Turbines): `05 Automation of Hydroelectric Turbines`
- [Solar-Panel Automation](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/06%20Automation%20of%20Solar%20Panel): `06 Automation of Solar Panel`
- [Parallel Processing](https://github.com/virajdesai0309/dwsim-automation-repo/tree/main/07%20Parallel%20Processing): `07 Parallel Processing`

### IDAES Models

- [Mixer Model](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/00%20Mixer%20Modelling/mixer_models.py): `08 IDAES PSE Models/00 Mixer Modelling/mixer_models.py`
- [Combustion Flowsheet](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/01%20Flowstream%20Modelling/combustor_flowsheet.py): `08 IDAES PSE Models/01 Flowstream Modelling/combustor_flowsheet.py`
- [Combustion Properties](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/01%20Flowstream%20Modelling/materials.py): `08 IDAES PSE Models/01 Flowstream Modelling/materials.py`
- [Reaction Package](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/01%20Flowstream%20Modelling/combustion_reaction.py): `08 IDAES PSE Models/01 Flowstream Modelling/combustion_reaction.py`
- [DIPPR Correlation](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/01%20Flowstream%20Modelling/perry.py): `08 IDAES PSE Models/01 Flowstream Modelling/perry.py`
- [Separator Flowsheet](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/02%20Separator%20Modelling/separator_modelling.py): `08 IDAES PSE Models/02 Separator Modelling/separator_modelling.py`
- [Hydrocarbon Properties](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/08%20IDAES%20PSE%20Models/02%20Separator%20Modelling/compounds.py): `08 IDAES PSE Models/02 Separator Modelling/compounds.py`

### Surrogate Models

- [ANN Surrogate](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/10%20Surrogate%20Models/02_ann_model.py): `10 Surrogate Models/02_ann_model.py`
- [ANN Verification](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/10%20Surrogate%20Models/03_verification.py): `10 Surrogate Models/03_verification.py`
- [PINN Data Generation](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/11_PINN_Heat%20Exchanger/01_data_generation.py): `11_PINN_Heat Exchanger/01_data_generation.py`
- [Heat-Exchanger PINN](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/11_PINN_Heat%20Exchanger/02_PINN_model.py): `11_PINN_Heat Exchanger/02_PINN_model.py`
- [PINN Verification](https://github.com/virajdesai0309/dwsim-automation-repo/blob/main/11_PINN_Heat%20Exchanger/03_verification.py): `11_PINN_Heat Exchanger/03_verification.py`

### Other components

- **Browser User**
- **DWSim Solver**

## Connections

- Browser User → Simulation UI: enters inputs (evidence: `README.md`)
- Simulation UI → Simulation API: submits runs (evidence: `README.md`)
- Simulation API → Model Registry: loads registry (evidence: `09_Clould_Based_Simulations/backend/main.py`)
- Model Registry → DWSim Runners: discovers models (evidence: `09_Clould_Based_Simulations/backend/registry.py`)
- Simulation API → DWSim Runners: dispatches runs
- DWSim Runners → DWSim Solver: runs simulation (evidence: `README.md`)
- Simulation API → Simulation UI: serves interface (evidence: `09_Clould_Based_Simulations/backend/main.py`)
- Simulation UI → Recorded Results: shows fallback (evidence: `README.md`)
- Browser User → Unit-Operation Exercises: follows exercises (evidence: `README.md`)
- Browser User → Material-Stream Automation: follows exercises (evidence: `README.md`)
- Browser User → Pump Automation: follows exercises (evidence: `README.md`)
- Browser User → Heat-Exchanger Automation: follows exercises (evidence: `README.md`)
- Browser User → Column Automation: follows exercises (evidence: `README.md`)
- Browser User → Hydroelectric Turbines: follows exercises (evidence: `README.md`)
- Browser User → Solar-Panel Automation: follows exercises (evidence: `README.md`)
- Browser User → Parallel Processing: explores example
- Combustion Flowsheet → Combustion Properties: configures package (evidence: `08 IDAES PSE Models/01 Flowstream Modelling/combustor_flowsheet.py`)
- Combustion Flowsheet → Reaction Package: configures reactions (evidence: `08 IDAES PSE Models/01 Flowstream Modelling/combustor_flowsheet.py`)
- Combustion Properties → DIPPR Correlation: uses correlation (evidence: `08 IDAES PSE Models/01 Flowstream Modelling/materials.py`)
- Separator Flowsheet → Hydrocarbon Properties: uses properties (evidence: `08 IDAES PSE Models/02 Separator Modelling/separator_modelling.py`)
- Browser User → Mixer Model: runs example
- Browser User → Combustion Flowsheet: runs example
- Browser User → Separator Flowsheet: runs example
- Browser User → ANN Surrogate: trains surrogate
- ANN Verification → DWSim Solver: compares simulations (evidence: `10 Surrogate Models/03_verification.py`)
- Browser User → PINN Data Generation: generates data
- Browser User → Heat-Exchanger PINN: trains network
- Browser User → PINN Verification: checks predictions
