How adibuzz/xgboost_early_readmission_paper works
This repository is a research workflow for predicting 28-day readmission with XGBoost. The user runs cross-validation first; it preprocesses the dataset, selects the fold with the highest test recall, and writes the selected features and indices for the second script. That script retrains the selected-feature model and reports evaluation metrics and visualizations, including SHAP feature importance. The graph reflects the two scripts and shared preprocessing; the dataset and generated files are runtime inputs and outputs, not repository modules.
Main entry points: final_refined_dataframe.py Final model run · main.py Cross-validation run · pre_processing_steps.py Data preprocessing
Components 13
Cross-validation
- Cross-validation run
main.py - Fold training and evaluation
main.py - Fold results
- Best-fold selection
main.py - Selected fold data
Final modeling
- Final model run
final_refined_dataframe.py - Selected-feature XGBoost
final_refined_dataframe.py - Test evaluation
final_refined_dataframe.py - Model interpretation
final_refined_dataframe.py - Evaluation plots
Shared preprocessing
- Data preprocessing
pre_processing_steps.py
Other components
- Researcher
- Clinical dataset
Connections 16
- Researcher → Cross-validation run: runs first
README.md - Researcher → Final model run: runs next
README.md - Clinical dataset → Cross-validation run: provides data
main.py - Cross-validation run → Data preprocessing: calls
main.py - Cross-validation run → Fold training and evaluation: runs folds
main.py - Fold training and evaluation → Best-fold selection: compares recall
main.py - Cross-validation run → Fold results: writes
main.py - Best-fold selection → Selected fold data: writes selection
main.py - Selected fold data → Final model run: provides selection
final_refined_dataframe.py - Clinical dataset → Final model run: provides data
final_refined_dataframe.py - Final model run → Data preprocessing: calls
final_refined_dataframe.py - Final model run → Selected-feature XGBoost: trains
final_refined_dataframe.py - Final model run → Test evaluation: evaluates
final_refined_dataframe.py - Final model run → Model interpretation: computes SHAP
final_refined_dataframe.py - Test evaluation → Evaluation plots: writes plots
final_refined_dataframe.py - Model interpretation → Evaluation plots: writes plot
final_refined_dataframe.py