# hamza7958/iris_data_science_project architecture

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

- Interactive diagram: https://gitdiagram.com/hamza7958/iris_data_science_project
- Repository: https://github.com/hamza7958/iris_data_science_project

## Overview

##### Project type and purpose
- This is a data-science / machine-learning project organized around a Jupyter Notebook (Iris_Program.ipynb).
- It loads the Iris dataset (iris_synthetic_data.csv), performs exploratory data analysis (EDA) and visualizations, applies multiple classification and clustering algorithms, optimizes an SVC model, and saves outputs (Figures/*.png, Model/optimized_svc_model.pkl).

##### File structure
- Top-level:
- Data/ (raw and cleaned CSVs)
- Figures/ (all generated plots and saved model pickle under an ill-named folder)
- Model/ (final optimized_svc_model.pkl)
- Iris_Program.ipynb (the orchestration of steps)
- README.md / README.pdf
- cleaned_data.csv (duplicate of Data/cleaned_data.csv)
- Key patterns:
- Data ingestion from CSVs
- Processing & EDA in notebook
- Model training & hyperparameter tuning
- Model serialization to pickle
- Visualization artifacts saved

##### Insights from the README
- Tech stack: Python, Pandas, NumPy, Matplotlib, Seaborn, scikit-learn, Jupyter Notebook
- Pipeline stages clearly spelled out: data loading → cleaning check → EDA/visualizations → supervised learning (multiple classifiers) → SVC optimization → evaluation (classification report, confusion matrix) → unsupervised clustering → cluster validation (Elbow, Silhouette)
- All outputs saved under Figures/ and Model/

a. Main components
1. Data Sources
- iris_synthetic_data.csv (source)
- cleaned_data.csv (intermediate)
2. Data Storage
- Local file system (Data/ folder, cleaned_data.csv)
3. Data Processing & EDA
- Jupyter Notebook (Iris_Program.ipynb)
- Libraries: Pandas, NumPy, Seaborn, Matplotlib
4. Feature Engineering & Preprocessing
- Handled inline in notebook (no separate module)
5. Modeling
- scikit-learn classifiers: SVC, KNN, Naive Bayes, XGB, Logistic Regression, Decision Tree
- Hyperparameter tuning for SVC
6. Model Storage
- Pickle file: Model/optimized_svc_model.pkl
7. Visualization & Reporting
- Figures/ (charts, classification report, confusion matrix)
8. User Interface
- Jupyter Notebook UI
9. External dependencies
- Python interpreter, scikit-learn, plotting libs

b. Relationships and interactions
- Notebook → passes preprocessed data to modeling routines
- Modeling → writes optimized model to Model/optimized_svc_model.pkl
- Notebook → writes visualization files to Figures/
- Notebook UI interacts bi-directionally with user (input parameters, view outputs)

c. Architectural patterns & principles
- Linear pipeline (ETL → modeling → output)
- File-based staging for reproducibility (cleaned_data.csv, pickles, images)
- Modular separation: data storage vs. processing vs. model artifacts vs. reports

d. Technologies, frameworks, libraries
- Data: CSV files, local FS
- Compute: Jupyter Notebook (orchestrator), Python3
- Processing & visualization: Pandas, NumPy, Matplotlib, Seaborn
- Modeling: scikit-learn, XGBoost
- Serialization: pickle format

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Data Sources
    subgraph "Data Sources" 
        direction TB
        RawCSV(("iris_synthetic_data.csv")):::data
        CleanedCSV(("cleaned_data.csv")):::data
        DuplicateCleaned(("cleaned_data.csv (duplicate)")):::data
    end

    %% Processing
    Notebook["Jupyter Notebook\nIris_Program.ipynb"]:::process

    %% Libraries
    subgraph "Libraries & Frameworks"
        direction TB
        Pandas(["Pandas"]):::external
        NumPy(["NumPy"]):::external
        Matplotlib(["Matplotlib"]):::external
        Seaborn(["Seaborn"]):::external
        Sklearn(["scikit-learn"]):::external
        XGBoost(["XGBoost"]):::external
    end

    %% Supervised Learning
    subgraph "Supervised Learning" 
        direction TB
        SVC["Classifier: SVC"]:::process
        KNN["Classifier: KNN"]:::process
        NB["Classifier: Naive Bayes"]:::process
        XGB["Classifier: XGB"]:::process
        LR["Classifier: Logistic Regression"]:::process
        DT["Classifier: Decision Tree"]:::process
    end

    %% Hyperparameter Tuning Loop
    subgraph "SVC Hyperparameter Tuning" 
        direction TB
        TunedSVC["Optimizing SVC"]:::process
    end

    %% Unsupervised Learning
    subgraph "Unsupervised Learning" 
        direction TB
        Clustering["Clustering Algorithms"]:::process
        ClusterValidation["Cluster Validation\n(Elbow, Silhouette)"]:::process
    end

    %% Outputs
    subgraph "Outputs & Artifacts"
        direction TB
        Figures["Figures/\nVisualizations & Reports"]:::artifact
        LegacyModel(("optimized_svc_model.pkl\n(legacy in Figures)")):::artifact
        ModelPickle(("optimized_svc_model.pkl")):::artifact
        Readme["README.md"]:::artifact
        ReadmePDF["README.pdf"]:::artifact
    end

    %% Flow
    RawCSV -->|load data| Notebook
    Notebook -->|clean & validate| CleanedCSV
    CleanedCSV -->|duplicate| DuplicateCleaned
    Notebook -->|EDA & visualizations| Figures
    Notebook -->|invoke classifiers| SVC
    Notebook -->|invoke classifiers| KNN
    Notebook -->|invoke classifiers| NB
    Notebook -->|invoke classifiers| XGB
    Notebook -->|invoke classifiers| LR
    Notebook -->|invoke classifiers| DT
    SVC -->|tuning loop| TunedSVC
    TunedSVC -->|save model| ModelPickle
    Notebook -->|save legacy model| LegacyModel
    Notebook -->|unsupervised learning| Clustering
    Clustering -->|validate clusters| ClusterValidation
    ClusterValidation -->|save visuals| Figures
    Notebook -->|uses| Pandas
    Notebook -->|uses| NumPy
    Notebook -->|uses| Matplotlib
    Notebook -->|uses| Seaborn
    Notebook -->|uses| Sklearn
    Notebook -->|uses| XGBoost
    Notebook -->|view & interact| Readme
    Notebook -->|view & interact| ReadmePDF

    %% Click Events
    click RawCSV "https://github.com/hamza7958/iris_data_science_project/blob/main/Data/iris_synthetic_data.csv"
    click CleanedCSV "https://github.com/hamza7958/iris_data_science_project/blob/main/Data/cleaned_data.csv"
    click DuplicateCleaned "https://github.com/hamza7958/iris_data_science_project/blob/main/cleaned_data.csv"
    click Notebook "https://github.com/hamza7958/iris_data_science_project/blob/main/Iris_Program.ipynb"
    click Figures "https://github.com/hamza7958/iris_data_science_project/tree/main/Figures/"
    click LegacyModel "https://github.com/hamza7958/iris_data_science_project/blob/main/Figures/optimized_svc_model.pkl"
    click ModelPickle "https://github.com/hamza7958/iris_data_science_project/blob/main/Model/optimized_svc_model.pkl"
    click Readme "https://github.com/hamza7958/iris_data_science_project/blob/main/README.md"
    click ReadmePDF "https://github.com/hamza7958/iris_data_science_project/blob/main/README.pdf"

    %% Styles
    classDef data fill:#AED6F1,stroke:#1B4F72,stroke-width:1px
    classDef process fill:#ABEBC6,stroke:#1D8348,stroke-width:1px
    classDef artifact fill:#F9E79F,stroke:#B9770E,stroke-width:1px
    classDef external fill:#D5DBDB,stroke:#566573,stroke-width:1px
```
