How arifakokab/parkinsons-vocal-biomarker-app works
This repository documents two Parkinson’s voice-analysis workflows: a feature-based screening classifier and a longitudinal severity-change predictor. The screening notebook covers model development; the README describes a separate deployed app that processes short recordings and returns a thresholded result. The progression notebook covers visit-level sequence modeling and evaluation. Notebook internals are not available as source excerpts, so component-level relationships below rely on the README’s documented methods and workflow.
Main entry points: ClassifierScreener_ParkinsonsDisease_Notebook1of2.ipynb Random Forest · ProgressionOfSeverity_ParkinsonsDisease_Notebook2of2.ipynb Severity change
Components 18
Screening classifier
- Oxford detection data
- Dysphonia features
Classifier Model (part 1 of 2)/ClassifierScreener_ParkinsonsDisease_Notebook1of2.ipynb - Random Forest
Classifier Model (part 1 of 2)/ClassifierScreener_ParkinsonsDisease_Notebook1of2.ipynb - Classifier evaluation
Classifier Model (part 1 of 2)/ClassifierScreener_ParkinsonsDisease_Notebook1of2.ipynb
Deployed screening
- Screening web app
- Audio preparation
- Audio feature extraction
- Thresholded result
Severity progression
- Oxford telemonitoring data
- Visit aggregation
Severity Predictor (Part 2 of 2)/ProgressionOfSeverity_ParkinsonsDisease_Notebook2of2.ipynb - Subject normalization
Severity Predictor (Part 2 of 2)/ProgressionOfSeverity_ParkinsonsDisease_Notebook2of2.ipynb - Visit sequences
Severity Predictor (Part 2 of 2)/ProgressionOfSeverity_ParkinsonsDisease_Notebook2of2.ipynb - BiGRU CNN model
Severity Predictor (Part 2 of 2)/ProgressionOfSeverity_ParkinsonsDisease_Notebook2of2.ipynb - Severity change
Severity Predictor (Part 2 of 2)/ProgressionOfSeverity_ParkinsonsDisease_Notebook2of2.ipynb - Reconstructed severity
Severity Predictor (Part 2 of 2)/ProgressionOfSeverity_ParkinsonsDisease_Notebook2of2.ipynb
Evaluation and interpretation
- Held-out evaluation
Severity Predictor (Part 2 of 2)/ProgressionOfSeverity_ParkinsonsDisease_Notebook2of2.ipynb - Change thresholds
Severity Predictor (Part 2 of 2)/ProgressionOfSeverity_ParkinsonsDisease_Notebook2of2.ipynb
Other components
- Voice recorder
Connections 17
- Oxford detection data → Dysphonia features: provides features
- Dysphonia features → Random Forest: trains
- Random Forest → Classifier evaluation: evaluated as
- Voice recorder → Screening web app: records audio
- Screening web app → Audio preparation: submits audio
- Audio preparation → Audio feature extraction: normalizes audio
- Audio feature extraction → Screening web app: provides features
- Screening web app → Thresholded result: runs inference
- Random Forest → Screening web app: supplies model
- Oxford telemonitoring data → Visit aggregation: provides visits
- Visit aggregation → Subject normalization: aggregates visits
- Subject normalization → Visit sequences: normalizes features
- Visit sequences → BiGRU CNN model: supplies sequences
- BiGRU CNN model → Severity change: predicts change
- Severity change → Reconstructed severity: reconstructs score
- Reconstructed severity → Held-out evaluation: evaluated on
- Severity change → Change thresholds: compared with thresholds