🎲 Dice Distribution Visualizer

An interactive Python GUI application to simulate dice rolls and visualize probability distributions, comparing empirical results with the exact theoretical distribution.

The project is designed to be:

• simple
• modular
• extensible (2D now, 3D later)

---

✨ Features

• 🎲 Define arbitrary dice sets (e.g. 2D6, 3D4 1D20)
• 🔁 Roll dice interactively or run large Monte Carlo simulations
• 📊 Live histogram of simulated sums
• 📈 Exact theoretical distribution overlay (via convolution)

---

📸 What you see

• Bars: empirical distribution from simulations
• Line: exact probability distribution
• As simulations increase, the bars converge to the line (law of large numbers)

---

🧠 Architecture Overview

    DICE PROBABILITY VISUALIZER/
    │
    ├── source/
        ├── dice_set.py   # Dice and DiceSet logic
        └── viz.py        # PyQt6 GUI
    ├── main.py           # Main file to run the application
    └── README.md

---

Core concepts

• Dice: single die (e.g. D6, D20)

• DiceSet: collection of dice with:

  • rolling
  • simulation
  • exact distribution computation

---

🚀 Installation

Requirements:

• Python ≥ 3.9

    pip install numpy pyqt6 pyqtgraph

---

▶️ Running the app

    py main.py