# usepa/addesigns architecture

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

- Interactive diagram: https://gitdiagram.com/usepa/addesigns
- Repository: https://github.com/usepa/addesigns

## Overview

AdDesignS is a Windows adsorption-design application: users provide system and adsorber inputs, select a model, and inspect simulation results. The repository tree shows distinct model families, correlation tools, data editors, file I/O, and result forms; the README documents a Visual Basic GUI paired with a FORTRAN engine. Specific UI-to-model and model-to-engine calls are not shown in the sampled material, so those links are omitted. The generated ActiveX wrappers are grouped as supporting GUI controls rather than treated as product logic.

Main entry points: [`VS2019_AdDesignS/ADS_VBnet_MV/Main_frm.vb`](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/Main_frm.vb) (Main window), [`VS2019_AdDesignS/digital_fortran_code/forcode`](https://github.com/usepa/addesigns/tree/main/VS2019_AdDesignS/digital_fortran_code/forcode) (FORTRAN engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_main["Main window<br/>[Main_frm.vb]"]
  node_input["Model inputs<br/>[DataEntry.vb]"]
  node_adsorber["Adsorber editor<br/>[EditAdsorber.vb]"]
  node_carbon["Carbon editor<br/>[EditCarbon.vb]"]
  node_isotherm["Isotherm editor<br/>[EditIsotherm.vb]"]
  node_controlwrappers["ActiveX controls"]
end

subgraph group_models["Simulation models"]
  node_psdm["PSDM model<br/>[ModelPSDM.vb]"]
  node_room["Room PSDM<br/>[ModelPSDMInRoom.vb]"]
  node_cphsdm["CPHSDM model<br/>[ModelCPHSDM.vb]"]
  node_ecm["ECM model<br/>[ModelECM.vb]"]
  node_ipe["IPE model<br/>[ModelIPE.vb]"]
  node_results["Model results"]
  node_comparison["Data comparison"]
end

subgraph group_science["Scientific data"]
  node_correlations["Correlations<br/>[Correlations.vb]"]
  node_dimensionless["Dimensionless data"]
  node_fluid["Fluid properties<br/>[FluidProps.vb]"]
  node_fouling["Fouling data<br/>[Fouling.vb]"]
end

subgraph group_runtime["Runtime and files"]
  node_engine["FORTRAN engine"]
  node_fileio["File I/O<br/>[FileIO.vb]"]
  node_databases[("Application data")]
end

node_user(("User"))

node_user -->|"launches"| node_main
node_main -->|"uses engine"| node_engine

click node_main "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/Main_frm.vb"
click node_input "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/DataEntry.vb"
click node_adsorber "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/EditAdsorber.vb"
click node_carbon "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/EditCarbon.vb"
click node_isotherm "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/EditIsotherm.vb"
click node_controlwrappers "https://github.com/usepa/addesigns/tree/main/VS2019_AdDesignS/ADS_VBnet_MV/obj/Debug"
click node_psdm "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelPSDM.vb"
click node_room "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelPSDMInRoom.vb"
click node_cphsdm "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelCPHSDM.vb"
click node_ecm "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelECM.vb"
click node_ipe "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelIPE.vb"
click node_results "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelPSDMResults.vb"
click node_comparison "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelDataComparison.vb"
click node_correlations "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/Correlations.vb"
click node_dimensionless "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/CorrelationsDimless.vb"
click node_fluid "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/FluidProps.vb"
click node_fouling "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/Fouling.vb"
click node_engine "https://github.com/usepa/addesigns/tree/main/VS2019_AdDesignS/digital_fortran_code/forcode"
click node_fileio "https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/FileIO.vb"
click node_databases "https://github.com/usepa/addesigns/tree/main/VS2019_AdDesignS/ADS_VBnet_MV/bin/dbase"

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_main,node_input,node_adsorber,node_carbon,node_isotherm,node_controlwrappers,node_user toneBlue
class node_psdm,node_room,node_cphsdm,node_ecm,node_ipe,node_results,node_comparison toneAmber
class node_correlations,node_dimensionless,node_fluid,node_fouling toneMint
class node_engine,node_fileio,node_databases toneRose
```

## Components

### User interface

- [Main window](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/Main_frm.vb): `VS2019_AdDesignS/ADS_VBnet_MV/Main_frm.vb`
- [Model inputs](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/DataEntry.vb): `VS2019_AdDesignS/ADS_VBnet_MV/DataEntry.vb`
- [Adsorber editor](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/EditAdsorber.vb): `VS2019_AdDesignS/ADS_VBnet_MV/EditAdsorber.vb`
- [Carbon editor](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/EditCarbon.vb): `VS2019_AdDesignS/ADS_VBnet_MV/EditCarbon.vb`
- [Isotherm editor](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/EditIsotherm.vb): `VS2019_AdDesignS/ADS_VBnet_MV/EditIsotherm.vb`
- [ActiveX controls](https://github.com/usepa/addesigns/tree/main/VS2019_AdDesignS/ADS_VBnet_MV/obj/Debug): `VS2019_AdDesignS/ADS_VBnet_MV/obj/Debug`

### Simulation models

- [PSDM model](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelPSDM.vb): `VS2019_AdDesignS/ADS_VBnet_MV/ModelPSDM.vb`
- [Room PSDM](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelPSDMInRoom.vb): `VS2019_AdDesignS/ADS_VBnet_MV/ModelPSDMInRoom.vb`
- [CPHSDM model](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelCPHSDM.vb): `VS2019_AdDesignS/ADS_VBnet_MV/ModelCPHSDM.vb`
- [ECM model](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelECM.vb): `VS2019_AdDesignS/ADS_VBnet_MV/ModelECM.vb`
- [IPE model](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelIPE.vb): `VS2019_AdDesignS/ADS_VBnet_MV/ModelIPE.vb`
- [Model results](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelPSDMResults.vb): `VS2019_AdDesignS/ADS_VBnet_MV/ModelPSDMResults.vb`
- [Data comparison](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/ModelDataComparison.vb): `VS2019_AdDesignS/ADS_VBnet_MV/ModelDataComparison.vb`

### Scientific data

- [Correlations](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/Correlations.vb): `VS2019_AdDesignS/ADS_VBnet_MV/Correlations.vb`
- [Dimensionless data](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/CorrelationsDimless.vb): `VS2019_AdDesignS/ADS_VBnet_MV/CorrelationsDimless.vb`
- [Fluid properties](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/FluidProps.vb): `VS2019_AdDesignS/ADS_VBnet_MV/FluidProps.vb`
- [Fouling data](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/Fouling.vb): `VS2019_AdDesignS/ADS_VBnet_MV/Fouling.vb`

### Runtime and files

- [FORTRAN engine](https://github.com/usepa/addesigns/tree/main/VS2019_AdDesignS/digital_fortran_code/forcode): `VS2019_AdDesignS/digital_fortran_code/forcode`
- [File I/O](https://github.com/usepa/addesigns/blob/main/VS2019_AdDesignS/ADS_VBnet_MV/FileIO.vb): `VS2019_AdDesignS/ADS_VBnet_MV/FileIO.vb`
- [Application data](https://github.com/usepa/addesigns/tree/main/VS2019_AdDesignS/ADS_VBnet_MV/bin/dbase): `VS2019_AdDesignS/ADS_VBnet_MV/bin/dbase`

### Other components

- **User**

## Connections

- User → Main window: launches (evidence: `README.md`)
- Main window → FORTRAN engine: uses engine (evidence: `README.md`)
