# ravikisha/cloudsim-examples architecture

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

- Interactive diagram: https://gitdiagram.com/ravikisha/cloudsim-examples
- Repository: https://github.com/ravikisha/cloudsim-examples

## Overview

##### Project type and purpose
- This is a standalone Java simulation tool built on top of the CloudSim library.
- Purpose: to simulate and compare different scheduling algorithms (Round Robin, FCFS, SJF, Genetic, ACO) in a cloud‐computing environment.

##### File structure
- lib/cloudsim-7.0.0-alpha.jar – the external CloudSim engine dependency
- src/CloudSimDemo.java – the entry point: initializes datacenter, VMs, cloudlets, accepts user algorithm choice, runs simulation
- src/Algorithms – package containing one class per scheduling strategy (implements a common interface/abstract class)

##### README for additional insights
- Core workflow:
1. Create Datacenter + VMs
2. Create Cloudlets (workload units)
3. User selects scheduling algorithm
4. Algorithm assigns Cloudlets → VMs
5. CloudSim engine runs the scenario and emits results
- Dependencies: Java 8+, CloudSim library

a. Main components
- User Interface (CLI prompt)
- CloudSim Engine (external library)
- Simulation Orchestrator (CloudSimDemo)
- VM Pool (provisioned VMs in Datacenter)
- Cloudlet Generator (creates tasks)
- Scheduling Algorithm Module (strategy pattern, one per algorithm)
- Output Module (collects and prints results)
b. Relationships & interactions
1. User → Simulation Orchestrator: selects algorithm
2. Orchestrator → CloudSim Engine: initializes datacenter, VMs, cloudlets
3. Orchestrator → Scheduling Module: passes VM list + cloudlet list
4. Scheduling Module → Orchestrator: returns assignment plan
5. Orchestrator → CloudSim Engine: submits plan and runs simulation
6. CloudSim Engine → Output Module: simulation events/results
7. Output Module → User: prints scheduling metrics
c. Architectural patterns & design principles
- Strategy pattern for pluggable scheduling algorithms
- Separation of concerns: orchestration vs. algorithm vs. simulation engine vs. I/O
- Dependency inversion: Scheduling modules depend on interfaces, not concrete orchestrator
d. Key technologies
- Java 8+
- CloudSim 7.0.0-alpha (JAR)
- Standard Java Collections & I/O

## Diagram (Mermaid)

```mermaid
flowchart TD
    User["User (CLI Prompt)"]:::blue
    subgraph "Core Modules"
        Orchestrator["Simulation Orchestrator\n(CloudSimDemo)"]:::blue
        subgraph "Scheduling Algorithms"
            Interface["SchedulingAlgorithm Interface"]:::blue
            FCFS["FCFSAlgorithm"]:::blue
            RR["RoundRobinAlgorithm"]:::blue
            SJF["SJFAlgorithm"]:::blue
            Genetic["GeneticAlgorithm"]:::blue
            ACO["ACOAlgorithm"]:::blue
        end
        Output["Output Module\n(Results Display)"]:::blue
    end
    ExtCloudSim["CloudSim Engine\n(lib/cloudsim-7.0.0-alpha.jar)"]:::green
    VMs["VM Pool & Datacenter"]:::yellow
    CLs["Cloudlet Generator"]:::yellow

    User -->|"select algorithm"| Orchestrator
    Orchestrator -->|"init Datacenter & VMs"| ExtCloudSim
    Orchestrator -->|"provision VMs"| VMs
    Orchestrator -->|"create Cloudlets"| CLs
    Orchestrator -->|"pass VM & Cloudlet lists"| Interface
    Interface -->|"assignment plan"| Orchestrator
    Orchestrator -->|"run simulation"| ExtCloudSim
    ExtCloudSim -->|"simulation results"| Output
    Output -->|"display metrics"| User

    click User "https://github.com/ravikisha/cloudsim-examples/blob/main/src/CloudSimDemo.java"
    click Orchestrator "https://github.com/ravikisha/cloudsim-examples/blob/main/src/CloudSimDemo.java"
    click ExtCloudSim "https://github.com/ravikisha/cloudsim-examples/blob/main/lib/cloudsim-7.0.0-alpha.jar"
    click FCFS "https://github.com/ravikisha/cloudsim-examples/blob/main/src/Algorithms/FCFSAlgorithm.java"
    click RR "https://github.com/ravikisha/cloudsim-examples/blob/main/src/Algorithms/RoundRobinAlgorithm.java"
    click SJF "https://github.com/ravikisha/cloudsim-examples/blob/main/src/Algorithms/SJFAlgorithm.java"
    click Genetic "https://github.com/ravikisha/cloudsim-examples/blob/main/src/Algorithms/GeneticAlgorithm.java"
    click ACO "https://github.com/ravikisha/cloudsim-examples/blob/main/src/Algorithms/ACOAlgorithm.java"
    click VMs "https://github.com/ravikisha/cloudsim-examples/blob/main/src/CloudSimDemo.java"
    click CLs "https://github.com/ravikisha/cloudsim-examples/blob/main/src/CloudSimDemo.java"
    click Output "https://github.com/ravikisha/cloudsim-examples/blob/main/src/CloudSimDemo.java"

    classDef blue fill:#D6EAF8,stroke:#2980B9,color:#154360;
    classDef green fill:#D5F5E3,stroke:#27AE60,color:#145A32;
    classDef yellow fill:#FCF3CF,stroke:#B7950B,color:#7D6608;
```
