README.md

Command line interface

Installation

brew install rustup
git clone git@github.com:ocisly/odd.git
cd odd
rustup -V
cargo install --path cli

Usage

odd <hole-cards>... --opponents <opponents> --permutations <permutations> --seed <seed>

When all the players' hole cards and all five community cards are known, odd detects what hand each player holds and determines the winners:

odd Ad Ks 8h 8s --board 8c Ah As 9c 9h

player 1 was dealt: A♦️ K♠️
player 2 was dealt: 8♥️ 8♠️
flop: 8♣️ A♥️ A♠️
turn: 9♣️
river: 9♥️

43 cards remain.

player 1 has Full House, Aces full of Nines: A♦️ A♥️ A♠️ 9♣️ 9♥️ (winner)
player 2 has Full House, Eights full of Aces: 8♥️ 8♠️ 8♣️ A♥️ A♠️ (lost)

Otherwise, odd estimates the odds of winning for each player by generating a configurable number of random deck shuffles to simulate a range of possible scenarios:

odd Ad Ks 8h 8s --board 8c Ah As 9c

player 1 was dealt: A♦️ K♠️
player 2 was dealt: 8♥️ 8♠️
flop: 8♣️ A♥️ A♠️
turn: 9♣️

44 cards remain.

player 1: win 15.90%, tie  0.00%, loss 84.10%
player 2: win 84.10%, tie  0.00%, loss 15.90%

Additional opponents with unknown cards can be specified:

odd As Ah -o 1

player 1 was dealt: A♠️ A♥️

50 cards remain.

player 1: win 85.15%, tie  0.54%, loss 14.31%
player 2: win 14.31%, tie  0.54%, loss 85.15%

Optionally, odd can be instructed to output the distribution of possible outcomes for each player:

odd Ad Ks 8h 8s --board 8c Ah As 9c --distribution

player 1 was dealt: A♦️ K♠️
player 2 was dealt: 8♥️ 8♠️
flop: 8♣️ A♥️ A♠️
turn: 9♣️

44 cards remain.

player 1: win 15.85%, tie  0.00%, loss 84.15%
Three of a Kind     : 81.88%
Full House          : 15.86%
Four of a Kind      :  2.26%

player 2: win 84.15%, tie  0.00%, loss 15.85%
Full House          : 97.73%
Four of a Kind      :  2.27%