real-dice: Random number generation based on physical media touched by humans
This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.
This package provides random data gathered via human interaction with the physical world as well as utilities to leverage this data for random number generation and other RNG-based tasks
[Skip to Readme]
Properties
| Versions | 0.1.0.0, 0.1.0.1, 0.1.0.2, 0.1.0.3, 0.1.0.4, 0.1.0.5 |
|---|---|
| Change log | CHANGELOG.md |
| Dependencies | base (>=4.12.0.0 && <4.22), mtl (>=2.2.2 && <2.4), primes (>=0.2.1 && <0.3), random (>=1.2.1 && <1.4), real-dice [details] |
| License | MIT |
| Copyright | 2024 Kyle Beechly |
| Author | Kyle Beechly |
| Maintainer | contact@kaBeech.com |
| Category | Math, Data |
| Home page | https://github.com/kaBeech/real-dice |
| Source repo | head: git clone https://github.com/kaBeech/real-dice |
| Uploaded | by kaBeech at 2025-01-07T22:44:14Z |
Modules
- RealDice
- RealDice.Coin
- RealDice.Convert
- RealDice.Convert.BinaryString
- RealDice.Convert.CSV
- RealDice.Die
- RealDice.Generate
- RealDice.Generate.BalancedTables
- RealDice.Generate.PseudoRandomizedInts
- RealDice.Generate.RawData
- RealDice.Manipulate
- RealDice.Manipulate.GetValueFromRNGTable
- RealDice.Manipulate.RandomizeList
- RealDice.RNG
- RealDice.Util
- RealDice.Util.Prime
Downloads
- real-dice-0.1.0.5.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
Package maintainers
For package maintainers and hackage trustees
Readme for real-dice-0.1.0.5
[back to package description]Real* Dice* 
Random number generation using real dice and other media that I actually touched!
Introduction
Sometimes the digital world can feel cold and sterile compared to the messy and unpredictable nature of our physical environment. Purely functional languages like Haskell are, for better and for worse, particularly susceptible to this digital de-messification
In celebration of Haskell's determinative nature, this package provides random data from my interaction with the physical world as well as utilities to leverage this data for random number generation and other RNG-based tasks
This package can be used to bring a human touch to our digital world
Use
The API of the Coin, Die, and RNG modules more or less match the API of System.Random's random and randomR functions, but with each function handling a specific type and domain. For example, flipCoin returns Boolean values and roll1d n returns Integers in the range [1, n]
Running the executable will produce the standard randomized data as defined in the Generate modules (see app/Generate/ and src/RealDice/Generate/). If valid seed data exists in the data-seed/ directory, this will be randomized with the Real*Dice* data to generate custom balanced data in the data-generated/ directory (Coming Soon!)
FAQ
How does Real*Dice* work?
Check the source, Hackage, or Hoogle for documentation!
The RNG system itself is a basic randomized table lookup. If it's good enough for the most perfect software ever written, it's good enough for me!
What changes are planned?
Check the issues and TODO.md!
I encountered a bug or have a cool feature idea!
Please open an issue or submit a PR!
Why are there asterisks in "Real*Dice*"?
Data contained in this project was generated with physical dice, but the project itself is not a physical object
Additionally, not all of the gathered data comes from rolling dice. Most of it comes from drawing poker chips, which can be much faster. Methodology for gathering the data is documented in src/RealDice/Generate/RawData.hs
...but why? On the whole thing?
Because it's cool.
The interaction between the digital world and the physical world fascinates me. Musicians love to talk about warmth and saturation in audio signals - see Variety Of Sound for some mind-blowing information and audio plugins. This warmth traditionally comes from signal imperfections springing from physical components. This package doesn't scratch the surface of this kind of signal theory, but it's an attempt to use the physical world to influence the digital one
Plus, we all know that observer interaction affects quantum systems, so it seems fun to have some random data touched by a human 😸