# hammilidi/diabete_prediction architecture

> Architecture diagram of the GitHub repository hammilidi/diabete_prediction, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hammilidi/diabete_prediction
- Repository: https://github.com/hammilidi/diabete_prediction

## Overview

##### Project type and purpose
- This is a data-science/ML pipeline project whose goal is to cluster patients by diabetes risk and then train a logistic-regression classifier (plus comparisons) to predict those clusters.
- The README confirms it’s a Python-based ML workflow: exploratory data analysis (EDA), preprocessing, clustering, model training with hyperparameter tuning (GridSearchCV), evaluation, and model persistence.

##### File structure
- Top-level directories:
- data/ – raw CSV dataset
- scripts/ – Jupyter notebooks and a preprocessing module
- models/ – serialized model artifact
- scripts/ contains:
- analyse_exploratoire.ipynb (EDA & visualization)
- preprocessing.py (data-cleaning, feature-engineering, cluster-creation functions)
- cluster.ipynb (cluster analysis)
- Models.ipynb (training + hyperparameter optimization)
- Test_models.ipynb (final evaluation)
- requirements.txt lists core libraries; no explicit deployment or service definitions.

##### README for additional insights
- Confirms use of pandas/numpy (data handling), scikit-learn & imblearn (modeling/pipelines), matplotlib/seaborn (plots).
- Describes methodology: outlier cleaning, normalization, cluster determination, GridSearchCV, cross-validation, model comparison, selection, serialization.

##### Key reminders
- Every stage—even if it’s a Jupyter notebook—as a distinct component
- Iterative loops (e.g., hyperparameter search) explicitly
- Labels map directly to files and functions in the repo for traceability

## Diagram (Mermaid)

```mermaid
flowchart TD
    Data["Raw Data\n(data/dataset.csv)"]:::data
    Pre["Preprocessing Module\n(scripts/preprocessing.py)"]:::pre
    EDA["EDA & Visualization\n(scripts/Analyse_exploratoire.ipynb)"]:::eda
    Cluster["Clustering Module\n(scripts/Cluster.ipynb)"]:::model
    Train["Model Training & Hyperparameter Tuning\n(scripts/Models.ipynb)"]:::model
    Eval["Model Evaluation\n(scripts/Test_models.ipynb)"]:::model
    Persist["Model Persistence\n(models/model.pkl)"]:::data

    Data -->|ingest raw CSV| Pre
    Pre -->|"perform cleaning\nfeature engineering"| EDA
    Pre -->|"create clusters"| Cluster
    Cluster -->|generate enriched dataset| Train
    Train -->|"train models\nGridSearchCV (5-fold CV)"| Train
    Train -->|"output best model"| Eval
    Eval -->|"evaluate performance"| Persist

    click Data "https://github.com/hammilidi/diabete_prediction/blob/sara/data/dataset.csv"
    click Pre "https://github.com/hammilidi/diabete_prediction/blob/sara/scripts/preprocessing.py"
    click EDA "https://github.com/hammilidi/diabete_prediction/blob/sara/scripts/Analyse_exploratoire.ipynb"
    click Cluster "https://github.com/hammilidi/diabete_prediction/blob/sara/scripts/Cluster.ipynb"
    click Train "https://github.com/hammilidi/diabete_prediction/blob/sara/scripts/Models.ipynb"
    click Eval "https://github.com/hammilidi/diabete_prediction/blob/sara/scripts/Test_models.ipynb"
    click Persist "https://github.com/hammilidi/diabete_prediction/blob/sara/models/model.pkl"

    classDef data fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef pre fill:#98FB98,stroke:#333,stroke-width:1px
    classDef eda fill:#DA70D6,stroke:#333,stroke-width:1px
    classDef model fill:#FFA500,stroke:#333,stroke-width:1px
```
