Python Simple Slot Machine

Most recently Monty Python and the Holy Grail Black Knight was tagged at Harrah's Cherokee Casino and Hotel Mar 11 at 23:52 Slot Machine Description The Monty Python and The Holy Grail - Black Knight - slot machine by Bally in some ways seems inevitable: of course a Monty Python slot machine would be made eventually, right?! The software is a simple python program written using the kivy framework. We call it kivySlots. This software by default is setup to spin the slot machine wheels, and randomly stop after a random time. The payout is setup for 1 coin if you lose, and then 2 coins for 1 cherry, 3 coins for 2 cherries, 4 coins for 3 cherries. I'd say you should encapsulate as much of your code as possible into functions and classes, limiting the global state when possible. This serves two purposes - the first is that it improves debugging (by limiting the odds that something unintentionally alters global state) and readability (by making it easier to understand what everything does).

Python Simple Slot Machine

Multi-armed banditry in Python with slots

Roy Keyes

22 Aug 2016 - This is a post on my blog.

I recently released slots, a Python library that implements multi-armed bandit strategies. If that sounds like something that won't put you to sleep, then please pip install slots and read on.

Multi-armed bandits

The multi-armed bandit (MAB) problem is a classic problem of trying to make the best choice, while having limited resources to gain information. The classic formulation is the gambler faced with a number of slot machines (a.k.a. one-armed bandits). How can the gambler maximize their payout while spending as little money as possible determining which are the 'hot' slot machines and which are the 'cold' ones? In more generic, idealized terms, you are faced with n choices, each with an associated payout probability p_i, which are unknown to you. Your goal is to run as few trials, or pulls, as possible to establish the the choice with the highest payout probability. There are many variations on this basic problem.

Getting the best bang for your buck

Most of us do not spend our time strategizing about real slot machines, but we do see similar real-world problems, such as A/B testing or resource allocation. Because of that, strategies to solve the multi-armed bandit problem are of both practical and intellectual interest to the data scientist-types out there.

There are several strategies for solving the MAB problem. All of them attempt to strike a balance between exploration, searching for the best choice, and exploitation, using the current best choice. Because of these competing goals, determining if you are making optimal choices is not trivial. Instead of simply looking at your average payout from your trials, a quantity called regret is calculated. Intuitively, regret is the payout value lost by making the sequence of choices you have made relative to the payout you would have received having known the best choice from the start. Regret can thus be used as a stopping criterion for making a 'final', best choice.

Example strategy: epsilon greedy

To understand how you might approach the multi-armed bandit problem, consider the simplest reasonable strategy, epsilon greedy:

  • You spend the fraction e of your trials randomly trying different choices, i.e. exploration.
  • For the rest of the time, 1 - e, you always choose the choice with the current highest reward rate, i.e. exploitation.
Python Simple Slot Machine

Too little time exploring the options might lead you to stay with a sub-optimal choice. Too much time spent exploring might lead you to spend unnecessary money on options that you already know are sub-optimal.

slots

I wrote slots with two goals in mind, investigating the performance of different MAB strategies for educational purposes and creating a usable implementation of those strategies for real world scenarios. For both of these goals, a simple API with reasonable default values was desirable.

So what does slots do? Right now, as of version 0.3.0, it has implementations of a few basic MAB strategies and allows you to run those on test scenarios and with real, live data. Currently, those strategies include epsilon greedy, softmax, upper confidence bound (UCB1), and Bayesian bandits implementations.

For 'real world' (online) usage, test results can be sequentially fed into an MAB object. After each result is fed into the algorithm the next recommended choice is returned, as well as whether your stopping criterion is met.

What slots looks like:

Using slots to determine the best of 3 variations on a live website.

Monty Python Slot Machine App

Make the first choice randomly, record the response, and input reward (arm 2 was chosen here). Run online_trial (input most recent result) until the test criteria is met.

The response of mab.online_trial() is a dict of the form:

Python Simple Slot Machine Slot

Where:

  • If the criterion is met, new_trial = False.
  • choice is the choice of the next arm to try.
  • best is the current best estimate of the highest payout arm.

For testing and understanding MAB strategies, you can also assign probabilities and payouts to the different arms and observe the results. For example, to compare the regret value and max arm payout probability as more trials are performed with various strategies (in this case epsilon greedy, softmax, upper credibility bound (UCB1), and Bayesian bandits):

The resulting regret evolution:

The estimated payout probability of the 'best' arm after each trial. In this case, the actual payout probability of the best arm is 0.85.

Making it happen

slots is on PyPI, so you can simply install with pip install slots. Currently, slots works with both Python 2.7+ and 3.4+ and the only dependency is Numpy.

The future

slots is open source (BSD license) and I welcome outside contributions. My desire is to make slots easy-to-use, robust, and featureful. If you are interested in slots or the multi-armed bandit problem in general, please check out the References and further reading section below.

This was a very brief overview of the rich subject of dealing with the MAB problem and the slots library. Please checkout slots and send me feedback!

Follow me on twitter!

References and further reading

Python Simple Slot Machine Software

  • Multi-armed bandit (Wikipedia)
  • Regret Analysis of Stochastic and Nonstochastic Multi-armed Bandit Problems (Bubeck and Cesa-Bianchi)
  • Multi-Armed Bandit Algorithms and EmpiricalEvaluation (Vermorel and Mohri)
  • Upper confidence bound (Auer et al)