# shahriar-0/artificial-intelligence-course-projects-s2023 architecture

> Architecture diagram of the GitHub repository shahriar-0/artificial-intelligence-course-projects-s2023, 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/shahriar-0/artificial-intelligence-course-projects-s2023
- Repository: https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023

## Overview

##### Main Components
- Course Projects Container – This is the overall “wrapper” for the repository.
- Individual Project Modules – Represent each numbered assignment:
- CA0: Introduction (Exploratory Data Analysis using Pandas, NumPy, and Matplotlib)
- CA1: Search Algorithms (Implementing search methods like BFS, IDS, and A* for a recipes graph problem)
- CA2: Genetic Algorithms (Investment decision making via genetic optimization)
- CA3: Game Minimax (Game playing using the minimax algorithm with alpha-beta pruning, tested on an Othello game)
- CA4: Naive Bayes (Different Naïve Bayes techniques for classification)
- CA5: Machine Learning (Multiple traditional ML models on a housing dataset with feature engineering and model evaluation)
- CA6: Neural Networks (Divided into two phases – Phase 1 using custom feedforward networks and PyTorch; Phase 2 using Keras/TensorFlow for CIFAR-10 classification)
- Supporting Materials – These include additional Python demo notebooks (for Pandas, Matplotlib, NumPy) and tutorial content outside of the course projects.
- Archives – Older versions or experimental builds (“Archive”, “Genetic-Archive”) that might indicate versioning or historical snapshots.

##### Relationships and Interactions
- Each module is essentially self-contained and includes its own Jupyter Notebook(s), asset subfolders (for data and introductory/description PDFs), test files, and supporting datasets. They do not interdepend on one another—each project functions independently.
- The Python directory (with “Demo_Materials”, “Matplotlib”, “Numpy”, “Pandas”) is a separate resource that provides learning examples or additional tutorial material for users to experiment with core Python data science libraries.
- Some modules have further sub-structure (e.g., CA6 has two phases) which should be depicted as nested components within the Neural Networks module.
- For each project, the flow is essentially from:
Input Data (CSV, PKL, etc.) → Algorithm/Notebook Implementation (e.g., search, minimax, ML model training) → Output (results stored or printed, sometimes described in asset files).
- The Assets directories show additional resources (e.g., PDFs for project description) that can be noted as “Documentation/Supporting Information” for that module.

##### Architectural Patterns or Design Principles
- Modular Design – Each assignment is a modular component that encapsulates a distinct AI algorithm or learning exercise.
- Separation of Concerns – The data exposition, algorithm logic, evaluation outputs, and documentation are well separated into individual subfolders within each module.
- Self-Contained Experimentation – Each module contains its own notebooks and datasets, enabling isolated testing and evaluation.
- Versioning/Archival – The “Archive” directories suggest iterative improvements or historical snapshots that can be depicted as a timeline or backup branch for reference.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Container for the entire course projects
    Container["Artificial Intelligence Course Projects"]:::container

    %% CA0 - Introduction
    subgraph "CA0 - Introduction (Exploratory Data Analysis)"
        CA0_A["CA0 Assets & Docs\n(Pandas, NumPy, Matplotlib)"]:::assets
        CA0_N["CA0 Notebook\n(Implementation)"]:::notebook
        CA0_O["CA0 Output\n(Results)"]:::output
        CA0_A -->|"Data Input"| CA0_N
        CA0_N -->|"Results"| CA0_O
    end

    %% CA1 - Search Algorithms
    subgraph "CA1 - Search Algorithms (BFS, IDS, A*)"
        CA1_A["CA1 Assets & Tests\n(Recipes Graph)"]:::assets
        CA1_N["CA1 Notebook\n(Algorithm Implementation)"]:::notebook
        CA1_O["CA1 Output\n(Test Results)"]:::output
        CA1_A -->|"Data Input"| CA1_N
        CA1_N -->|"Results"| CA1_O
    end

    %% CA2 - Genetic Algorithms
    subgraph "CA2 - Genetic Algorithms (Investment Optimization)"
        CA2_A["CA2 Assets & PDFs\n(Data & Documentation)"]:::assets
        CA2_N["CA2 Notebook\n(Genetic Optimization)"]:::notebook
        CA2_O["CA2 Output\n(Results)"]:::output
        CA2_A -->|"Data Input"| CA2_N
        CA2_N -->|"Results"| CA2_O
    end

    %% CA3 - Game Minimax
    subgraph "CA3 - Game Minimax (Minimax & Alpha-Beta Pruning)"
        CA3_A["CA3 Description Assets\n(Othello Game)"]:::assets
        CA3_N["CA3 Notebook\n(Minimax Implementation)"]:::notebook
        CA3_O["CA3 Output\n(Game Results)"]:::output
        CA3_A -->|"Data Input"| CA3_N
        CA3_N -->|"Results"| CA3_O
    end

    %% CA4 - Naive Bayes
    subgraph "CA4 - Naive Bayes (Classification)"
        CA4_A["CA4 Assets\n(Data & Description)"]:::assets
        CA4_N["CA4 Notebook\n(Naïve Bayes Techniques)"]:::notebook
        CA4_O["CA4 Output\n(Classification Results)"]:::output
        CA4_A -->|"Data Input"| CA4_N
        CA4_N -->|"Results"| CA4_O
    end

    %% CA5 - Machine Learning
    subgraph "CA5 - Machine Learning (Housing Dataset)"
        CA5_A["CA5 Assets\n(Housing Data & Docs)"]:::assets
        CA5_N["CA5 Notebook\n(ML Models & Evaluation)"]:::notebook
        CA5_O["CA5 Output\n(Model Results)"]:::output
        CA5_A -->|"Data Input"| CA5_N
        CA5_N -->|"Results"| CA5_O
    end

    %% CA6 - Neural Networks with two phases
    subgraph "CA6 - Neural Networks"
        %% Phase 1 Subgraph
        subgraph "Phase 1 (Custom Feedforward, PyTorch)"
            CA6_P1_A["CA6 Phase1 Assets\n(Data & Description)"]:::assets
            CA6_P1_N["CA6 Phase1 Notebook\n(Custom NN)"]:::notebook
            CA6_P1_O["CA6 Phase1 Output\n(Results)"]:::output
            CA6_P1_A -->|"Data Input"| CA6_P1_N
            CA6_P1_N -->|"Results"| CA6_P1_O
        end
        %% Phase 2 Subgraph
        subgraph "Phase 2 (Keras/TensorFlow for CIFAR-10)"
            CA6_P2_A["CA6 Phase2 Assets\n(Description)"]:::assets
            CA6_P2_N["CA6 Phase2 Notebook\n(Keras/TensorFlow NN)"]:::notebook
            CA6_P2_O["CA6 Phase2 Output\n(Classification Results)"]:::output
            CA6_P2_A -->|"Data Input"| CA6_P2_N
            CA6_P2_N -->|"Results"| CA6_P2_O
        end
    end

    %% Supporting Python Demo Materials and Tutorials
    subgraph "Python Resources (Demo & Tutorials)"
        Python_Demo["Demo Materials & Tutorials\n(Pandas, Matplotlib, NumPy)"]:::resources
    end

    %% Archives and Historical Snapshots
    subgraph "Archives"
        Archive_General["General Archive\n(V1, V2, V3)"]:::archive
        Archive_Genetic["Genetic Archive"]:::archive
    end

    %% Connections from Container to Modules
    Container --> CA0_A
    Container --> CA1_A
    Container --> CA2_A
    Container --> CA3_A
    Container --> CA4_A
    Container --> CA5_A
    Container --> CA6_P1_A
    Container --> CA6_P2_A
    Container --> Python_Demo
    Container --> Archive_General
    Container --> Archive_Genetic

    %% Click Events
    click Container "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/Repository Root"
    click CA0_N "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/blob/main/0 - Introduction/AI_CA0.ipynb"
    click CA0_A "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/0 - Introduction/assets"
    click CA1_N "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/blob/main/1 - Search Algorithms/AI_CA1.ipynb"
    click CA1_A "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/1 - Search Algorithms/assets"
    click CA2_N "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/blob/main/2 - Genetic Algorithms/AI_CA2.ipynb"
    click CA2_A "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/2 - Genetic Algorithms/assets"
    click CA3_N "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/blob/main/3 - Game Minimax/AI_CA3.ipynb"
    click CA3_A "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/3 - Game Minimax/assets/description"
    click CA4_N "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/blob/main/4 - Naive Bayes/AI_CA4.ipynb"
    click CA4_A "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/4 - Naive Bayes/assets"
    click CA5_N "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/blob/main/5 - Machine Learning/AI_CA5.ipynb"
    click CA5_A "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/5 - Machine Learning/assets"
    click CA6_P1_N "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/blob/main/6 - Neural Networks/phase 1/AI_CA6_P1.ipynb"
    click CA6_P1_A "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/6 - Neural Networks/phase 1/assets"
    click CA6_P2_N "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/blob/main/6 - Neural Networks/phase 2/AI_CA6_P2.ipynb"
    click CA6_P2_A "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/6 - Neural Networks/phase 2/assets"
    click Python_Demo "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/blob/main/Python/Demo_Materials/PythonForAI.ipynb"
    click Archive_General "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/Archive"
    click Archive_Genetic "https://github.com/shahriar-0/artificial-intelligence-course-projects-s2023/tree/main/Genetic-Archive"

    %% Styles
    classDef container fill:#BBDEFB,stroke:#0D47A1,stroke-width:2px;
    classDef module fill:#C8E6C9,stroke:#2E7D32,stroke-width:2px;
    classDef assets fill:#FFF9C4,stroke:#F57F17,stroke-width:2px;
    classDef notebook fill:#FFCDD2,stroke:#C62828,stroke-width:2px;
    classDef output fill:#D1C4E9,stroke:#5E35B1,stroke-width:2px;
    classDef resources fill:#B3E5FC,stroke:#0288D1,stroke-width:2px;
    classDef archive fill:#FFECB3,stroke:#FF6F00,stroke-width:2px;
```
