/matchteller

An associate football match predictor

Primary LanguagePythonBSD 2-Clause "Simplified" LicenseBSD-2-Clause

MatchTeller

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.

Getting Started

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

Dependencies

You will need to install the python dependencies

pip install -r requirements.txt

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

Historic Data

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

Usage

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 <apburton84@googlemail.com>

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

Output Formats

MatchTeller current support the output of the following formats:

  • Table
  • HTML
  • JSON
  • XML
  • CSV

Built With

MatchTeller was built with the following excellent pieces of software:

Contributing

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

Versioning

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

Authors

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

License

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

Acknowledgments