# ahmed-al-azzawi/hplc-method-development-engine architecture

> Architecture diagram of the GitHub repository ahmed-al-azzawi/hplc-method-development-engine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahmed-al-azzawi/hplc-method-development-engine
- Repository: https://github.com/ahmed-al-azzawi/hplc-method-development-engine

## Overview

This is a Streamlit HPLC method-development application with separate isocratic and gradient optimization engines. Users select an engine, provide chromatographic run data and conditions, and review analyses or optimization guidance; the isocratic app also exposes column-inventory editing and a run-history flowchart. The README documents Shimadzu LabSolutions CSV compatibility and an HTML alternative. The excerpts establish navigation and the gradient engine’s use of shared analysis functions, but do not show the full upload-to-result flow or how inventory settings are consumed.

Main entry points: [`pages/Engine.py`](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Engine.py) (Isocratic engine), [`app.py`](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/app.py) (Engine selection), [`pages/Gradient Engine.py`](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Gradient%20Engine.py) (Gradient engine), [`pages/View Flowchart.py`](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/View%20Flowchart.py) (Run-history flowchart)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_home["Engine selection<br/>[app.py]"]
end

subgraph group_isocratic["Isocratic optimization"]
  node_iso["Isocratic engine<br/>[Engine.py]"]
  node_efficiency["Efficiency analysis<br/>[Engine.py]"]
end

subgraph group_gradient["Gradient optimization"]
  node_gradient["Gradient engine<br/>[Gradient Engine.py]"]
  node_analysis["Shared chromatogram analysis<br/>[Engine.py]"]
end

subgraph group_support["Method support"]
  node_inventory["Column inventory editor"]
  node_flowchart["Run-history flowchart<br/>[View Flowchart.py]"]
end

node_user(("Chromatography user"))
node_csv["LabSolutions CSV"]

node_user -->|"selects engine"| node_home
node_home -->|"opens page"| node_iso
node_home -->|"opens page"| node_gradient
node_user -.->|"provides run data"| node_iso
node_csv -.->|"compatible input"| node_iso
node_iso -->|"evaluates options"| node_efficiency
node_gradient -->|"imports analysis functions"| node_analysis
node_user -.->|"provides conditions"| node_gradient
node_user -.->|"edits columns"| node_inventory
node_user -.->|"views history"| node_flowchart
node_iso -.->|"shares run history"| node_flowchart

click node_home "https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/app.py"
click node_iso "https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Engine.py"
click node_efficiency "https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Engine.py"
click node_gradient "https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Gradient%20Engine.py"
click node_inventory "https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Edit%20Column%20Inventory.py"
click node_flowchart "https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/View%20Flowchart.py"
click node_analysis "https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Engine.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_home,node_user toneBlue
class node_iso,node_efficiency toneAmber
class node_gradient,node_analysis toneMint
class node_inventory,node_flowchart toneRose
class node_csv toneIndigo
```

## Components

### Application entry

- [Engine selection](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/app.py): `app.py`

### Isocratic optimization

- [Isocratic engine](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Engine.py): `pages/Engine.py`
- [Efficiency analysis](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Engine.py): `pages/Engine.py`

### Gradient optimization

- [Gradient engine](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Gradient%20Engine.py): `pages/Gradient Engine.py`
- [Shared chromatogram analysis](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Engine.py): `pages/Engine.py`

### Method support

- [Column inventory editor](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/Edit%20Column%20Inventory.py): `pages/Edit Column Inventory.py`
- [Run-history flowchart](https://github.com/ahmed-al-azzawi/hplc-method-development-engine/blob/main/pages/View%20Flowchart.py): `pages/View Flowchart.py`

### Other components

- **Chromatography user**
- **LabSolutions CSV**

## Connections

- Chromatography user → Engine selection: selects engine (evidence: `app.py`)
- Engine selection → Isocratic engine: opens page (evidence: `app.py`)
- Engine selection → Gradient engine: opens page (evidence: `app.py`)
- Chromatography user → Isocratic engine: provides run data (evidence: `README.md`)
- LabSolutions CSV → Isocratic engine: compatible input (evidence: `README.md`)
- Isocratic engine → Efficiency analysis: evaluates options (evidence: `pages/Engine.py`)
- Gradient engine → Shared chromatogram analysis: imports analysis functions (evidence: `pages/Gradient Engine.py`)
- Chromatography user → Gradient engine: provides conditions (evidence: `pages/Gradient Engine.py`)
- Chromatography user → Column inventory editor: edits columns
- Chromatography user → Run-history flowchart: views history
- Isocratic engine → Run-history flowchart: shares run history
