# aleenababy/ai-and-machine-learning-lecture architecture

> Architecture diagram of the GitHub repository aleenababy/ai-and-machine-learning-lecture, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aleenababy/ai-and-machine-learning-lecture
- Repository: https://github.com/aleenababy/ai-and-machine-learning-lecture

## Overview

##### Main Components
- A central “Learning Repository” or “Lecture Exercises” component which aggregates all exercise projects.
- Individual project directories that act as separate modules:
- Feature Engineering (with submodules for Starbucks customer data and reviews)
- Fraud detection
- Honey production
- KNN (with projects like breast cancer and movies prediction)
- Linear regression
- LogisticRegression (which itself contains a subproject for pumpkin prediction)
- Supporting components such as datasets, Jupyter notebooks, and data files.

##### Relationships and Interactions
- Central repository node connected to each individual project directory.
- Within each project module, illustrate the interaction between:
- Data sources (CSV files, .numbers files, etc.)
- Processing or analysis components (Jupyter notebooks, Python scripts for data cleaning or analysis)
- Although these projects are largely independent, highlight that they share common dependencies in terms of Python libraries and machine learning frameworks.

##### Architectural Patterns and Design Principles
- Modular nature of the repository — each exercise is self-contained.
- That many exercises follow a data input → processing/analysis (via notebooks/scripts) → output/visualization pattern.
- It is not a full-stack or microservices architecture; rather, it is an educational, modular structure emphasizing code experimentation and incremental learning.

##### Relevant Technologies and Frameworks
- Python (as the common language)
- Jupyter Notebooks as the primary interactive coding environment
- Common data manipulation libraries (like Pandas, NumPy) and machine learning libraries (scikit-learn, etc.) implied by the exercise topics

- Below, branch out to nodes for each independent project (Feature Engineering, Fraud detection, Honey production, etc.).
- For the “Feature Engineering” module, further branch into two sub-nodes: one for “Starbucks customer data” and one for “reviews”. For each, list related files (CSV, notebooks, etc.).
- Similarly, detail sub-components within the “LogisticRegression” node by showing its “pumpkin-prediction” folder containing CSV data and a corresponding notebook.

## Diagram (Mermaid)

```mermaid
flowchart TD
    A["AI and Machine Learning Lecture Exercises"]:::repo

    %% Main project modules
    A --> FE["Module: Feature Engineering"]:::module
    A --> FD["Module: Fraud detection"]:::module
    A --> HP["Module: Honey production"]:::module
    A --> KNN["Module: KNN"]:::module
    A --> LR["Module: Linear regression"]:::module
    A --> LGR["Module: LogisticRegression"]:::module

    %% Feature Engineering Submodules
    subgraph "Feature Engineering Subcomponents"
        direction TB
        SC["Component: Starbucks customer data"]:::module
        R["Component: Reviews"]:::module
    end
    FE --> SC
    FE --> R

    %% KNN Submodules
    subgraph "KNN Subcomponents"
        direction TB
        BC["Breast Cancer Notebook (brest_cancer.ipynb)"]:::notebook
        subgraph "Movies Prediction"
            direction TB
            MPData["Movies Data (CSV)"]:::data
            MPNotebook["Movies Notebook"]:::notebook
            MPData --> MPNotebook
        end
    end
    KNN --> BC
    KNN --> MPData

    %% LogisticRegression Submodules
    subgraph "LogisticRegression Subcomponents"
        direction TB
        BCs["Brest_Cancer_sklearn Notebook"]:::notebook
        PP["Pumpkin Prediction Module"]:::module
    end
    LGR --> BCs
    LGR --> PP

    %% Pumpkin Prediction In-depth
    subgraph "Pumpkin Prediction Details"
        direction TB
        USP["US-pumpkins.csv"]:::data
        LRP["Pumpkin Classification Notebook"]:::notebook
        USP --> LRP
    end
    PP --> USP
    PP --> LRP

    %% Click Events
    click A "https://github.com/aleenababy/ai-and-machine-learning-lecture/blob/main/README.md"
    click FE "https://github.com/aleenababy/ai-and-machine-learning-lecture/tree/main/Feature Engineering"
    click SC "https://github.com/aleenababy/ai-and-machine-learning-lecture/tree/main/Feature Engineering/Starbucks customer data"
    click R "https://github.com/aleenababy/ai-and-machine-learning-lecture/tree/main/Feature Engineering/reviews"
    click FD "https://github.com/aleenababy/ai-and-machine-learning-lecture/tree/main/Fraud detection"
    click HP "https://github.com/aleenababy/ai-and-machine-learning-lecture/tree/main/Honey production"
    click KNN "https://github.com/aleenababy/ai-and-machine-learning-lecture/tree/main/KNN"
    click BC "https://github.com/aleenababy/ai-and-machine-learning-lecture/blob/main/KNN/brest_cancer.ipynb"
    click MPData "https://github.com/aleenababy/ai-and-machine-learning-lecture/blob/main/KNN/movies_notebook.ipynb"
    click LR "https://github.com/aleenababy/ai-and-machine-learning-lecture/tree/main/Linear regression"
    click LGR "https://github.com/aleenababy/ai-and-machine-learning-lecture/tree/main/LogisticRegression"
    click BCs "https://github.com/aleenababy/ai-and-machine-learning-lecture/blob/main/LogisticRegression/Brest_Cancer_sklearn.ipynb"
    click PP "https://github.com/aleenababy/ai-and-machine-learning-lecture/tree/main/LogisticRegression/pumpkin-prediction"
    click USP "https://github.com/aleenababy/ai-and-machine-learning-lecture/blob/main/LogisticRegression/pumpkin-prediction/US-pumpkins.csv"
    click LRP "https://github.com/aleenababy/ai-and-machine-learning-lecture/blob/main/LogisticRegression/pumpkin-prediction/logistic-regression-pumpkin-classification.ipynb"

    %% Styles
    classDef repo fill:#cfe2ff,stroke:#333,stroke-width:2px;
    classDef module fill:#d9ead3,stroke:#333,stroke-width:1px;
    classDef data fill:#fff2cc,stroke:#333,stroke-width:1px;
    classDef notebook fill:#f4cccc,stroke:#333,stroke-width:1px;
```
