🎲 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

frekkoz3/Dice-Probability-Visualizer