Skip to content

ABarriscale/Axelrod

 
 

Repository files navigation

https://badge.waffle.io/Axelrod-Python/Axelrod.svg?label=ready&title=Ready https://travis-ci.org/Axelrod-Python/Axelrod.svg?branch=packaging

Join the chat at https://gitter.im/Axelrod-Python/Axelrod

Axelrod

A repository with the following goals:

  1. To enable the reproduction of previous Iterated Prisoner's Dilemma research as easily as possible.
  2. To produce the de-facto tool for any future Iterated Prisoner's Dilemma research.
  3. To provide as simple a means as possible for anyone to define and contribute new and original Iterated Prisoner's Dilemma strategies.

Please contribute strategies via pull request (or just get in touch with us).

For an overview of how to use and contribute to this repository, see the documentation: http://axelrod.readthedocs.org/

If you do use this library for your personal research we would love to hear about it: please do add a link at the bottom of this README file (PR's welcome or again, just let us know) :) If there is something that is missing in this library and that you would like implemented so as to be able to carry out a project please open an issue and let us know!

Installation

The simplest way to install is:

$ pip install axelrod

Otherwise:

$ git clone https://github.com/Axelrod-Python/Axelrod.git
$ cd Axelrod
$ python setup.py install

You might need to install the libraries in requirements.txt:

pip install -r requirements.txt

Note that on Ubuntu [some users](Axelrod-Python#309) have had problems installing matplotlib. This seems to help with that:

sudo apt-get install libfreetype6-dev
sudo apt-get install libpng12-0-dev

Usage

The full documentation can be found here: axelrod.readthedocs.org/.

The documentation includes details of how to setup a tournament but here is an example showing how to create a tournament with all stochastic strategies:

import axelrod
strategies = [s() for s in axelrod.ordinary_strategies if s().classifier['stochastic']]
tournament = axelrod.Tournament(strategies)
results = tournament.play()

The results object now contains all the results we could need:

print(results.ranked_names)

gives:

['Meta Hunter', 'Inverse', 'Forgetful Fool Me Once', 'GTFT: 0.33', 'Champion', 'ZD-GTFT-2', 'Eatherley', 'Math Constant Hunter', 'Random Hunter', 'Soft Joss: 0.9', 'Meta Majority', 'Nice Average Copier', 'Feld', 'Meta Minority', 'Grofman', 'Stochastic WSLS', 'ZD-Extort-2', 'Tullock', 'Joss: 0.9', 'Arrogant QLearner', 'Average Copier', 'Cautious QLearner', 'Hesitant QLearner', 'Risky QLearner', 'Random: 0.5', 'Meta Winner']

Results

A tournament with the full set of strategies from the library can be found at https://github.com/Axelrod-Python/tournament. Here is the latest graphical version of the results:

See the [tournament repository](https://github.com/Axelrod-Python/tournament) for many additional plots.

Contributing

All contributions are welcome, with a particular emphasis on contributing further strategies.

You can find helpful instructions about contributing in the documentation: http://axelrod.readthedocs.org/en/latest/contributing.html.

Projects that use this library

If you happen to use this library for anything from a blog post to a research paper please list it here:

About

A library to run Axelrod tournaments

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 99.8%
  • Shell 0.2%