How bitfatmonkey/hospital-readmission-prediction works
This is an educational, reproducible hospital-readmission modelling project—not a deployed clinical service. Its main workflow loads the bundled UCI data, defines a discharge-time cohort, creates patient-separated holdouts and training folds, fits and selects models, then evaluates the selected model and explains its predictions. The graph also preserves the project’s EDA, subgroup analysis, reusable local inference, and reproducibility outputs. Edges reflect shown calls or repository references; unsampled implementation details are not expanded.
Main entry points: run.py Experiment runner · notebooks.py Analysis notebooks · data.py Dataset loader · config.py Experiment settings
Components 16
Data and cohort
- Dataset loader
hospital_readmission/data.py - Clinical cohort
hospital_readmission/cohort.py - Patient-aware splits
hospital_readmission/splitting.py
Modelling
- Clinical features
hospital_readmission/features.py - Model training
hospital_readmission/modelling.py
Evaluation and analysis
- Metrics and thresholding
hospital_readmission/evaluation.py - EDA and reports
hospital_readmission/reporting.py - SHAP explanations
hospital_readmission/explain.py - Analysis notebooks
hospital_readmission/notebooks.py
Reproducibility and inference
- Experiment settings
hospital_readmission/config.py - Experiment runner
hospital_readmission/run.py - Local prediction
hospital_readmission/predict.py - Results documentation
hospital_readmission/documentation.py - Measured reports
reports - Saved model artifacts
Other components
- Bundled UCI archive
data/raw/diabetes+130-us+hospitals+for+years+1999-2008.zip
Connections 21
- Bundled UCI archive → Dataset loader: loads archive
README.md - Experiment runner → Dataset loader: loads data
hospital_readmission/run.py - Dataset loader → Clinical cohort: provides dataset
hospital_readmission/cohort.py - Experiment runner → Clinical cohort: builds cohort
hospital_readmission/run.py - Experiment runner → Patient-aware splits: creates splits
hospital_readmission/run.py - Experiment runner → Experiment settings: uses settings
hospital_readmission/run.py - Experiment runner → Model training: tunes models
hospital_readmission/run.py - Model training → Clinical features: uses preprocessing
hospital_readmission/modelling.py - Experiment runner → Metrics and thresholding: evaluates predictions
hospital_readmission/run.py - Experiment runner → EDA and reports: generates reports
hospital_readmission/run.py - Experiment runner → SHAP explanations: explains selected model
hospital_readmission/run.py - SHAP explanations → EDA and reports: uses report utilities
hospital_readmission/explain.py - Experiment runner → Measured reports: writes results
hospital_readmission/run.py - Experiment runner → Saved model artifacts: saves fitted models
hospital_readmission/run.py - Local prediction → Experiment settings: uses project settings
hospital_readmission/predict.py - Analysis notebooks → Dataset loader: loads dataset
hospital_readmission/notebooks.py - Analysis notebooks → Clinical cohort: uses cohort
hospital_readmission/notebooks.py - Analysis notebooks → Patient-aware splits: uses patient splits
hospital_readmission/notebooks.py - Analysis notebooks → Experiment settings: uses settings
hospital_readmission/notebooks.py - Results documentation → Experiment settings: uses project root
hospital_readmission/documentation.py - Results documentation → Measured reports: reads measured results
hospital_readmission/documentation.py