An associate football match predictor

MatchTeller implements a poisson model from A J Maher's 1982 "Modelling Associate Football Scores" paper.

The original paper can be found here.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Clone the repository to your local machine

git clone http://github.co.uk/apburton84/matchteller

You will need to install the python dependencies

pip install -r requirements.txt

A list dependencies can be found in the requirements.txt.

Historical data can be obtained from football-data.co.uk

The data used in the following examples of MatchTeller usage can be found at football-data.co.uk - Premier League 2015-2016

Output the MatchTeller usage documentation.

python matchteller -h

Usage: matchteller [-h] [--match-data path] [--home-team string]
                   [--away-team string] [--output type]

Poisson Football Match Score Predictor

optional arguments:
  -h, --help          show this help message and exit
  --match-data path   football match data csv
  --home-team string  the home team
  --away-team string  the away team
  --output type       output as table, csv, json, xml

Author: Anthony Burton <[email protected]>

You can easily predict the outcome of a particular match, say Stoke vs Arsenal, by providing historical match data and an output format:

python matchteller --match-data ../2015-2016/E0.csv --home-team Stoke --away-team Arsenal --output table

MatchTeller prediction for Stoke vs Arsenal, given the 2015-2016 premier league data as input, is:

      AWAY     DRAW     HOME
----  -------  -------  -------
PROB  36.9964  20.0858  42.8832

MatchTeller current support the output of the following formats:

• Table
• HTML
• JSON
• XML
• CSV

MatchTeller was built with the following excellent pieces of software:

• Numpy Numpy
• Pandas Pandas
• Scipy SciPy

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

We use SemVer for versioning. For the versions available, see the tags on this repository.

• Anthony Burton - Initial work - apburton84

See also the list of contributors who participated in this project.

This project is licensed under the MIT License - see the LICENSE.md file for details

• Help the python scientific community and http://numfocus.wpengine.com/community/donate/ to numfocus