*roff source is available.
pokenum -- enumerate poker hand wins, losses, ties and pot equity
pokenum [-t] [-O] [-mc number] [-game] pocket1 [/ discard1] - pocket2 [/ discard2] [- pocket3 [/ discard3] ...] [-- board] [/ dead]
pokenum -i [options…]
pokenum compares two or more poker hands, consisting of pocket cards and any specified board cards, tabulates the number of times each hand wins, loses, or ties, and tabulates all-in pot equity. Discards and/or dead cards are taken into account, if specified.
Cards are specified by rank (AKQJT9…2) and suit (cdhs). For example, the ten of clubs is specified as Tc.
| -t | Terse output (one line, list of expected values). |
| -O | Compute and output detailed relative rank ordering histogram. |
| -mc number | Sample monte-carlo style with number iterations instead of full enumeration. |
| -i | Takes input from stdin, one enumeration request per line. |
The following game options are available. Games that use the joker are not yet implemented, though listed below.
| -h | holdem high (default) |
| -h8 | holdem high/low, 8-or-better |
| -o | omaha high |
| -o8 | omaha high/low, 8-or-better |
| -7s | seven card stud high |
| -7s8 | seven card stud high/low, 8-or-better |
| -7snsq | seven card stud high/low, no stinking qualifier |
| -r | seven card stud, ace-to-5 low (razz) |
| -5d | five card draw high (with joker) |
| -5d8 | five card draw high/low, 8-or-better (with joker) |
| -5dnsq | five card draw high/low, no stinking qualifier (with joker) |
| -l | five card draw ace-to-5 lowball (with joker) |
| -l27 | five card draw deuce-to-seven lowball |
$ pokenum Ac 7c - 5s 4s - Ks Kd
Compare three hands, before any board cards are dealt. Since no game is specified, the default game, holdem, is used.
$ pokenum -h Ac 7c - 5s 4s - Ks Kd
Same comparison, explicitly specifying holdem.
$ pokenum -h Ac 7c 5s 4s Ks Kd
Shorthand for same comparison.
$ pokenum -h Ac 7c 5s 4s Ks Kd -- 7h 2c 3h
Same hands with a flop.
$ pokenum -o As Kh Qs Jh - 8h 8d 7h 6d
Compare two omaha high hands.
$ pokenum -o As Kh Qs Jh 8h 8d 7h 6d
Shorthand for same comparison.
$ pokenum -o As Kh Qs Jh 8h 8d 7h 6d -- 8s Ts Jc
Same hands with a flop.
$ pokenum -7s As Ah Ts Th 8h 8d - Kc Qc Jc Td 3c 2d
Compare two seven-card-stud hands.
$ pokenum -7s As Ah Ts Th 8h 8d - Kc Qc Jc Td 3c 2d / 5c 6c 2s Jh
Same hands with dead cards (up-cards folded by other players).
$ pokenum -l 7h 5s 3d Xx / Kd - 9s 8h 6d 4c / 8c
Compare two ace-to-5 lowball hands (Xx is the joker) prior to the draw, but after discarding the king of diamonds and eight of clubs, respectively. (This game is not yet implemented.)
$ pokenum -l27 5h 4h 3h 2h / 5s - 9s 8h 6d 4c / Kd
Compare two deuce-to-seven lowball hands, after the indicated discards.
$ pokenum -mc 10000 -l27 5h 4h 3h / 5s Qd - 9s 8h 6d / Ks Kh
Compare two deuce-to-seven lowball hands, using monte-carlo sampling with 10000 iterations, after the indicated discards.
pokenum exits 0 on success, and >0 if an error occurs.
pokenum is an example program included with the poker-eval C library, which is part of the pokersource project.
pokersource home page: http://pokersource.org/
pokersource project page: https://gna.org/projects/pokersource/
pokenum was added to the poker-eval library on Fri Apr 5 08:39:57 2002 UTC.
Michael Maurer <mjmaurer@yahoo.com>
Brian Goetz <brian@quiotix.com>
Loic Dachary <loic@dachary.org>
Tim Showalter <tjs@psaux.com>
pokenum fails if a game that uses the joker is specified.
'pokenum -game pocket1 / discard1 - pocket2 / discard2 / dead' fails. Use 'pokenum -game pocket1 / discard1 - pocket2 / discard2 dead' or 'pokenum -game pocket1 - pocket2 / discards dead'.
| poker-eval | February 02, 2007 | poker-eval |