nwslpy 0.0.0.7000

Python wrapper around the nwslR library

nwslpy

nwslpy is a Python wrapper around the data generated by the nwslR package. The goal of this package is to make the data from nwslR available to an even broader audience.

If you see anything you’d like added, changed, or updated, please open up a new issue of your own. If you are interested in contributing, please contact us directly. If you use this data in any work, please cite us.

Installing the package

Install nwspy using the following command:

pip install nwslpy

API

• load_player_match_stats(match_id): Loads player level stats for a given match
• load_player_season_stats(team_id, season): Loads player level stats for a team/season
• load_team_match_stats(match_id): Loads team level stats for a given match
• load_team_season_stats(team_id, season): Loads team level stats for a team/season
• load_matches(): All matches from 2016-present with information and match IDs
• load_players(): All players rostered from 2016-present with information and player IDs
• load_teams(): All teams active from 2016-present with information and team IDs
• load_metrics() All metrics available from scrapers with definitions. Not all metrics are available for all players/matches/teams/etc.

Usage

If you wanted to see the list of matches from 2022, you could try:

import nwslpy

# Load all matches and filter to ones in the year 2022
matches = nwslpy.load_matches()
matches[matches["year"] == 2022]

If you wanted to see which players took the most shots in the 2022 NWSL Championship, you could try:

import nwslpy

stats = nwslpy.load_player_match_stats("portland-thorns-fc-vs-kansas-city-current-2022-10-29")
players = nwslpy.load_players()

# Select the columns of interest
stats = stats[["shots_total"]]
# Join with information about the players
stats = stats.join(players)[["shots_total", "player_match_name"]]
# Find the players with the most shots
stats = stats.sort_values("shots_total", ascending=False)

For more complicated examples, including how to visualize the data, check out the examples directory.