Skip to content

seanyboi/rugbypy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rugbypy

rugbypy is a Python package that aims to make rugby data more available to aid in the development of rugby analytics.

Data is updated daily 5AM UTC! Currently we only have 2023 data available with previous years coming soon.

PyPI - Downloads

Requirements

python version 3.8

Install

pip install rugbypy

How to use

Match Stats

You can fetch all the matches that occured on a particular date with:

from rugbypy.match import *
matches = fetch_matches(date="20230101")
matches
Fetching matches on date:20230101...
match_id competition_id home_team_id home_team away_team_id away_team date
0 595735 267979 25907 Northampton Saints 25901 Harlequins 20230101

Then using that match id you can feed it into the match details function:

from rugbypy.match import *
match_details = fetch_match_details(match_id="595735")
match_details
Fetching match details for match_id:595735...
match_id date season competition_id competition venue_id venue city_played home_team away_team home_team_id away_team_id completed is_tournament played_on_grass attendance home_team_form away_team_form
0 595735 20230101 2023 267979 Premiership Rugby 26070 cinch Stadium at Franklin's Gardens Northampton Northampton Saints Harlequins 25907 25901 True True True None LLWWL WLWLL

Team Stats

You can then fetch the team stats for a particular team on a particular date with:

from rugbypy.team import *
team_stats = fetch_team_stats(team_id="25901", date="20230108")
team_stats
Fetching team stats for team_id:25901 on date:20230108...
team game_date team_id team_vs team_vs_id match_id players clean_breaks conversion_goals defenders_beaten ... scrums_total scrums_won tackles territory total_free_kicks_conceded total_lineouts tries turnover_knock_on turnovers_conceded yellow_cards
0 Harlequins 20230108 25901 Sale Sharks 25908 595741 [158708, 299436, 299031, 298485, 295117, 29477... 3.0 0.0 24.0 ... 7.0 5.0 125.0 0.41 0.0 11.0 2.0 8.0 17.0 0.0

1 rows × 42 columns

Player Stats

We have the ability to fetch player stats for all the games they have bene involved in. We firstly identify the `player_id`` of a player by searching our player manifest file.

from rugbypy.player import *
player_manifest = fetch_all_players()
player_manifest.head()
player_id player_name
0 246815 Will Edwards
1 158708 Tommaso Allan
2 299436 Oscar Beard
3 299031 Fin Baxter
4 298485 Jordan Els

Or we can search for a certain player through our similarity tool:

from rugbypy.player import *
individual_player = fetch_player(name="johnny sexton")
individual_player
player_id player_name
267 149315 Anthony Watson
294 16004 Johnny Sexton
796 291349 Ayden Johnstone

We can also fetch the player stats for any player using their player_ids. In this example we fetch Johnny Sextons player stats:

from rugbypy.player import *
player_stats = fetch_player_stats(player_id="16004")
player_stats
Fetching all player stats for player_id:16004...
player_id game_date name team team_id competition_id competition match_id team_vs team_vs_id ... rucks_won runs tackles total_free_kicks_conceded total_lineouts tries try_assists turnover_knock_on turnovers_conceded yellow_cards
0 16004 20230204 Johnny Sexton Ireland 3 180659 Six Nations Championship 596205 Wales 4 ... 3.0 8.0 7.0 0.0 0.0 0.0 0.0 0.0 1.0 0.0
0 16004 20230211 Johnny Sexton Ireland 3 180659 Six Nations Championship 596208 France 9 ... 1.0 5.0 3.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0
0 16004 20230312 Johnny Sexton Ireland 3 180659 Six Nations Championship 596216 Scotland 2 ... 2.0 5.0 9.0 0.0 0.0 0.0 0.0 0.0 2.0 0.0
0 16004 20230318 Johnny Sexton Ireland 3 180659 Six Nations Championship 596219 England 1 ... 6.0 9.0 5.0 0.0 0.0 0.0 0.0 1.0 2.0 0.0
0 16004 20230909 Johnny Sexton Ireland 3 164205 Rugby World Cup 596156 Romania 12 ... 0.0 5.0 4.0 0.0 0.0 2.0 0.0 0.0 0.0 0.0
0 16004 20230916 Johnny Sexton Ireland 3 164205 Rugby World Cup 596166 Tonga 16 ... 1.0 1.0 2.0 0.0 0.0 1.0 0.0 0.0 0.0 0.0
0 16004 20230923 Johnny Sexton Ireland 3 164205 Rugby World Cup 596175 South Africa 5 ... 1.0 3.0 11.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0

7 rows × 41 columns