• Stars
    star
    165
  • Rank 228,906 (Top 5 %)
  • Language
    Python
  • Created about 10 years ago
  • Updated almost 7 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

BlackJack-Simulator written in Python with OMEGA II Count

BlackJack-Simulator with OMEGA II Card Counting

Flexible BlackJack-Simulator written in Python. It takes a given basic strategy as input (defined in a .csv-file) and simulates that strategy over a given amount of time. The simulator also counts cards sticking to the OMEGA II Count, which basically gives every card some value. Depending on the current count the bet size gets adjusted.

Running

python BlackJack.py strategy/BasicStrategy.csv

Omega II Count:

2 3 4 5 6 7 8 9 10 J Q K A
+1 +1 +2 +2 +2 +1 0 -1 -2 -2 -2 -2 0

So, for example if there is a player-favorable count like +20 by 2 decks remaining, the simulator bets the standard bet times the specified BET_SPREAD.

Definition of Terms

The simulator involves several concepts related to Blackjack game play:

  • A Hand is a single hand of Blackjack, consisting of two or more cards
  • A Round is single round of Blackjack, in which one or more players play their hands against the dealer's hand
  • A Shoe consists of multiple card decks consisting of SHOE_SIZE times 52 cards
  • A Game is a sequence of Rounds that starts with a fresh Shoe and ends when the Shoe gets reshuffled

Result

The simulator provides the net winnings result per game played and an overall result summing up all the game results. The following output for example indicates, that in game no. 67 the simulated player won 18 hands more than he lost. On the other hand in game no. 68 the simulator lost 120 hands more than he won.

 ...
 WIN for Game no. 67: 18.000000
 WIN for Game no. 68: -120.000000
 ...

This graph displays every game with its total won or lost hands. You can see that in some rare games about 60 more hands are lost/won than won/lost. If the expectation is positive, you have developed a Winning BlackJack Strategy, which is the case for the provided BasicStrategy plus the OMEGA II count.

Gaussian Distribution

This graph displays the development of the count for each game. You can see that the card count in rare cases even exceeds 40 and is on average as you would expect 0.

Counts Distribution

Gaming Rules

The simulator plays with the following casino rules:

  • Dealer stands on soft 17
  • Double down after splitting hands is allowed
  • No BlackJack after splitting hands
  • 3 times 7 is counted as a BlackJack

Configuration Variables

Variable Description
GAMES The number of games that should be played
ROUNDS_PER_GAME The number of rounds that should be played per game (may cover multiple shoes)
SHOE_SIZE The number of decks that are used
SHOE_PENETRATION Indicates the percentage of cards that still remain in the shoe, when the shoe gets reshuffled
BET_SPREAD The multiplier for the bet size in a player favorable counting situation

Sample Configuration

GAMES = 1
ROUNDS = 10
SHOE_SIZE = 8
SHOE_PENETRATION = 0.2 # reshuffle after 80% of all cards are played
BET_SPREAD = 20.0 # Bet 20-times the money if the count is player-favorable

Strategy

Any strategy can be fed into the simulator as a .csv file. The default strategy that comes with this simulator looks like the following:

Default Strategy

  • The first column shows both player's cards added up
  • The first row shows the dealers up-card
  • S ... Stand
  • H ... Hit
  • Sr ... Surrender
  • D ... Double Down
  • P ... Split

Note on the shuffle method used

The shuffle method used is the default random.shuffle() which comes with a warning :
"[if] the total number of permutations of x is larger than the period of most random number generators, [then] most permutations of a long sequence can never be generated."
https://docs.python.org/2/library/random.html
Hopefully :
"Python uses the Mersenne Twister as the core generator. It produces 53-bit precision floats and has a period of 2**19937-1" Which means that a list of over ~~2080 elements would never see all its permutations, even if it got shuffled an infinite number of times. 8x52 = 416 is low enough to ignore this problem.