Upload Blackjack Q-table model
Browse files- README.md +36 -0
- policy_heatmap.svg +792 -0
- policy_table.csv +0 -0
- q_learning_model_comparison.csv +4 -0
- q_model.json +0 -0
- training_history.csv +1 -0
README.md
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Blackjack Q-table Policy
|
| 2 |
+
|
| 3 |
+
This repository contains the trained tabular Q-learning policy used in the IEMS5726 Blackjack Reinforcement Learning Trainer project.
|
| 4 |
+
|
| 5 |
+
## Model
|
| 6 |
+
|
| 7 |
+
- Algorithm: tabular Q-learning
|
| 8 |
+
- Policy artifact: `q_model.json`
|
| 9 |
+
- Actions: `0 = stand`, `1 = hit`, `2 = double_down`
|
| 10 |
+
- State representation: `(player_total, dealer_upcard, usable_ace, can_double, true_count_bucket)`
|
| 11 |
+
- Rules: one player versus dealer, finite 6-deck shoe, Hi-Lo running count, true-count bucket, double down, dealer stands on soft 17, natural Blackjack pays 3:2.
|
| 12 |
+
|
| 13 |
+
## Evaluation
|
| 14 |
+
|
| 15 |
+
The selected policy was evaluated over 1,000,000 Blackjack hands.
|
| 16 |
+
|
| 17 |
+
| Metric | Value |
|
| 18 |
+
| --- | ---: |
|
| 19 |
+
| Average reward | -0.0086975 |
|
| 20 |
+
| Win rate | 0.433611 |
|
| 21 |
+
| Loss rate | 0.481673 |
|
| 22 |
+
| Draw rate | 0.084716 |
|
| 23 |
+
|
| 24 |
+
`q_learning_model_comparison.csv` compares the selected expert-prior/count policy against 5,000,000-hand fine-tuning variants.
|
| 25 |
+
|
| 26 |
+
## Files
|
| 27 |
+
|
| 28 |
+
- `q_model.json`: trained Q-table policy and evaluation metadata
|
| 29 |
+
- `policy_table.csv`: exported policy table
|
| 30 |
+
- `policy_heatmap.svg`: policy visualization
|
| 31 |
+
- `training_history.csv`: training-history file generated by the training pipeline
|
| 32 |
+
- `q_learning_model_comparison.csv`: final model comparison table
|
| 33 |
+
|
| 34 |
+
## Usage
|
| 35 |
+
|
| 36 |
+
The browser demo can load this model JSON directly from the public URL. In the project submission, place the public link in `application/model_link.txt`.
|
policy_heatmap.svg
ADDED
|
|
policy_table.csv
ADDED
|
The diff for this file is too large to render.
See raw diff
|
|
|
q_learning_model_comparison.csv
ADDED
|
@@ -0,0 +1,4 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
model,average_reward,win_rate,loss_rate,draw_rate,eval_episodes
|
| 2 |
+
best_basic_count,-0.008698,0.433611,0.481673,0.084716,1000000
|
| 3 |
+
five_m_expert_prior,-0.008698,0.433611,0.481673,0.084716,1000000
|
| 4 |
+
five_m_aggressive,-0.024801,0.430806,0.482306,0.086888,1000000
|
q_model.json
ADDED
|
The diff for this file is too large to render.
See raw diff
|
|
|
training_history.csv
ADDED
|
@@ -0,0 +1 @@
|
|
|
|
|
|
|
| 1 |
+
episode,epsilon,average_reward,win_rate,loss_rate,draw_rate
|