# lavendercoder1129/cpu-scheduling-simulator architecture

> Architecture diagram of the GitHub repository lavendercoder1129/cpu-scheduling-simulator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lavendercoder1129/cpu-scheduling-simulator
- Repository: https://github.com/lavendercoder1129/cpu-scheduling-simulator

## Overview

This is an interactive CPU scheduling simulator: users choose a manual, CSV, or sample workload, provide a time quantum, run five algorithms, and view per-algorithm timelines, metrics, and a comparison. The graph preserves the documented algorithm and reporting capabilities. Source excerpts show the main orchestration and comparison rendering; some links involving unsampled implementations are omitted or marked unverified.

Main entry points: [`main.cpp`](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/main.cpp) (Simulation orchestration), [`src/SchedulingResult.cpp`](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/SchedulingResult.cpp) (Scheduling result), [`src/CLI.cpp`](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/CLI.cpp) (Interactive CLI), [`src/FCFSScheduler.cpp`](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/FCFSScheduler.cpp) (FCFS scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Workload input"]
  node_cli["Interactive CLI<br/>[CLI.cpp]"]
  node_workloads["CSV workload manager"]
  node_process["Process model<br/>[Process.cpp]"]
end

subgraph group_scheduling["Scheduling algorithms"]
  node_main["Simulation orchestration<br/>[main.cpp]"]
  node_fcfs["FCFS scheduler<br/>[FCFSScheduler.cpp]"]
  node_sjf["SJF scheduler<br/>[SJFScheduler.cpp]"]
  node_priority["Priority scheduler"]
  node_rr["Round Robin scheduler<br/>[RRScheduler.cpp]"]
  node_mlfq["MLFQ scheduler<br/>[MLFQScheduler.cpp]"]
end

subgraph group_results["Results and metrics"]
  node_result["Scheduling result"]
  node_chart["Gantt chart<br/>[GanttChart.cpp]"]
  node_statistics["Metric calculation<br/>[Statistics.cpp]"]
end

subgraph group_presentation["Result presentation"]
  node_detaildisplay["Detailed result display"]
  node_comparison["Algorithm comparison"]
end

node_user(("User"))

node_user -->|"selects input"| node_cli
node_main -->|"requests workload"| node_cli
node_cli -->|"loads CSV"| node_workloads
node_main -->|"runs schedule"| node_fcfs
node_main -->|"runs schedule"| node_sjf
node_main -->|"runs schedule"| node_priority
node_main -->|"runs schedule"| node_rr
node_main -->|"runs schedule"| node_mlfq
node_fcfs -->|"produces result"| node_result
node_sjf -->|"produces result"| node_result
node_priority -->|"produces result"| node_result
node_rr -->|"produces result"| node_result
node_mlfq -->|"produces result"| node_result
node_main -->|"displays metrics"| node_detaildisplay
node_main -->|"displays timeline"| node_chart
node_main -->|"displays comparison"| node_comparison
node_result -.->|"calculates metrics"| node_statistics

click node_cli "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/CLI.cpp"
click node_workloads "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/WorkloadManager.cpp"
click node_process "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/Process.cpp"
click node_main "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/main.cpp"
click node_fcfs "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/FCFSScheduler.cpp"
click node_sjf "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/SJFScheduler.cpp"
click node_priority "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/PriorityScheduler.cpp"
click node_rr "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/RRScheduler.cpp"
click node_mlfq "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/MLFQScheduler.cpp"
click node_result "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/SchedulingResult.cpp"
click node_chart "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/GanttChart.cpp"
click node_statistics "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/Statistics.cpp"
click node_detaildisplay "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/StatisticsDisplay.cpp"
click node_comparison "https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/ComparisonEngine.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_workloads,node_process,node_user toneBlue
class node_main,node_fcfs,node_sjf,node_priority,node_rr,node_mlfq toneAmber
class node_result,node_chart,node_statistics toneMint
class node_detaildisplay,node_comparison toneRose
```

## Components

### Workload input

- [Interactive CLI](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/CLI.cpp): `src/CLI.cpp`
- [CSV workload manager](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/WorkloadManager.cpp): `src/WorkloadManager.cpp`
- [Process model](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/Process.cpp): `src/Process.cpp`

### Scheduling algorithms

- [Simulation orchestration](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/main.cpp): `main.cpp`
- [FCFS scheduler](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/FCFSScheduler.cpp): `src/FCFSScheduler.cpp`
- [SJF scheduler](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/SJFScheduler.cpp): `src/SJFScheduler.cpp`
- [Priority scheduler](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/PriorityScheduler.cpp): `src/PriorityScheduler.cpp`
- [Round Robin scheduler](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/RRScheduler.cpp): `src/RRScheduler.cpp`
- [MLFQ scheduler](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/MLFQScheduler.cpp): `src/MLFQScheduler.cpp`

### Results and metrics

- [Scheduling result](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/SchedulingResult.cpp): `src/SchedulingResult.cpp`
- [Gantt chart](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/GanttChart.cpp): `src/GanttChart.cpp`
- [Metric calculation](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/Statistics.cpp): `src/Statistics.cpp`

### Result presentation

- [Detailed result display](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/StatisticsDisplay.cpp): `src/StatisticsDisplay.cpp`
- [Algorithm comparison](https://github.com/lavendercoder1129/cpu-scheduling-simulator/blob/main/src/ComparisonEngine.cpp): `src/ComparisonEngine.cpp`

### Other components

- **User**

## Connections

- User → Interactive CLI: selects input
- Simulation orchestration → Interactive CLI: requests workload (evidence: `main.cpp`)
- Interactive CLI → CSV workload manager: loads CSV (evidence: `src/CLI.cpp`)
- Simulation orchestration → FCFS scheduler: runs schedule (evidence: `main.cpp`)
- Simulation orchestration → SJF scheduler: runs schedule (evidence: `main.cpp`)
- Simulation orchestration → Priority scheduler: runs schedule (evidence: `main.cpp`)
- Simulation orchestration → Round Robin scheduler: runs schedule (evidence: `main.cpp`)
- Simulation orchestration → MLFQ scheduler: runs schedule (evidence: `main.cpp`)
- FCFS scheduler → Scheduling result: produces result (evidence: `src/FCFSScheduler.cpp`)
- SJF scheduler → Scheduling result: produces result (evidence: `src/SJFScheduler.cpp`)
- Priority scheduler → Scheduling result: produces result (evidence: `src/PriorityScheduler.cpp`)
- Round Robin scheduler → Scheduling result: produces result (evidence: `src/RRScheduler.cpp`)
- MLFQ scheduler → Scheduling result: produces result (evidence: `src/MLFQScheduler.cpp`)
- Simulation orchestration → Detailed result display: displays metrics (evidence: `main.cpp`)
- Simulation orchestration → Gantt chart: displays timeline (evidence: `main.cpp`)
- Simulation orchestration → Algorithm comparison: displays comparison (evidence: `main.cpp`)
- Scheduling result → Metric calculation: calculates metrics
