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:
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