DESK — Discrete Event Simulation Kit

🚀 Getting Started

Installation

🛠️ Requirements

• Python >= 3.10 <= 3.13
• simpy == 4.1.1
• numpy == 2.2.6
• pandas == 2.3.1
• scipy == 1.15.3
• matplotlib == 3.10.5

Optional (for process mining):

• R >= 4.0
• BupaR
• processanimateR

Installation

🪟 Windows (PowerShell / VS Code / Cursor )

1) Clone the DESK repository

git clone https://github.com/joaoflavioufmg/desk.git

2) Enter the project directory

cd desk

3) Create a virtual environment

py -3.13 -m venv venv

4) Allow PowerShell to activate virtual environments (run once per machine)

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

5) Activate the virtual environment

.\venv\Scripts\Activate.ps1

6) Upgrade pip inside the virtual environment

py -m pip install --upgrade pip

7) Install DESK and its dependencies

pip install .

8) Verify that DESK and DESK-DISTFIT were installed correctly

desk-sim -h

desk-distfit -h

9) Run the hospital example with visualization

desk-sim -m examples/hospital.py --mode visualization

10) Run desk-distfit with some data

desk-distfit -d input_data/data10.txt

🐧 Linux / macOS (Terminal)

1) Clone the DESK repository

git clone https://github.com/joaoflavioufmg/desk.git

2) Enter the project directory

cd desk

3) Create a virtual environment

python -3.13 -m venv venv

4) Activate the virtual environment

source venv/bin/activate

5) Upgrade pip inside the virtual environment

python -m pip install --upgrade pip

6) Install DESK and its dependencies

pip install .

7) Verify that DESK and DESK-DISTFIT were installed correctly

desk-sim -h

desk-distfit -h

8) Run the hospital example with visualization

desk-sim -m examples/hospital.py --mode visualization

9) Run desk-distfit with some data

desk-distfit -d input_data/data10.txt