https://github.com/dead-tech/sim-os
Operating System GUI Simulator with custom simulation description language
https://github.com/dead-tech/sim-os
clang-format clang-tidy cmake cpp23 gui imgui-glfw implot mit-license operating-system simulator stb-image
Last synced: 2 months ago
JSON representation
Operating System GUI Simulator with custom simulation description language
- Host: GitHub
- URL: https://github.com/dead-tech/sim-os
- Owner: dead-tech
- License: mit
- Created: 2025-05-19T07:23:26.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-21T12:41:13.000Z (5 months ago)
- Last Synced: 2025-06-01T15:49:48.442Z (4 months ago)
- Topics: clang-format, clang-tidy, cmake, cpp23, gui, imgui-glfw, implot, mit-license, operating-system, simulator, stb-image
- Language: C++
- Homepage:
- Size: 266 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# sim-os
Operating System GUI Simulator with custom simulation description language.
This is supposed to be a suite of simulations to better grasp how an operating system works under the hood.
These are the planned/currently implemented simulations:
- [x] scheduler
- [ ] virtual memory
## Video
https://github.com/user-attachments/assets/0d1f474b-c30a-4c90-8175-ac33cef078e5
# Dependencies
- CMake
- GCC 14+
- OpenGL
- GLFW
- ImGui
- ImPlot
- stb_image.h
# Building
Build instructions are the same as all cmake projects:
```sh
git clone https://github.com/dead-tech/sim-os.git
```
```sh
cd sim-os/
```
```sh
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
```
```sh
cmake --build build
```
You will then find the following executables inside the build directory:
- scheduler
- comparator
## scheduler
This is a scheduler simulator. It expects you to give it a file to a simulation described in the custom simulation description language. See [sim-lang](#sim-lang) for more info.
These are the currently features that the scheduler supports:
- Stepping the simulation one timer tick at a time
- Restarting the simulation from the beginning
- Visualization of the: arrival, ready, waiting queues
- Visualization of running processes (supports multicore)
- Plotting of metrics like: cpu usage, waiting time, turnaround time and throughput
- Different kind of scheduling policy (at compile time though for now)
- Saving result of the simulation and the compare them with [comparator](#comparator)
- Changing the schedule policy at runtime (this way you can generate result on the same input for different policies and then compare them)
### comparator
This is a tool built to compare the result of the simulations produced by the scheduler (for now, planning on making it general purpose). It expects you to pass it to its CLI the simulation results files and it will compare them by graphing histograms.
## sim-lang
This is the language created to ease the description of a simulation, without touching the C++ code. The script will get interpreted just before the simulation is run.
Supported features:
- Specify the number of cores of the CPU
- Specify the max number of processes to spawn
- Specify the max number of events a single process might have
- Specify the max duration of a single event
- Specify the max arrival time for a process from the start of the timer
- Spawn random processes or custom processes
- Change the schedule policy
### Examples
For some examples on the syntax of the language checkout [examples](examples).