import pandas as pd
import re
from .constants import PARSING_SCHEME
from ..decorators import float_property_decorator, int_property_decorator
from .. import utils
from .conferences import Conferences
from .ncaab_utils import _retrieve_all_teams
from .roster import Roster
from .schedule import Schedule
[docs]class Team:
"""
An object containing all of a team's season information.
Finds and parses all team stat information and identifiers, such as full
and short names, and sets them as properties which can be directly read
from for easy reference.
If calling directly, the team's abbreviation needs to be passed. Otherwise,
the Teams class will handle all arguments.
Parameters
----------
team_name : string (optional)
The name of the team to pull if being called directly.
team_data : string (optional)
A string containing all of the rows of stats for a given team. If
multiple tables are being referenced, this will be comprised of
multiple rows in a single string.
team_conference : string (optional)
A string of the team's conference abbreviation, such as 'big-12'.
year : string (optional)
The requested year to pull stats from.
basic_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should be
of the Basic Stats page for the designated year.
basic_opp_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should be
of the Basic Opponent Stats page for the designated year.
adv_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should be
of the Advanced Stats page for the designated year.
adv_opp_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should be
of the Advanced Opponent Stats page for the designated year.
"""
def __init__(self, team_name=None, team_data=None, team_conference=None,
year=None, basic_stats=None, basic_opp_stats=None,
adv_stats=None, adv_opp_stats=None):
self._team_conference = team_conference
self._year = year
self._abbreviation = None
self._name = None
self._games_played = None
self._wins = None
self._losses = None
self._win_percentage = None
self._simple_rating_system = None
self._strength_of_schedule = None
self._conference_wins = None
self._conference_losses = None
self._home_wins = None
self._home_losses = None
self._away_wins = None
self._away_losses = None
self._points = None
self._opp_points = None
self._minutes_played = None
self._field_goals = None
self._field_goal_attempts = None
self._field_goal_percentage = None
self._two_point_field_goals = None
self._two_point_field_goal_attempts = None
self._two_point_field_goal_percentage = None
self._three_point_field_goals = None
self._three_point_field_goal_attempts = None
self._three_point_field_goal_percentage = None
self._free_throws = None
self._free_throw_attempts = None
self._free_throw_percentage = None
self._offensive_rebounds = None
self._defensive_rebounds = None
self._total_rebounds = None
self._assists = None
self._steals = None
self._blocks = None
self._turnovers = None
self._personal_fouls = None
self._opp_field_goals = None
self._opp_field_goal_attempts = None
self._opp_field_goal_percentage = None
self._opp_two_point_field_goals = None
self._opp_two_point_field_goal_attempts = None
self._opp_two_point_field_goal_percentage = None
self._opp_three_point_field_goals = None
self._opp_three_point_field_goal_attempts = None
self._opp_three_point_field_goal_percentage = None
self._opp_free_throws = None
self._opp_free_throw_attempts = None
self._opp_free_throw_percentage = None
self._opp_offensive_rebounds = None
self._opp_defensive_rebounds = None
self._opp_total_rebounds = None
self._opp_assists = None
self._opp_steals = None
self._opp_blocks = None
self._opp_turnovers = None
self._opp_personal_fouls = None
self._pace = None
self._offensive_rating = None
self._free_throw_attempt_rate = None
self._three_point_attempt_rate = None
self._true_shooting_percentage = None
self._total_rebound_percentage = None
self._assist_percentage = None
self._steal_percentage = None
self._block_percentage = None
self._effective_field_goal_percentage = None
self._turnover_percentage = None
self._offensive_rebound_percentage = None
self._free_throws_per_field_goal_attempt = None
self._opp_offensive_rating = None
self._opp_free_throw_attempt_rate = None
self._opp_three_point_attempt_rate = None
self._opp_true_shooting_percentage = None
self._opp_total_rebound_percentage = None
self._opp_assist_percentage = None
self._opp_steal_percentage = None
self._opp_block_percentage = None
self._opp_effective_field_goal_percentage = None
self._opp_turnover_percentage = None
self._opp_offensive_rebound_percentage = None
self._opp_free_throws_per_field_goal_attempt = None
if team_name:
team_data = self._retrieve_team_data(year, team_name, basic_stats,
basic_opp_stats, adv_stats,
adv_opp_stats)
conferences_dict = Conferences(year).team_conference
self._team_conference = conferences_dict[team_name.lower()]
self._parse_team_data(team_data)
def __str__(self):
"""
Return the string representation of the class.
"""
return f'{self.name} ({self.abbreviation}) - {self._year}'
def __repr__(self):
"""
Return the string representation of the class.
"""
return self.__str__()
def _retrieve_team_data(self, year, team_name, basic_stats=None,
basic_opp_stats=None, adv_stats=None,
adv_opp_stats=None):
"""
Pull all stats for a specific team.
By first retrieving a dictionary containing all information for all
teams in the league, only select the desired team for a specific year
and return only their relevant results.
Parameters
----------
year : string
A ``string`` of the requested year to pull stats from.
team_name : string
A ``string`` of the team's abbreviation, such as 'PURDUE' for the
Purdue Boilermakers.
basic_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should
be of the Basic Stats page for the designated year.
basic_opp_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should
be of the Basic Opponent Stats page for the designated year.
adv_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should
be of the Advanced Stats page for the designated year.
adv_opp_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should
be of the Advanced Opponent Stats page for the designated year.
Returns
-------
PyQuery object
Returns a PyQuery object containing all stats and information for
the specified team.
"""
team_data_dict, year = _retrieve_all_teams(year, basic_stats,
basic_opp_stats, adv_stats,
adv_opp_stats)
self._year = year
team_data = team_data_dict[team_name]['data']
return team_data
def _parse_team_data(self, team_data):
"""
Parses a value for every attribute.
This function looks through every attribute and retrieves the value
according to the parsing scheme and index of the attribute from the
passed HTML data. Once the value is retrieved, the attribute's value is
updated with the returned result.
Note that this method is called directly once Team is invoked and does
not need to be called manually.
Parameters
----------
team_data : string
A string containing all of the rows of stats for a given team. If
multiple tables are being referenced, this will be comprised of
multiple rows in a single string.
"""
for field in self.__dict__:
if field == '_year' or \
field == '_team_conference':
continue
value = utils._parse_field(PARSING_SCHEME,
team_data,
# Remove the '_' from the name
str(field)[1:])
setattr(self, field, value)
@property
def dataframe(self):
"""
Returns a pandas DataFrame containing all other class properties and
values. The index for the DataFrame is the string abbreviation of the
team, such as 'PURDUE'.
"""
fields_to_include = {
'abbreviation': self.abbreviation,
'assist_percentage': self.assist_percentage,
'assists': self.assists,
'away_losses': self.away_losses,
'away_wins': self.away_wins,
'block_percentage': self.block_percentage,
'blocks': self.blocks,
'conference': self.conference,
'conference_losses': self.conference_losses,
'conference_wins': self.conference_wins,
'defensive_rebounds': self.defensive_rebounds,
'effective_field_goal_percentage':
self.effective_field_goal_percentage,
'field_goal_attempts': self.field_goal_attempts,
'field_goal_percentage': self.field_goal_percentage,
'field_goals': self.field_goals,
'free_throw_attempt_rate': self.free_throw_attempt_rate,
'free_throw_attempts': self.free_throw_attempts,
'free_throw_percentage': self.free_throw_percentage,
'free_throws': self.free_throws,
'free_throws_per_field_goal_attempt':
self.free_throws_per_field_goal_attempt,
'games_played': self.games_played,
'home_losses': self.home_losses,
'home_wins': self.home_wins,
'losses': self.losses,
'minutes_played': self.minutes_played,
'name': self.name,
'net_rating': self.net_rating,
'offensive_rating': self.offensive_rating,
'offensive_rebound_percentage': self.offensive_rebound_percentage,
'offensive_rebounds': self.offensive_rebounds,
'opp_assist_percentage': self.opp_assist_percentage,
'opp_assists': self.opp_assists,
'opp_block_percentage': self.opp_block_percentage,
'opp_blocks': self.opp_blocks,
'opp_defensive_rebounds': self.opp_defensive_rebounds,
'opp_effective_field_goal_percentage':
self.opp_effective_field_goal_percentage,
'opp_field_goal_attempts': self.opp_field_goal_attempts,
'opp_field_goal_percentage': self.opp_field_goal_percentage,
'opp_field_goals': self.opp_field_goals,
'opp_free_throw_attempt_rate': self.opp_free_throw_attempt_rate,
'opp_free_throw_attempts': self.opp_free_throw_attempts,
'opp_free_throw_percentage': self.opp_free_throw_percentage,
'opp_free_throws': self.opp_free_throws,
'opp_free_throws_per_field_goal_attempt':
self.opp_free_throws_per_field_goal_attempt,
'opp_offensive_rating': self.opp_offensive_rating,
'opp_offensive_rebound_percentage':
self.opp_offensive_rebound_percentage,
'opp_offensive_rebounds': self.opp_offensive_rebounds,
'opp_personal_fouls': self.opp_personal_fouls,
'opp_points': self.opp_points,
'opp_steal_percentage': self.opp_steal_percentage,
'opp_steals': self.opp_steals,
'opp_three_point_attempt_rate': self.opp_three_point_attempt_rate,
'opp_three_point_field_goal_attempts':
self.opp_three_point_field_goal_attempts,
'opp_three_point_field_goal_percentage':
self.opp_three_point_field_goal_percentage,
'opp_three_point_field_goals': self.opp_three_point_field_goals,
'opp_two_point_field_goal_attempts':
self.opp_two_point_field_goal_attempts,
'opp_two_point_field_goal_percentage':
self.opp_two_point_field_goal_percentage,
'opp_two_point_field_goals': self.opp_two_point_field_goals,
'opp_total_rebound_percentage': self.opp_total_rebound_percentage,
'opp_total_rebounds': self.opp_total_rebounds,
'opp_true_shooting_percentage': self.opp_true_shooting_percentage,
'opp_turnover_percentage': self.opp_turnover_percentage,
'opp_turnovers': self.opp_turnovers,
'pace': self.pace,
'personal_fouls': self.personal_fouls,
'points': self.points,
'simple_rating_system': self.simple_rating_system,
'steal_percentage': self.steal_percentage,
'steals': self.steals,
'strength_of_schedule': self.strength_of_schedule,
'three_point_attempt_rate': self.three_point_attempt_rate,
'three_point_field_goal_attempts':
self.three_point_field_goal_attempts,
'three_point_field_goal_percentage':
self.three_point_field_goal_percentage,
'three_point_field_goals': self.three_point_field_goals,
'two_point_field_goal_attempts':
self.two_point_field_goal_attempts,
'two_point_field_goal_percentage':
self.two_point_field_goal_percentage,
'two_point_field_goals': self.two_point_field_goals,
'total_rebound_percentage': self.total_rebound_percentage,
'total_rebounds': self.total_rebounds,
'true_shooting_percentage': self.true_shooting_percentage,
'turnover_percentage': self.turnover_percentage,
'turnovers': self.turnovers,
'win_percentage': self.win_percentage,
'wins': self.wins
}
return pd.DataFrame([fields_to_include], index=[self._abbreviation])
@property
def conference(self):
"""
Returns a ``string`` of the team's conference abbreviation, such as
'big-12' for the Big 12 Conference.
"""
return self._team_conference
@property
def abbreviation(self):
"""
Returns a ``string`` of the team's short name, such as 'PURDUE' for the
Purdue Boilermakers.
"""
return self._abbreviation
@property
def schedule(self):
"""
Returns an instance of the Schedule class containing the team's
complete schedule for the season.
"""
return Schedule(self._abbreviation, self._year)
@property
def roster(self):
"""
Returns an instance of the Roster class containing all players for the
team during the season with all career stats.
"""
return Roster(self._abbreviation, self._year)
@property
def name(self):
"""
Returns a ``string`` of the team's full name, such as 'Purdue
Boilermakers'.
"""
return self._name
@int_property_decorator
def games_played(self):
"""
Returns an ``int`` of the total number of games the team has played
during the season.
"""
return self._games_played
@int_property_decorator
def wins(self):
"""
Returns an ``int`` of the total number of games the team won during the
season.
"""
return self._wins
@int_property_decorator
def losses(self):
"""
Returns an ``int`` of the total number of games the team lost during
the season.
"""
return self._losses
@float_property_decorator
def win_percentage(self):
"""
Returns a ``float`` of the number of wins divided by the number of
games played during the season. Percentage ranges from 0-1.
"""
return self._win_percentage
@float_property_decorator
def simple_rating_system(self):
"""
Returns a ``float`` of the team's average point differential compared
to the strength of schedule. Higher values indicate stronger teams. An
average team is denoted with 0.0. Negative numbers are comparatively
worse than average.
"""
return self._simple_rating_system
@float_property_decorator
def strength_of_schedule(self):
"""
Returns a ``float`` of the team's strength of schedule based on the
points above and below average. An average strength of schedule is
denoted with 0.0. Negative numbers are comparatively easier than
average.
"""
return self._strength_of_schedule
@int_property_decorator
def conference_wins(self):
"""
Returns an ``int`` of the total number of conference games the team won
during the season.
"""
return self._conference_wins
@int_property_decorator
def conference_losses(self):
"""
Returns an ``int`` of the total number of conference games the team
lost during the season.
"""
return self._conference_losses
@int_property_decorator
def home_wins(self):
"""
Returns an ``int`` of the total number of home games the team won
during the season.
"""
return self._home_wins
@int_property_decorator
def home_losses(self):
"""
Returns an ``int`` of the total number of home games the team lost
during the season.
"""
return self._home_losses
@int_property_decorator
def away_wins(self):
"""
Returns an ``int`` of the total number of away games the team won
during the season.
"""
return self._away_wins
@int_property_decorator
def away_losses(self):
"""
Returns an ``int`` of the total number of away games the team lost
during the season.
"""
return self._away_losses
@int_property_decorator
def points(self):
"""
Returns an ``int`` of the total number of points the team scored during
the season.
"""
return self._points
@int_property_decorator
def opp_points(self):
"""
Returns an ``int`` of the total number of points opponents have scored
during the season.
"""
return self._opp_points
@int_property_decorator
def minutes_played(self):
"""
Returns an ``int`` of the total number of minutes played by the team
during the season.
"""
return self._minutes_played
@int_property_decorator
def field_goals(self):
"""
Returns an ``int`` of the total number of field goals made during the
season.
"""
return self._field_goals
@int_property_decorator
def field_goal_attempts(self):
"""
Returns an ``int`` of the total number of field goal attempts during
the season.
"""
return self._field_goal_attempts
@float_property_decorator
def field_goal_percentage(self):
"""
Returns a ``float`` of the number of field goals made divided by the
total number of field goal attempts. Percentage ranges from 0-1.
"""
return self._field_goal_percentage
@int_property_decorator
def two_point_field_goals(self):
"""
Returns an ``int`` of the total number of two point field goals made
during the season.
"""
return self.field_goals - self.three_point_field_goals
@int_property_decorator
def two_point_field_goal_attempts(self):
"""
Returns an ``int`` of the total number of two point field goal attempts
during the season.
"""
return self.field_goal_attempts - self.three_point_field_goal_attempts
@float_property_decorator
def two_point_field_goal_percentage(self):
"""
Returns a ``float`` of the number of two point field goals made divided
by the number of two point field goal attempts. Percentage ranges from
0-1.
"""
try:
result = float(self.two_point_field_goals) / \
float(self.two_point_field_goal_attempts)
return round(result, 3)
except ZeroDivisionError:
return 0.0
@int_property_decorator
def three_point_field_goals(self):
"""
Returns an ``int`` of the total number of three point field goals made
during the season.
"""
return self._three_point_field_goals
@int_property_decorator
def three_point_field_goal_attempts(self):
"""
Returns an ``int`` of the total number of three point field goal
attempts during the season.
"""
return self._three_point_field_goal_attempts
@float_property_decorator
def three_point_field_goal_percentage(self):
"""
Returns a ``float`` of the number of three point field goals made
divided by the number of three point field goal attempts. Percentage
ranges from 0-1.
"""
return self._three_point_field_goal_percentage
@int_property_decorator
def free_throws(self):
"""
Returns an ``int`` of the total number of free throws made during the
season.
"""
return self._free_throws
@int_property_decorator
def free_throw_attempts(self):
"""
Returns an ``int`` of the total number of free throw attempts during
the season.
"""
return self._free_throw_attempts
@float_property_decorator
def free_throw_percentage(self):
"""
Returns a ``float`` of the number of free throws made divided by the
number of free throw attempts during the season.
"""
return self._free_throw_percentage
@int_property_decorator
def offensive_rebounds(self):
"""
Returns an ``int`` of the total number of offensive rebounds during the
season.
"""
return self._offensive_rebounds
@int_property_decorator
def defensive_rebounds(self):
"""
Returns an ``int`` of the total number of defensive rebounds during the
season.
"""
try:
return self.total_rebounds - self.offensive_rebounds
except TypeError:
return None
@int_property_decorator
def total_rebounds(self):
"""
Returns an ``int`` of the total number of rebounds during the season.
"""
return self._total_rebounds
@int_property_decorator
def assists(self):
"""
Returns an ``int`` of the total number of assists during the season.
"""
return self._assists
@int_property_decorator
def steals(self):
"""
Returns an ``int`` of the total number of steals during the season.
"""
return self._steals
@int_property_decorator
def blocks(self):
"""
Returns an ``int`` of the total number of blocks during the season.
"""
return self._blocks
@int_property_decorator
def turnovers(self):
"""
Returns an ``int`` of the total number of turnovers during the season.
"""
return self._turnovers
@int_property_decorator
def personal_fouls(self):
"""
Returns an ``int`` of the total number of personal fouls during the
season.
"""
return self._personal_fouls
@int_property_decorator
def opp_field_goals(self):
"""
Returns an ``int`` of the total number of field goals made during the
season by opponents.
"""
return self._opp_field_goals
@int_property_decorator
def opp_field_goal_attempts(self):
"""
Returns an ``int`` of the total number of field goal attempts during
the season by opponents.
"""
return self._opp_field_goal_attempts
@float_property_decorator
def opp_field_goal_percentage(self):
"""
Returns a ``float`` of the number of field goals made divided by the
total number of field goal attempts by opponents. Percentage ranges
from 0-1.
"""
return self._opp_field_goal_percentage
@int_property_decorator
def opp_two_point_field_goals(self):
"""
Returns an ``int`` of the total number of two point field goals made
during the season by opponents.
"""
return self.opp_field_goals - self.opp_three_point_field_goals
@int_property_decorator
def opp_two_point_field_goal_attempts(self):
"""
Returns an ``int`` of the total number of two point field goal attempts
during the season by opponents.
"""
return self.opp_field_goal_attempts - \
self.opp_three_point_field_goal_attempts
@float_property_decorator
def opp_two_point_field_goal_percentage(self):
"""
Returns a ``float`` of the number of two point field goals made divided
by the number of two point field goal attempts by opponents. Percentage
ranges from 0-1.
"""
try:
result = float(self.opp_two_point_field_goals) / \
float(self.opp_two_point_field_goal_attempts)
return round(result, 3)
except ZeroDivisionError:
return 0.0
@int_property_decorator
def opp_three_point_field_goals(self):
"""
Returns an ``int`` of the total number of three point field goals made
during the season by opponents.
"""
return self._opp_three_point_field_goals
@int_property_decorator
def opp_three_point_field_goal_attempts(self):
"""
Returns an ``int`` of the total number of three point field goal
attempts during the season by opponents.
"""
return self._opp_three_point_field_goal_attempts
@float_property_decorator
def opp_three_point_field_goal_percentage(self):
"""
Returns a ``float`` of the number of three point field goals made
divided by the number of three point field goal attempts by opponents.
Percentage ranges from 0-1.
"""
return self._opp_three_point_field_goal_percentage
@int_property_decorator
def opp_free_throws(self):
"""
Returns an ``int`` of the total number of free throws made during the
season by opponents.
"""
return self._opp_free_throws
@int_property_decorator
def opp_free_throw_attempts(self):
"""
Returns an ``int`` of the total number of free throw attempts during
the season by opponents.
"""
return self._opp_free_throw_attempts
@float_property_decorator
def opp_free_throw_percentage(self):
"""
Returns a ``float`` of the number of free throws made divided by the
number of free throw attempts during the season by opponents.
"""
return self._opp_free_throw_percentage
@int_property_decorator
def opp_offensive_rebounds(self):
"""
Returns an ``int`` of the total number of offensive rebounds during the
season by opponents.
"""
return self._opp_offensive_rebounds
@int_property_decorator
def opp_defensive_rebounds(self):
"""
Returns an ``int`` of the total number of defensive rebounds during the
season by opponents.
"""
try:
return self.opp_total_rebounds - self.opp_offensive_rebounds
except TypeError:
return None
@int_property_decorator
def opp_total_rebounds(self):
"""
Returns an ``int`` of the total number of rebounds during the season by
opponents.
"""
return self._opp_total_rebounds
@int_property_decorator
def opp_assists(self):
"""
Returns an ``int`` of the total number of assists during the season by
opponents.
"""
return self._opp_assists
@int_property_decorator
def opp_steals(self):
"""
Returns an ``int`` of the total number of steals during the season by
opponents.
"""
return self._opp_steals
@int_property_decorator
def opp_blocks(self):
"""
Returns an ``int`` of the total number of blocks during the season by
opponents.
"""
return self._opp_blocks
@int_property_decorator
def opp_turnovers(self):
"""
Returns an ``int`` of the total number of turnovers during the season
by opponents.
"""
return self._opp_turnovers
@int_property_decorator
def opp_personal_fouls(self):
"""
Returns an ``int`` of the total number of personal fouls during the
season by opponents.
"""
return self._opp_personal_fouls
@float_property_decorator
def pace(self):
"""
Returns a ``float`` of the average number of possessions per 40
minutes.
"""
return self._pace
@float_property_decorator
def offensive_rating(self):
"""
Returns a ``float`` of the average number of points scored per 100
possessions.
"""
return self._offensive_rating
@float_property_decorator
def net_rating(self):
"""
Returns a ``float`` of the net team rating which is equivalent to the
difference between the offensive rating and the defensive (or the
opponent's offensive) rating. Positive values indicate teams that score
more points than they allow per 100 possessions.
"""
try:
return self.offensive_rating - self.opp_offensive_rating
except TypeError:
return None
@float_property_decorator
def free_throw_attempt_rate(self):
"""
Returns a ``float`` of the average number of free throw attempts per
field goal attempt.
"""
return self._free_throw_attempt_rate
@float_property_decorator
def three_point_attempt_rate(self):
"""
Returns a ``float`` of the percentage of field goal attempts from
3-point range. Percentage ranges from 0-1.
"""
return self._three_point_attempt_rate
@float_property_decorator
def true_shooting_percentage(self):
"""
Returns a ``float`` of the team's true shooting percentage which
considers free throws, 2-point field goals, and 3-point field goals.
Percentage ranges from 0-1.
"""
return self._true_shooting_percentage
@float_property_decorator
def total_rebound_percentage(self):
"""
Returns a ``float`` of the percentage of available rebounds a team
grabbed.
Percentage ranges from 0-100.
"""
return self._total_rebound_percentage
@float_property_decorator
def assist_percentage(self):
"""
Returns a ``float`` of the percentage of field goals that were
assisted.
Percentage ranges from 0-100.
"""
return self._assist_percentage
@float_property_decorator
def steal_percentage(self):
"""
Returns a ``float`` of the percentage of opponent possessions that
ended in a steal. Percentage ranges from 0-100.
"""
return self._steal_percentage
@float_property_decorator
def block_percentage(self):
"""
Returns a ``float`` of the percentage of 2-point field goals by the
opponent that were blocked. Percentage ranges from 0-100.
"""
return self._block_percentage
@float_property_decorator
def effective_field_goal_percentage(self):
"""
Returns a ``float`` of the field goal percentage while giving extra
weight to 3-point field goals. Percentage ranges from 0-1.
"""
return self._effective_field_goal_percentage
@float_property_decorator
def turnover_percentage(self):
"""
Returns a ``float`` of the number of times the team turned the ball
over per 100 possessions.
"""
return self._turnover_percentage
@float_property_decorator
def offensive_rebound_percentage(self):
"""
Returns a ``float`` of the percentage of available offensive rebounds a
team grabbed. Percentage ranges from 0-100.
"""
return self._offensive_rebound_percentage
@float_property_decorator
def free_throws_per_field_goal_attempt(self):
"""
Returns a ``float`` of the number of free throws per field goal
attempt.
"""
return self._free_throws_per_field_goal_attempt
@float_property_decorator
def opp_offensive_rating(self):
"""
Returns a ``float`` of the average number of points scored per 100
possessions by the opponent. This is equivalent to the team's defensive
rating as it is the number of points the team allows per 100
possessions by the opponent.
"""
return self._opp_offensive_rating
@float_property_decorator
def opp_free_throw_attempt_rate(self):
"""
Returns a ``float`` of the average number of free throw attempts per
field goal attempt by the opponent.
"""
return self._opp_free_throw_attempt_rate
@float_property_decorator
def opp_three_point_attempt_rate(self):
"""
Returns a ``float`` of the percentage of field goal attempts from
3-point range by the opponent. Percentage ranges from 0-1.
"""
return self._opp_three_point_attempt_rate
@float_property_decorator
def opp_true_shooting_percentage(self):
"""
Returns a ``float`` of the opponent's true shooting percentage which
considers free throws, 2-point field goals, and 3-point field goals.
Percentage ranges from 0-1.
"""
return self._opp_true_shooting_percentage
@float_property_decorator
def opp_total_rebound_percentage(self):
"""
Returns a ``float`` of the percentage of available rebounds the
opponent grabbed. Percentage ranges from 0-100.
"""
return self._opp_total_rebound_percentage
@float_property_decorator
def opp_assist_percentage(self):
"""
Returns a ``float`` of the percentage of the opponent's field goals
that were assisted. Percentage ranges from 0-100.
"""
return self._opp_assist_percentage
@float_property_decorator
def opp_steal_percentage(self):
"""
Returns a ``float`` of the percentage of possessions that ended in a
steal by the opponent. Percentage ranges from 0-100.
"""
return self._opp_steal_percentage
@float_property_decorator
def opp_block_percentage(self):
"""
Returns a ``float`` of the percentage of 2-point field goals that were
blocked by the opponent. Percentage ranges from 0-100.
"""
return self._opp_block_percentage
@float_property_decorator
def opp_effective_field_goal_percentage(self):
"""
Returns a ``float`` of the opponent's field goal percentage while
giving extra weight to 3-point field goals. Percentage ranges from 0-1.
"""
return self._opp_effective_field_goal_percentage
@float_property_decorator
def opp_turnover_percentage(self):
"""
Returns a ``float`` of the number of times the opponent turned the ball
over per 100 possessions.
"""
return self._opp_turnover_percentage
@float_property_decorator
def opp_offensive_rebound_percentage(self):
"""
Returns a ``float`` of the percentage of available offensive rebounds
the opponent grabbed. Percentage ranges from 0-100.
"""
return self._opp_offensive_rebound_percentage
@float_property_decorator
def opp_free_throws_per_field_goal_attempt(self):
"""
Returns a ``float`` of the number of free throws per field goal attempt
by the opponent.
"""
return self._opp_free_throws_per_field_goal_attempt
[docs]class Teams:
"""
A list of all NCAA Men's Basketball teams and their stats in a given year.
Finds and retrieves a list of all NCAA Men's Basketball teams from
www.sports-reference.com and creates a Team instance for every team that
participated in the league in a given year. The Team class comprises a list
of all major stats and a few identifiers for the requested season.
Parameters
----------
year : string (optional)
The requested year to pull stats from.
basic_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should
be of the Basic Stats page for the designated year.
basic_opp_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should
be of the Basic Opponent Stats page for the designated year.
adv_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should
be of the Advanced Stats page for the designated year.
adv_opp_stats : string (optional)
Optionally specify the filename of a local file to use to pull data
instead of downloading from sports-reference.com. This file should
be of the Advanced Opponent Stats page for the designated year.
"""
def __init__(self, year=None, basic_stats=None, basic_opp_stats=None,
adv_stats=None, adv_opp_stats=None):
self._teams = []
self._conferences_dict = Conferences(year).team_conference
team_data_dict, year = _retrieve_all_teams(year, basic_stats,
basic_opp_stats, adv_stats,
adv_opp_stats)
self._instantiate_teams(team_data_dict, year)
def __getitem__(self, abbreviation):
"""
Return a specified team.
Returns a team's instance in the Teams class as specified by the team's
short name.
Parameters
----------
abbreviation : string
An NCAAB team's short name (ie. 'PURDUE' for the Purdue
Boilermakers).
Returns
-------
Team instance
If the requested team can be found, its Team instance is returned.
Raises
------
ValueError
If the requested team is not present within the Teams list.
"""
for team in self._teams:
if team.abbreviation.upper() == abbreviation.upper():
return team
raise ValueError('Team abbreviation %s not found' % abbreviation)
def __call__(self, abbreviation):
"""
Return a specified team.
Returns a team's instance in the Teams class as specified by the team's
short name. This method is a wrapper for __getitem__.
Parameters
----------
abbreviation : string
An NCAAB team's short name (ie. 'PURDUE' for the Purdue
Boilermakers).
Returns
-------
Team instance
if the requested team can be found, its Team instance is returned
"""
return self.__getitem__(abbreviation)
def __str__(self):
"""
Return the string representation of the class.
"""
teams = [f'{team.name} ({team.abbreviation})'.strip()
for team in self._teams]
return '\n'.join(teams)
def __repr__(self):
"""
Return the string representation of the class.
"""
return self.__str__()
def __iter__(self):
"""Returns an iterator of all of the NCAAB teams for a given season."""
return iter(self._teams)
def __len__(self):
"""Returns the number of NCAAB teams for a given season."""
return len(self._teams)
def _instantiate_teams(self, team_data_dict, year):
"""
Create a Team instance for all teams.
Once all team information has been pulled from the various webpages,
create a Team instance for each team and append it to a larger list of
team instances for later use.
Parameters
----------
team_data_dict : dictionary
A ``dictionary`` containing all stats information in HTML format as
well as team rankings, indexed by team abbreviation.
year : string
A ``string`` of the requested year to pull stats from.
"""
if not team_data_dict:
return
for team_name, team_data in team_data_dict.items():
# Skip any teams that don't have a valid team page, which is likely
# any school that doesn't compete in D-I, but is still in the stats
# list.
if team_name.lower() not in self._conferences_dict:
continue
conference = self._conferences_dict[team_name.lower()]
team = Team(team_data=team_data['data'],
team_conference=conference,
year=year)
self._teams.append(team)
@property
def dataframes(self):
"""
Returns a pandas DataFrame where each row is a representation of the
Team class. Rows are indexed by the team abbreviation.
"""
frames = []
for team in self.__iter__():
frames.append(team.dataframe)
return pd.concat(frames)