# surajjha0244/hvit-for-medical-image-diagonosis architecture

> Architecture diagram of the GitHub repository surajjha0244/hvit-for-medical-image-diagonosis, 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/surajjha0244/hvit-for-medical-image-diagonosis
- Repository: https://github.com/surajjha0244/hvit-for-medical-image-diagonosis

## Overview

This is a Django research prototype for multi-modal medical-image classification, with confidence-aware interpretation and a web interface for viewing diagnoses and reports. The documented workflow runs from image submission through preprocessing and hybrid CNN/ViT classification to interpretation and presentation; the views also support account, history, reporting, and feedback features. The graph uses the primary `Diagnosis` app, not the duplicate `Traning Code` copy. README statements support the model-stage relationships; source excerpts show URL routing and some record operations. Several internals are unsampled, so those links are omitted or marked unverified.

Main entry points: [`medical_image/Diagnosis/views.py`](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py) (Request handlers), [`medical_image/Diagnosis/urls.py`](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/urls.py) (App routes), [`medical_image/templates/Diagnosis/explainability.html`](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/templates/Diagnosis/explainability.html) (Explainability pages), [`medical_image/models`](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/tree/main/medical_image/models) (Model weights)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_routes["App routes<br/>[urls.py]"]
  node_views["Request handlers<br/>[views.py]"]
  node_pages["Web pages"]
end

subgraph group_diagnosis["Diagnosis workflow"]
  node_preprocess["Image preprocessing<br/>[views.py]"]
  node_cnn["CNN features<br/>[views.py]"]
  node_tokens["Patch projection<br/>[views.py]"]
  node_transformer["Transformer encoder<br/>[views.py]"]
  node_classifier["Classification head<br/>[views.py]"]
  node_weights["Model weights"]
end

subgraph group_interpretation["Interpretation"]
  node_caci["Clinical interpretation<br/>[views.py]"]
  node_xai["Explainability logic<br/>[xai.py]"]
  node_explainhub["Explainability pages"]
end

subgraph group_records["Records and services"]
  node_records[("Diagnosis records<br/>[models.py]")]
  node_reporting["Reports and history<br/>[views.py]"]
  node_account[("Accounts and feedback<br/>[models.py]")]
end

node_user(("Image submitter"))

node_user -->|"submits image"| node_routes
node_routes -->|"routes requests"| node_views
node_views -.->|"renders pages"| node_pages
node_views -->|"processes image"| node_preprocess
node_preprocess -->|"extracts features"| node_cnn
node_cnn -->|"tokenizes features"| node_tokens
node_tokens -->|"projects tokens"| node_transformer
node_transformer -->|"classifies features"| node_classifier
node_classifier -->|"interprets prediction"| node_caci
node_caci -->|"presents interpretation"| node_explainhub
node_views -->|"creates and deletes"| node_records
node_views -->|"serves reports"| node_reporting
node_views -.->|"handles account flows"| node_account
node_weights -.->|"provides parameters"| node_classifier
node_xai -.->|"supports explanations"| node_explainhub

click node_routes "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/urls.py"
click node_views "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py"
click node_pages "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/tree/main/medical_image/templates/Diagnosis"
click node_preprocess "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py"
click node_cnn "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py"
click node_tokens "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py"
click node_transformer "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py"
click node_classifier "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py"
click node_weights "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/tree/main/medical_image/models"
click node_caci "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py"
click node_xai "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/xai.py"
click node_explainhub "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/templates/Diagnosis/explainability.html"
click node_records "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/models.py"
click node_reporting "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py"
click node_account "https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/models.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_routes,node_views,node_pages toneBlue
class node_preprocess,node_cnn,node_tokens,node_transformer,node_classifier,node_weights toneAmber
class node_caci,node_xai,node_explainhub toneMint
class node_records,node_reporting,node_account toneRose
class node_user toneIndigo
```

## Components

### Web experience

- [App routes](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/urls.py): `medical_image/Diagnosis/urls.py`
- [Request handlers](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py): `medical_image/Diagnosis/views.py`
- [Web pages](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/tree/main/medical_image/templates/Diagnosis): `medical_image/templates/Diagnosis`

### Diagnosis workflow

- [Image preprocessing](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py): `medical_image/Diagnosis/views.py`
- [CNN features](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py): `medical_image/Diagnosis/views.py`
- [Patch projection](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py): `medical_image/Diagnosis/views.py`
- [Transformer encoder](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py): `medical_image/Diagnosis/views.py`
- [Classification head](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py): `medical_image/Diagnosis/views.py`
- [Model weights](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/tree/main/medical_image/models): `medical_image/models`

### Interpretation

- [Clinical interpretation](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py): `medical_image/Diagnosis/views.py`
- [Explainability logic](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/xai.py): `medical_image/Diagnosis/xai.py`
- [Explainability pages](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/templates/Diagnosis/explainability.html): `medical_image/templates/Diagnosis/explainability.html`

### Records and services

- [Diagnosis records](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/models.py): `medical_image/Diagnosis/models.py`
- [Reports and history](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/views.py): `medical_image/Diagnosis/views.py`
- [Accounts and feedback](https://github.com/surajjha0244/hvit-for-medical-image-diagonosis/blob/main/medical_image/Diagnosis/models.py): `medical_image/Diagnosis/models.py`

### Other components

- **Image submitter**

## Connections

- Image submitter → App routes: submits image (evidence: `README.md`)
- App routes → Request handlers: routes requests (evidence: `medical_image/Diagnosis/urls.py`)
- Request handlers → Web pages: renders pages
- Request handlers → Image preprocessing: processes image (evidence: `README.md`)
- Image preprocessing → CNN features: extracts features (evidence: `README.md`)
- CNN features → Patch projection: tokenizes features (evidence: `README.md`)
- Patch projection → Transformer encoder: projects tokens (evidence: `README.md`)
- Transformer encoder → Classification head: classifies features (evidence: `README.md`)
- Classification head → Clinical interpretation: interprets prediction (evidence: `README.md`)
- Clinical interpretation → Explainability pages: presents interpretation (evidence: `README.md`)
- Request handlers → Diagnosis records: creates and deletes (evidence: `medical_image/Diagnosis/views.py`)
- Request handlers → Reports and history: serves reports (evidence: `medical_image/Diagnosis/urls.py`)
- Request handlers → Accounts and feedback: handles account flows (evidence: `medical_image/Diagnosis/views.py`)
- Model weights → Classification head: provides parameters
- Explainability logic → Explainability pages: supports explanations
