Blackjack Simulation Program

A sophisticated blackjack simulation program featuring configurable game rules, multiple casino rule profiles, and comprehensive multi-session analysis capabilities. The system provides detailed statistics, time-series metrics, and bankroll tracking across multiple simulation sessions.

Features

Game Engine

• Multiple casino rule profiles (Vegas Strip, Downtown Vegas, Single Deck, Atlantic City, European)
• Configurable deck count, blackjack payouts, and splitting rules
• Split hand management with double-after-split support
• Strategy engine for split and double-down decisions
• Debug logging system

Analysis Features

• Multi-session statistics tracking
• Bankroll distribution analysis
• Time-series progression metrics
• CSV export functionality
• Maximum drawdown tracking
• Win/loss streak analysis
• Volatility measurements

Usage

Basic usage with default Vegas Strip rules:

python blackjack_sim.py --num_sessions 5 --num_hands 100 --starting_stake 1000 --standard_bet 10

Command Line Arguments

• --rule_set: Casino rule set (vegas_strip, downtown_vegas, single_deck, atlantic_city, european)
• --num_sessions: Number of sessions to simulate (default: 1)
• --num_hands: Number of hands per session (default: 1000)
• --starting_stake: Initial bankroll amount (default: 1000)
• --standard_bet: Standard bet amount (default: 10)
• --verbose: Enable detailed hand-by-hand logging
• --debug: Enable debug mode with hand verification
• --strategy_file: Path to strategy CSV file (default: basic_strategy.csv)

Rule Set Profiles

1. Vegas Strip (Default)

   • 6 decks
   • Dealer hits soft 17
   • Late surrender allowed
   • 3:2 blackjack payout
   • Double after split allowed
   • Up to 3 splits permitted

2. Downtown Vegas

   • 2 decks
   • Same core rules as Strip
   • More favorable deck penetration

3. Single Deck

   • 1 deck
   • 6:5 blackjack payout
   • Limited splitting options
   • No double after split

4. Atlantic City

   • 8 decks
   • Standard 3:2 payout
   • No resplit of aces

5. European

   • 6 decks
   • No surrender
   • Limited doubling options

Analysis Features

Time-Series Analysis

The program tracks and analyzes various metrics across sessions:

1. Bankroll Progression

   • Maximum drawdown percentage
   • Win/loss streaks
   • Bankroll volatility

2. Session Performance

   • Bankruptcy and doubling rates
   • Distribution of final bankrolls
   • High/low watermarks

Sample Output

From verified test runs:

Multi-Session Simulation Results
============================================================
Total Sessions: 5
Initial Bankroll: $1,000.00
Hands per Session: 100

Session Outcomes:
  Bankruptcy Rate: 0.0% (0 sessions)
  Doubling Rate:   0.0% (0 sessions)

Final Bankroll Distribution:
  $400-$800:   2 sessions (40.0%)
  $800-$1,200:   3 sessions (60.0%)

Time-Series Analysis:
  Maximum Drawdown:     38.0%
  Longest Win Streak:   6 hands
  Longest Loss Streak:  9 hands
  Average Win Streak:   1.5 hands
  Average Loss Streak:  3.1 hands
  Bankroll Volatility:  1.4%

Summary Statistics:
  Average Final Bankroll: $930.00
  Best Session Result:    $1,080.00
  Worst Session Result:   $690.00

Data Export

Session data is automatically exported to CSV files for external analysis, including:

• Hand-by-hand bankroll progression
• Session outcomes
• Time-series metrics

Debug Mode

Enable debug mode to verify correct gameplay:

python blackjack_sim.py --debug --test_scenario split_8s

Available test scenarios:

• split_8s: Tests pair splitting
• soft_17: Tests dealer soft 17 behavior
• double_after_split: Tests doubling after split
• soft19v6: Tests soft total strategy
• split_aces: Tests ace splitting rules