# tharunmellow2007-wq/parkinson-s-disease-screening-system architecture

> Architecture diagram of the GitHub repository tharunmellow2007-wq/parkinson-s-disease-screening-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tharunmellow2007-wq/parkinson-s-disease-screening-system
- Repository: https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system
- Video tour (about a minute): https://gitdiagram.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/video

## Overview

This is a Gradio voice-analysis application for Parkinson’s disease detection and four-stage classification. Users record or upload audio, select noise reduction, and receive biomarker results; stage classification then presents clinical descriptions, symptoms, recommendations, and visual references. The runtime is concentrated in app.py, with model artifacts under models/. The README documents preprocessing and analysis capabilities not fully visible in the sampled excerpts, so those components are shown at the documented level; wiring beyond that is omitted.

Main entry points: [`app.py`](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py) (Disease detection), [`models/parkinsons_ensemble_model.pkl`](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/models/parkinsons_ensemble_model.pkl) (Ensemble model), [`models/feature_scaler.pkl`](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/models/feature_scaler.pkl) (Feature scaler), [`models/feature_info.json`](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/models/feature_info.json) (Feature metadata)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_gradio_ui["Gradio interface<br/>[app.py]"]
  node_audio_input["Audio input<br/>[app.py]"]
end

subgraph group_analysis["Voice analysis"]
  node_preprocess["Audio preprocessing<br/>[app.py]"]
  node_biomarkers["Biomarker extraction<br/>[app.py]"]
end

subgraph group_inference["Classification"]
  node_disease_detect["Disease detection<br/>[app.py]"]
  node_stage_classify["Stage classification<br/>[app.py]"]
  node_model_loader["Model loading<br/>[app.py]"]
  node_ensemble["Ensemble model"]
  node_scaler["Feature scaler<br/>[feature_scaler.pkl]"]
  node_feature_info["Feature metadata<br/>[feature_info.json]"]
end

subgraph group_presentation["Clinical results"]
  node_clinical_results["Clinical results<br/>[app.py]"]
  node_stage_images["Stage references"]
end

node_user(("User"))

node_user -->|"uses"| node_gradio_ui
node_gradio_ui -->|"accepts audio"| node_audio_input
node_audio_input -->|"submits audio"| node_preprocess
node_preprocess -->|"extracts from"| node_biomarkers
node_biomarkers -->|"provides features"| node_disease_detect
node_disease_detect -->|"triggers"| node_stage_classify
node_model_loader -->|"loads"| node_ensemble
node_model_loader -->|"loads"| node_scaler
node_model_loader -->|"loads"| node_feature_info
node_disease_detect -->|"uses model"| node_model_loader
node_stage_classify -->|"produces results"| node_clinical_results
node_disease_detect -->|"produces results"| node_clinical_results
node_clinical_results -->|"loads references"| node_stage_images
node_clinical_results -->|"renders"| node_gradio_ui

click node_gradio_ui "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py"
click node_audio_input "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py"
click node_preprocess "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py"
click node_biomarkers "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py"
click node_disease_detect "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py"
click node_stage_classify "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py"
click node_model_loader "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py"
click node_ensemble "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/models/parkinsons_ensemble_model.pkl"
click node_scaler "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/models/feature_scaler.pkl"
click node_feature_info "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/models/feature_info.json"
click node_clinical_results "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py"
click node_stage_images "https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/tree/main/images"

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_gradio_ui,node_audio_input,node_user toneBlue
class node_preprocess,node_biomarkers toneAmber
class node_disease_detect,node_stage_classify,node_model_loader,node_ensemble,node_scaler,node_feature_info toneMint
class node_clinical_results,node_stage_images toneRose
```

## Components

### User interface

- [Gradio interface](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py): `app.py`
- [Audio input](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py): `app.py`

### Voice analysis

- [Audio preprocessing](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py): `app.py`
- [Biomarker extraction](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py): `app.py`

### Classification

- [Disease detection](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py): `app.py`
- [Stage classification](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py): `app.py`
- [Model loading](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py): `app.py`
- [Ensemble model](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/models/parkinsons_ensemble_model.pkl): `models/parkinsons_ensemble_model.pkl`
- [Feature scaler](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/models/feature_scaler.pkl): `models/feature_scaler.pkl`
- [Feature metadata](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/models/feature_info.json): `models/feature_info.json`

### Clinical results

- [Clinical results](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/blob/main/app.py): `app.py`
- [Stage references](https://github.com/tharunmellow2007-wq/parkinson-s-disease-screening-system/tree/main/images): `images`

### Other components

- **User**

## Connections

- User → Gradio interface: uses
- Gradio interface → Audio input: accepts audio
- Audio input → Audio preprocessing: submits audio
- Audio preprocessing → Biomarker extraction: extracts from
- Biomarker extraction → Disease detection: provides features
- Disease detection → Stage classification: triggers
- Model loading → Ensemble model: loads
- Model loading → Feature scaler: loads
- Model loading → Feature metadata: loads
- Disease detection → Model loading: uses model
- Stage classification → Clinical results: produces results
- Disease detection → Clinical results: produces results
- Clinical results → Stage references: loads references
- Clinical results → Gradio interface: renders