# jaganathn1996/diabetes-re-admission-prediction architecture

> Architecture diagram of the GitHub repository jaganathn1996/diabetes-re-admission-prediction, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jaganathn1996/diabetes-re-admission-prediction
- Repository: https://github.com/jaganathn1996/diabetes-re-admission-prediction

## Overview

##### Project type and purpose
- This is a data-science / machine-learning pipeline for “Diabetes Readmission Prediction.”
- Its goal is to ingest raw hospital data, perform ETL (extract-transform-load), exploratory analysis, preprocessing, train predictive models, and surface insights in a Jupyter notebook and summary document.

##### File structure
Top-level directories and files reveal an ML workflow:
- `src/ingest_data.py`
- Data ingestion factory for reading raw files.
- `data/`
- `data_loader.py`: raw data extraction (zip → CSV).
- `preprocessing.py`: cleaning, mapping, encoding.
- `extracted_data/`
- Persisted CSVs (`diabetic_data.csv`, `IDS_mapping.csv`).
- `analysis/analyze_src/basic_data_inspection.py`
- Exploratory data analysis (EDA) scripts.
- `diabetes_readmission_predection.ipynb`
- Orchestrates ingestion, cleaning, EDA, modeling, and visualizations.
- `models/model_trainer.py`
- Defines model training pipelines and evaluation.
- `Diabetes_Readmission_Summary.docx`
- Final findings and recommendations.
- `requirements.txt`
- Python dependencies (pandas, scikit-learn, matplotlib, jupyter, etc.).

##### README for additional insights
- Confirms high-level flow: ingest → inspect → preprocess → train → predict → analyze.
- Mentions key classes/functions and usage order.

a. Main components
1. Raw Data Storage (Zip file)
2. Data Ingestion Layer (`src/ingest_data.py`, `data/data_loader.py`)
3. Preprocessing Module (`data/preprocessing.py`)
4. Extracted Data Storage (`extracted_data/`)
5. Exploration & Analysis (`analysis/basic_data_inspection.py`, Jupyter notebook)
6. Model Training (`models/model_trainer.py`)
7. Reporting & Visualization (Notebook + Summary doc)

b. Relationships & data flow
- Raw ZIP → (Ingestion) → in-memory DataFrame
- DataFrame → (Preprocessing) → cleaned DataFrame → saved to `extracted_data/`
- Cleaned DataFrame → (EDA scripts & notebook) → summary stats, charts
- Cleaned DataFrame → (Model Trainer) → trained model artifacts + metrics
- Notebook reads model outputs + metrics → generates plots and writes summary doc

c. Architectural patterns / design principles
- Modular pipeline: each stage isolated in its own script
- Factory pattern in data ingestion (`DataIngestorFactory`)
- Separation of concerns: ingestion vs. preprocessing vs. analysis vs. modeling
- Artifact persistence between stages (`extracted_data` directory)

d. Key technologies / frameworks
- Python 3.x, pandas, NumPy (data manipulation)
- scikit-learn (modeling)
- Jupyter Notebook (interactive analysis)
- matplotlib / seaborn (visualization)
- pip / virtualenv (dependency management)

- Components as labeled rectangles (e.g., “Data Ingestor,” “Preprocessor,” “Model Trainer”).
- Blue for ingestion layer
- Green for preprocessing
- Yellow for analysis
- Orange for modeling
- Gray for storage/artifacts

##### Detailed yet concise representation
- Don’t over-compartmentalize; stick to these 6–7 core components.

## Diagram (Mermaid)

```mermaid
flowchart TD
    RawData(["Raw Data ZIP"]):::storage
    subgraph "Ingestion Layer"
        IF["Data Ingestor Factory"]:::ingestion
        DL["Data Loader"]:::ingestion
    end
    subgraph "Preprocessing Module"
        PP["Preprocessor"]:::preprocessing
    end
    subgraph "Extracted Data Storage"
        ED1["diabetic_data.csv"]:::storage
        ED2["IDS_mapping.csv"]:::storage
    end
    subgraph "Exploration & Analysis"
        EDA["EDA Script"]:::analysis
        NB["Jupyter Notebook"]:::analysis
    end
    MG["Model Trainer"]:::modeling
    subgraph "Reporting & Visualization"
        DOC["Summary Document"]:::analysis
    end

    RawData -->|"ZIP → DataFrame"| IF
    IF -->|"calls loader"| DL
    DL -->|"DataFrame"| PP
    PP -->|"Cleaned DataFrame → CSV"| ED1
    PP -->|"Cleaned DataFrame → CSV"| ED2
    ED1 -->|"CSV → DataFrame"| EDA
    ED2 -->|"CSV → DataFrame"| EDA
    ED1 -->|"CSV → DataFrame"| MG
    ED2 -->|"CSV → DataFrame"| MG
    EDA -->|"stats & charts"| NB
    MG -->|"trained_model.pkl + metrics"| NB
    NB -->|"writes report"| DOC

    click RawData "https://github.com/jaganathn1996/diabetes-re-admission-prediction/blob/main/data/diabetes+130-us+hospitals+for+years+1999-2008.zip"
    click IF "https://github.com/jaganathn1996/diabetes-re-admission-prediction/blob/main/src/ingest_data.py"
    click DL "https://github.com/jaganathn1996/diabetes-re-admission-prediction/blob/main/data/data_loader.py"
    click PP "https://github.com/jaganathn1996/diabetes-re-admission-prediction/blob/main/data/preprocessing.py"
    click ED1 "https://github.com/jaganathn1996/diabetes-re-admission-prediction/blob/main/extracted_data/diabetic_data.csv"
    click ED2 "https://github.com/jaganathn1996/diabetes-re-admission-prediction/blob/main/extracted_data/IDS_mapping.csv"
    click EDA "https://github.com/jaganathn1996/diabetes-re-admission-prediction/blob/main/analysis/analyze_src/basic_data_inspection.py"
    click NB "https://github.com/jaganathn1996/diabetes-re-admission-prediction/blob/main/diabetes_readmission_predection.ipynb"
    click MG "https://github.com/jaganathn1996/diabetes-re-admission-prediction/blob/main/models/model_trainer.py"
    click DOC "https://github.com/jaganathn1996/diabetes-re-admission-prediction/blob/main/Diabetes_Readmission_Summary.docx"

    classDef ingestion fill:#D0E8FF,stroke:#333,stroke-width:1px
    classDef preprocessing fill:#D0FFD6,stroke:#333,stroke-width:1px
    classDef analysis fill:#FFF5BA,stroke:#333,stroke-width:1px
    classDef modeling fill:#FFD8A8,stroke:#333,stroke-width:1px
    classDef storage fill:#E2E2E2,stroke:#333,stroke-width:1px
```
