Football Data Analysis Toolkit
A collection of wrappers over football [*] data from various websites / APIs. You get: Pandas dataframes with sensible, matching column names and identifiers across datasets. Data is downloaded when needed and cached locally. Example Jupyter Notebooks are in the Github repo.
Data sources:
fivethirtyeight.com
(https://projects.fivethirtyeight.com/soccer-predictions)
Season 2016-17 predictions and results for the top European and American leagues.
football-data.co.uk
(http://www.football-data.co.uk/)
Historical results, betting odds and match statistics for English, Scottish, German, Italian, Spanish, French, Dutch, Belgian, Portuguese, Turkish and Greek leagues, including a number of lower divisions. Level of detail depends on league.
clubelo.com
First team relative strengths, for all (?) European leagues. Recalculated after every round, includes history.
Roadmap:
Add player stats, transfers, injuries and suspensions.
Installation
$ pip install footballdata
Dependencies
Usage
import footballdata as foo
# Create class instances
five38 = foo.FiveThirtyEight()
elo = foo.ClubElo()
mhist = foo.MatchHistory('ENG-Premier League', '2016-17')
# Create dataframes
matches = five38.read_games()
forecasts = five38.forecasts()
current_elo = elo.read_by_date()
team_elo_history = elo.read_team_history('Barcelona')
epl_2016 = mhist.read_games()
See the Jupyter Notebooks here for more elaborate examples: https://github.com/skagr/footballdata/tree/master/notebooks
Compatibility
Tested against Python 2.7 and 3.4-3.6
Licence
MIT
Metadata
Release files for footballdata 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| footballdata-0.3.1.tar.gz | 9.1 kB | Without provenance | Details for footballdata-0.3.1.tar.gz |
Release files / footballdata-0.3.1.tar.gz
| Download URL | footballdata-0.3.1.tar.gz |
|---|---|
| Size | 9.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c3b9c225383c8f1239e5e953becf2556e2d508cff6e599cc9894886f2516f8e8
|
|
BLAKE2b-256 checksum How to use checksums |
9393fc309a2d61d7ac81a51549270ad1085f688f1dfa4c0dad55bb6cef88110e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for footballdata 0.3.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.