Syntax Reference
Operators
| Operator | Name | Meaning | Precedence |
|---|
, | Union | OR — combine ranges | Lowest |
: | Intersection | AND — both must match | Medium |
! | Difference | NOT — exclude combos | Medium |
() | Grouping | Override precedence | Highest |
Evaluation order: Parentheses first, then : and ! left-to-right, then , last.
AA,KK:xxyy = AA OR (KK AND double-suited)
(AA,KK):xxyy = (AA OR KK) AND double-suited
TT+!AA = TT through KK (excluding AA)
AA!AAA = Exactly two aces (not three+)
Ranks
A K Q J T 9 8 7 6 5 4 3 2
Rank Variables
| Variable | Convention | Example |
|---|
R | First rank | RR = any pair |
O | Second rank | RROO = two different pairs |
N | Third rank | RRON = pair + two different cards |
P | Fourth rank | For 4+ card patterns |
Rank variables do NOT bind to explicit ranks. AARR = aces plus another pair, not quad aces.
Rank Ranges
| Syntax | Meaning |
|---|
A-T | Ace through Ten = [A,K,Q,J,T] |
9-5 | Nine through Five = [9,8,7,6,5] |
[A,K,Q,J] | Explicit rank list |
[A,2,3,4,5] | Wheel cards (use list, not A-5) |
Aces are always HIGH in ranges. A-5 means A through 5 going high-to-low (all 10 ranks), not a wheel. Use [A,2,3,4,5] for wheel cards.
Rank Modifiers
| Syntax | Meaning | Example |
|---|
+ | This hand or better | TT+ = TT through AA |
- | Range (through) | AA-TT = AA, KK, QQ, JJ, TT |
Suits
| Suit | Letter |
|---|
| Spades | s |
| Hearts | h |
| Diamonds | d |
| Clubs | c |
Suit Variables
| Variable | Meaning |
|---|
x | First suit variable |
y | Second suit variable |
z | Third suit variable |
w | Fourth suit variable |
Suit variables do NOT bind to explicit suits. ssxx = two spades + two of another suit, not four spades.
Suited/Offsuit Patterns
| Pattern | Meaning | Example |
|---|
xx | Suited (two cards same suit) | AxKx = AK suited |
xy | Offsuit (different suits) | AxKy = AK offsuit |
xxyy | Double-suited | AxAyKxKy |
wxyz | Rainbow (all four suits) | Four different suits |
Suit Macros
| Macro | Meaning |
|---|
$s | Suited (same as xx) |
$o | Offsuit (same as xy) |
$ds | Double-suited (Omaha) |
$ss | Single-suited (Omaha) |
$np | No pair (Omaha) |
Percentage Ranges
| Syntax | Meaning |
|---|
10% | Top 10% of hands (full-ring ranking) |
10%6h | Top 10% of hands (6-handed ranking) |
5%-15% | Hands ranked between 5% and 15% |
Combining with Other Ranges
AA,10% AA OR top 10%
xx:15% Suited hands in top 15%
TT+:20% Pairs TT+ that are also in top 20%
Hold'em
| Syntax | Meaning |
|---|
AsAh | Exact hand: ace of spades, ace of hearts |
AA | Pocket aces (6 combos) |
AKs | Ace-King suited (4 combos) |
AKo | Ace-King offsuit (12 combos) |
AK | All AK (16 combos) |
TT+ | Tens or better (TT through AA) |
55-99 | Pair range: fives through nines |
A5-A2 | Ace-five through ace-deuce |
[A-J][2-5] | Rank lists: broadway + small card |
AA,KK,QQ | Union: aces OR kings OR queens |
TT+!AA | TT through KK (excluding aces) |
AA@50 | Aces at 50% weight |
* | Any random hand |
Omaha
Ranges are implicitly topped off with wildcards. AA equals AA** (aces with any two other cards).
| Syntax | Meaning |
|---|
AA | At least two aces + any other cards |
AARR | Aces plus another pair |
AA$ds | Aces, double-suited |
AA$ss | Aces, single-suited |
wxyz | Rainbow (all four suits) |
15%$np | Top 15% with no pair |
(AA,KK):xxyy | Aces or Kings AND double-suited |
AA!AAA | Exactly two aces (not three+) |
$0G | 0-gap rundown (e.g. 5678, 789T) |
$1G | 1-gap rundown (e.g. 5679) |
$2G | 2-gap rundown (e.g. 568T) |
AA,KK,QQ | Union: any of these pairs |
AA@50 | Aces at 50% weight |
Stud
Stud uses pipe (|) notation to separate hole cards from upcards and later streets.
Basic Syntax
hole hole | upcard Third street (3 cards)
hole hole | up up up Fifth street (5 cards)
hole hole | up up up up | down Seventh street (7 cards)
Examples
| Syntax | Meaning |
|---|
* * | Ks | Any two down, king of spades showing |
AA-TT | B | Big pair in hole, broadway up |
(B B | Kh):(hh hh | Kh) | Two broadway down with same-suit constraint |
[A,K] [Q,J] | Kh | Rank lists in hole cards |
AA | Kh@50 | Aces in hole, king showing at 50% weight |
Stud Rank Macros
| Macro | Cards | Purpose |
|---|
B | A, K, Q, J | Big cards |
M | T, 9, 8, 7 | Middle cards |
Z | 6, 5, 4, 3, 2 | Small cards |
L | A, 2, 3, 4, 5, 6, 7, 8 | Low-qualifying cards |
N | K, Q, J, T, 9 | Non-low cards |
W | A, 2, 3, 4, 5 | Wheel cards |
Omaha Hi/Lo
Same syntax as Omaha, with emphasis on low-card patterns for the low half of the pot.
| Syntax | Meaning |
|---|
A2** | Ace-deuce for low draw |
A23* | Wheel draw (three wheel cards) |
[A,2,3,4,5]*** | Any wheel card + three others |
A2:xxyy | Ace-deuce double-suited |
Board Notation
| Syntax | Meaning |
|---|
AhKs2c | Flop: A hearts, K spades, 2 clubs |
AhKs2c5d | Turn: flop + 5 diamonds |
AhKs2c5d9h | River: complete board |
Shorthand: type just rank letters (e.g. AK2) and the calculator will auto-assign suits. Flop card order does not matter. Turn and river order is significant.
Weighting
Append @ followed by a percentage to weight a range. This reduces the frequency of that range in the simulation.
| Syntax | Meaning |
|---|
AA@50 | Aces at 50% frequency |
AKs@75 | AK suited at 75% frequency |
AA | Kh@50 | Stud: weighted at 50% |
AA@50,KK | 50% aces OR 100% kings |
Custom Macros
Save a range with a name using the save icon next to any hand input. Reference it later with $name in any hand field.
Save "TT+,AK,AQs" as "premium"
Then use $premium in any hand input
Combine: $premium:xx (premium AND suited)
Quick Reference Card
OPERATORS: , OR (union)
: AND (intersection)
! NOT (difference)
() Grouping
@ Weighting (e.g. AA@50)
SUITS: s h d c (specific suits)
x y z w (suit variables)
$s $o (suited / offsuit)
$ds $ss (double / single suited)
RANKS: A K Q J T 9 8 7 6 5 4 3 2
R O N P (rank variables)
* (wildcard)
RANGES: + (or better: TT+ = TT-AA)
- (through: AA-TT)
% (percentage: 10%)
%6h (6-handed: 10%6h)
STUD MACROS: B Big (A,K,Q,J)
M Middle (T,9,8,7)
Z Small (6,5,4,3,2)
L Low (A,2,3,4,5,6,7,8)
W Wheel (A,2,3,4,5)
STUD SYNTAX: hole hole | upcard [| more streets]