isapy-data 0.1.0__tar.gz

isapy_data-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ryan Elmore
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

isapy_data-0.1.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: isapy-data
+Version: 0.1.0
+Summary: Data package for Introduction to Sports Analytics using Python
+Author-email: Ryan Elmore <ryan.elmore@du.edu>
+License: MIT
+Project-URL: Homepage, https://github.com/rtelmore/ISAPy
+Project-URL: Repository, https://github.com/rtelmore/ISAPy
+Project-URL: Documentation, https://datacolorado.com/python/ISAPy/
+Keywords: sports,analytics,data,statistics,python
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.5.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# ISAPy
+
+Data package for *Introduction to Sports Analytics using Python* by Ryan Elmore.
+
+## Installation
+
+```bash
+pip install isapy-data
+```
+
+For development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Usage
+
+```python
+import isapy_data
+
+# List all available datasets
+isapy_data.list_datasets()
+
+# Load a dataset
+masters = isapy_data.load_data("masters")
+
+# Get information about a specific dataset
+isapy_data.describe("masters")
+
+# Print info about all datasets
+isapy_data.info()
+```
+
+## Available Datasets
+
+### Golf
+- `masters` - Masters Tournament data
+- `ow_golf_rankings` - Official World Golf Rankings
+- `pga_tournaments` - PGA Tour tournament data
+
+### NBA
+- `nba_adv_team_2021`, `nba_adv_team_2023`, `nba_adv_team_2024`, `nba_adv_team_2025` - Advanced team statistics
+- `nba_ff_team_2021`, `nba_ff_team_2023`, `nba_ff_team_2024`, `nba_ff_team_2025` - Four factors team statistics
+- `nba_games_2021`, `nba_games_2023`, `nba_games_2024`, `nba_games_2025` - Game results
+- `nba_nuggets_shots` - Denver Nuggets shot location data
+
+### NHL
+- `avs_roster_2021`, `avs_roster_2022` - Colorado Avalanche roster data
+- `avs_stats_2021`, `avs_stats_2022` - Colorado Avalanche player statistics
+- `nhl_data_hockey_reference` - NHL data from Hockey Reference
+- `nhl_team_stats_2021`, `nhl_team_stats_2022` - NHL team statistics
+
+### English Premier League
+- `epl_gk_stats_2022` through `epl_gk_stats_2025` - Goalkeeper statistics
+- `epl_player_stats_2022` through `epl_player_stats_2025` - Player statistics
+- `epl_team_stats`, `epl_team_stats_2023`, `epl_team_stats_2024`, `epl_team_stats_2025` - Team statistics
+
+### NWSL
+- `nwsl_player_stats`, `nwsl_player_stats_2023`, `nwsl_player_stats_2024` - Player statistics
+
+### DraftKings
+- `dk_edm_col` - Edmonton vs Colorado
+- `dk_lac_dal` - LA Clippers vs Dallas
+- `dk_mem_utah` - Memphis vs Utah
+- `dk_nyr_car` - NY Rangers vs Carolina
+
+## Development
+
+### Exporting Data from ISAR
+
+To export data from the R package ISAR to CSV format:
+
+```bash
+Rscript scripts/export_rda_to_csv.R
+```
+
+### Building the Package
+
+```bash
+python -m build
+```
+
+### Publishing to PyPI
+
+```bash
+python -m twine upload dist/*
+```
+
+## License
+
+MIT
+
+## Citation
+
+If you use this data in your research, please cite:
+
+> Elmore, R. (2025). *Introduction to Sports Analytics using Python*.

isapy_data-0.1.0/README.md

@@ -0,0 +1,98 @@
+# ISAPy
+
+Data package for *Introduction to Sports Analytics using Python* by Ryan Elmore.
+
+## Installation
+
+```bash
+pip install isapy-data
+```
+
+For development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Usage
+
+```python
+import isapy_data
+
+# List all available datasets
+isapy_data.list_datasets()
+
+# Load a dataset
+masters = isapy_data.load_data("masters")
+
+# Get information about a specific dataset
+isapy_data.describe("masters")
+
+# Print info about all datasets
+isapy_data.info()
+```
+
+## Available Datasets
+
+### Golf
+- `masters` - Masters Tournament data
+- `ow_golf_rankings` - Official World Golf Rankings
+- `pga_tournaments` - PGA Tour tournament data
+
+### NBA
+- `nba_adv_team_2021`, `nba_adv_team_2023`, `nba_adv_team_2024`, `nba_adv_team_2025` - Advanced team statistics
+- `nba_ff_team_2021`, `nba_ff_team_2023`, `nba_ff_team_2024`, `nba_ff_team_2025` - Four factors team statistics
+- `nba_games_2021`, `nba_games_2023`, `nba_games_2024`, `nba_games_2025` - Game results
+- `nba_nuggets_shots` - Denver Nuggets shot location data
+
+### NHL
+- `avs_roster_2021`, `avs_roster_2022` - Colorado Avalanche roster data
+- `avs_stats_2021`, `avs_stats_2022` - Colorado Avalanche player statistics
+- `nhl_data_hockey_reference` - NHL data from Hockey Reference
+- `nhl_team_stats_2021`, `nhl_team_stats_2022` - NHL team statistics
+
+### English Premier League
+- `epl_gk_stats_2022` through `epl_gk_stats_2025` - Goalkeeper statistics
+- `epl_player_stats_2022` through `epl_player_stats_2025` - Player statistics
+- `epl_team_stats`, `epl_team_stats_2023`, `epl_team_stats_2024`, `epl_team_stats_2025` - Team statistics
+
+### NWSL
+- `nwsl_player_stats`, `nwsl_player_stats_2023`, `nwsl_player_stats_2024` - Player statistics
+
+### DraftKings
+- `dk_edm_col` - Edmonton vs Colorado
+- `dk_lac_dal` - LA Clippers vs Dallas
+- `dk_mem_utah` - Memphis vs Utah
+- `dk_nyr_car` - NY Rangers vs Carolina
+
+## Development
+
+### Exporting Data from ISAR
+
+To export data from the R package ISAR to CSV format:
+
+```bash
+Rscript scripts/export_rda_to_csv.R
+```
+
+### Building the Package
+
+```bash
+python -m build
+```
+
+### Publishing to PyPI
+
+```bash
+python -m twine upload dist/*
+```
+
+## License
+
+MIT
+
+## Citation
+
+If you use this data in your research, please cite:
+
+> Elmore, R. (2025). *Introduction to Sports Analytics using Python*.

isapy_data-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "isapy-data"
+version = "0.1.0"
+description = "Data package for Introduction to Sports Analytics using Python"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Ryan Elmore", email = "ryan.elmore@du.edu"},
+]
+keywords = ["sports", "analytics", "data", "statistics", "python"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Education",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "pandas>=1.5.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "build",
+    "twine",
+]
+
+[project.urls]
+Homepage = "https://github.com/rtelmore/ISAPy"
+Repository = "https://github.com/rtelmore/ISAPy"
+Documentation = "https://datacolorado.com/python/ISAPy/"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+isapy_data = ["data/*.csv"]

isapy_data-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

isapy_data-0.1.0/src/isapy_data/__init__.py

@@ -0,0 +1,204 @@
+"""
+ISAPy: Data package for Introduction to Sports Analytics using Python.
+
+This package provides datasets for the textbook "Introduction to Sports
+Analytics using Python" by Ryan Elmore.
+
+Usage
+-----
+    import isapy_data
+
+    # Load a dataset
+    df = isapy_data.load_data("masters")
+
+    # List all available datasets
+    isapy_data.list_datasets()
+
+    # Get information about a dataset
+    isapy_data.describe("masters")
+"""
+
+from importlib.resources import files
+from pathlib import Path
+from typing import Optional
+
+import pandas as pd
+
+__version__ = "0.1.0"
+__author__ = "Ryan Elmore"
+
+# Dataset descriptions
+_DATASET_INFO = {
+    "avs_roster_2021": "Colorado Avalanche roster data for 2020-21 season",
+    "avs_roster_2022": "Colorado Avalanche roster data for 2021-22 season",
+    "avs_stats_2021": "Colorado Avalanche player statistics for 2020-21 season",
+    "avs_stats_2022": "Colorado Avalanche player statistics for 2021-22 season",
+    "dk_edm_col": "DraftKings data for Edmonton vs Colorado game",
+    "dk_lac_dal": "DraftKings data for LA Clippers vs Dallas game",
+    "dk_mem_utah": "DraftKings data for Memphis vs Utah game",
+    "dk_nyr_car": "DraftKings data for NY Rangers vs Carolina game",
+    "epl_gk_stats_2022": "English Premier League goalkeeper statistics for 2021-22 season",
+    "epl_gk_stats_2023": "English Premier League goalkeeper statistics for 2022-23 season",
+    "epl_gk_stats_2024": "English Premier League goalkeeper statistics for 2023-24 season",
+    "epl_gk_stats_2025": "English Premier League goalkeeper statistics for 2024-25 season",
+    "epl_player_stats_2022": "English Premier League player statistics for 2021-22 season",
+    "epl_player_stats_2023": "English Premier League player statistics for 2022-23 season",
+    "epl_player_stats_2024": "English Premier League player statistics for 2023-24 season",
+    "epl_player_stats_2025": "English Premier League player statistics for 2024-25 season",
+    "epl_team_stats": "English Premier League team statistics",
+    "epl_team_stats_2023": "English Premier League team statistics for 2022-23 season",
+    "epl_team_stats_2024": "English Premier League team statistics for 2023-24 season",
+    "epl_team_stats_2025": "English Premier League team statistics for 2024-25 season",
+    "masters": "Masters Tournament golf data",
+    "nba_adv_team_2021": "NBA advanced team statistics for 2020-21 season",
+    "nba_adv_team_2023": "NBA advanced team statistics for 2022-23 season",
+    "nba_adv_team_2024": "NBA advanced team statistics for 2023-24 season",
+    "nba_adv_team_2025": "NBA advanced team statistics for 2024-25 season",
+    "nba_ff_team_2021": "NBA four factors team statistics for 2020-21 season",
+    "nba_ff_team_2023": "NBA four factors team statistics for 2022-23 season",
+    "nba_ff_team_2024": "NBA four factors team statistics for 2023-24 season",
+    "nba_ff_team_2025": "NBA four factors team statistics for 2024-25 season",
+    "nba_games_2021": "NBA game results for 2020-21 season",
+    "nba_games_2023": "NBA game results for 2022-23 season",
+    "nba_games_2024": "NBA game results for 2023-24 season",
+    "nba_games_2025": "NBA game results for 2024-25 season",
+    "nba_nuggets_shots": "Denver Nuggets shot location data",
+    "nhl_data_hockey_reference": "NHL data from Hockey Reference",
+    "nhl_team_stats_2021": "NHL team statistics for 2020-21 season",
+    "nhl_team_stats_2022": "NHL team statistics for 2021-22 season",
+    "nwsl_player_stats": "NWSL player statistics",
+    "nwsl_player_stats_2023": "NWSL player statistics for 2023 season",
+    "nwsl_player_stats_2024": "NWSL player statistics for 2024 season",
+    "ow_golf_rankings": "Official World Golf Rankings data",
+    "pga_tournaments": "PGA Tour tournament data",
+}
+
+
+def _get_data_path() -> Path:
+    """Get the path to the data directory."""
+    return files("isapy_data").joinpath("data")
+
+
+def list_datasets() -> list[str]:
+    """
+    List all available datasets.
+
+    Returns
+    -------
+    list[str]
+        Names of all available datasets.
+
+    Examples
+    --------
+    >>> import isapy_data
+    >>> isapy_data.list_datasets()
+    ['avs_roster_2021', 'avs_roster_2022', ...]
+    """
+    data_path = _get_data_path()
+    datasets = []
+    for f in data_path.iterdir():
+        if f.name.endswith(".csv"):
+            datasets.append(f.name.replace(".csv", ""))
+    return sorted(datasets)
+
+
+def load_data(name: str) -> pd.DataFrame:
+    """
+    Load a dataset by name.
+
+    Parameters
+    ----------
+    name : str
+        The name of the dataset to load (without file extension).
+
+    Returns
+    -------
+    pd.DataFrame
+        The requested dataset as a pandas DataFrame.
+
+    Raises
+    ------
+    ValueError
+        If the dataset name is not found.
+
+    Examples
+    --------
+    >>> import isapy_data
+    >>> masters = isapy_data.load_data("masters")
+    >>> masters.head()
+    """
+    data_path = _get_data_path()
+    file_path = data_path.joinpath(f"{name}.csv")
+
+    if not file_path.is_file():
+        available = list_datasets()
+        if available:
+            raise ValueError(
+                f"Dataset '{name}' not found. Available datasets: {available}"
+            )
+        else:
+            raise ValueError(
+                f"Dataset '{name}' not found. No datasets are currently installed."
+            )
+
+    return pd.read_csv(file_path)
+
+
+def describe(name: str) -> Optional[str]:
+    """
+    Get a description of a dataset.
+
+    Parameters
+    ----------
+    name : str
+        The name of the dataset.
+
+    Returns
+    -------
+    str or None
+        Description of the dataset, or None if not available.
+
+    Examples
+    --------
+    >>> import isapy_data
+    >>> isapy_data.describe("masters")
+    'Masters Tournament golf data'
+    """
+    return _DATASET_INFO.get(name)
+
+
+def info() -> None:
+    """
+    Print information about all available datasets.
+
+    Examples
+    --------
+    >>> import isapy_data
+    >>> isapy_data.info()
+    """
+    print("ISAPy: Data package for Introduction to Sports Analytics using Python")
+    print("=" * 70)
+    print(f"Version: {__version__}")
+    print(f"Authors: {__author__}")
+    print()
+    print("Available datasets:")
+    print("-" * 70)
+
+    datasets = list_datasets()
+    if not datasets:
+        print("No datasets currently installed.")
+        print("See the package documentation for instructions on adding data.")
+        return
+
+    for name in datasets:
+        desc = describe(name) or "No description available"
+        print(f"  {name}: {desc}")
+
+
+__all__ = [
+    "__version__",
+    "list_datasets",
+    "load_data",
+    "describe",
+    "info",
+]

isapy_data-0.1.0/src/isapy_data/data/avs_roster_2021.csv

@@ -0,0 +1,27 @@
+"jersey_number","person_id","person_full_name","person_link","position_code","position_name","position_type","position_abbreviation"
+42,8476312,"Josh Manson","/api/v1/people/8476312","D","Defenseman","Defenseman","D"
+4,8481524,"Bowen Byram","/api/v1/people/8481524","D","Defenseman","Defenseman","D"
+54,8476948,"Charles Hudon","/api/v1/people/8476948","L","Left Wing","Forward","LW"
+75,8480846,"Sampo Ranta","/api/v1/people/8480846","L","Left Wing","Forward","LW"
+93,8482147,"Jean-Luc Foudy","/api/v1/people/8482147","C","Center","Forward","C"
+11,8471699,"Andrew Cogliano","/api/v1/people/8471699","C","Center","Forward","C"
+43,8471794,"Darren Helm","/api/v1/people/8471794","C","Center","Forward","C"
+6,8473446,"Erik Johnson","/api/v1/people/8473446","D","Defenseman","Defenseman","D"
+17,8476779,"Brad Hunt","/api/v1/people/8476779","D","Defenseman","Defenseman","D"
+56,8477073,"Kurtis MacDermid","/api/v1/people/8477073","D","Defenseman","Defenseman","D"
+37,8477456,"J.T. Compher","/api/v1/people/8477456","L","Left Wing","Forward","LW"
+62,8477476,"Artturi Lehkonen","/api/v1/people/8477476","L","Left Wing","Forward","LW"
+29,8477492,"Nathan MacKinnon","/api/v1/people/8477492","C","Center","Forward","C"
+13,8477501,"Valeri Nichushkin","/api/v1/people/8477501","R","Right Wing","Forward","RW"
+88,8477971,"Andreas Englund","/api/v1/people/8477971","D","Defenseman","Defenseman","D"
+7,8478038,"Devon Toews","/api/v1/people/8478038","D","Defenseman","Defenseman","D"
+96,8478420,"Mikko Rantanen","/api/v1/people/8478420","R","Right Wing","Forward","RW"
+9,8478542,"Evan Rodrigues","/api/v1/people/8478542","C","Center","Forward","C"
+81,8478843,"Denis Malgin","/api/v1/people/8478843","C","Center","Forward","C"
+49,8479398,"Samuel Girard","/api/v1/people/8479398","D","Defenseman","Defenseman","D"
+8,8480069,"Cale Makar","/api/v1/people/8480069","D","Defenseman","Defenseman","D"
+40,8480382,"Alexandar Georgiev","/api/v1/people/8480382","G","Goalie","Goalie","G"
+39,8480925,"Pavel Francouz","/api/v1/people/8480925","G","Goalie","Goalie","G"
+25,8481186,"Logan O'Connor","/api/v1/people/8481186","R","Right Wing","Forward","RW"
+18,8481618,"Alex Newhook","/api/v1/people/8481618","C","Center","Forward","C"
+59,8483570,"Ben Meyers","/api/v1/people/8483570","C","Center","Forward","C"

isapy_data-0.1.0/src/isapy_data/data/avs_roster_2022.csv

@@ -0,0 +1,25 @@
+"jersey_number","person_id","person_full_name","person_link","position_code","position_name","position_type","position_abbreviation"
+20,8479525,"Ross Colton","/api/v1/people/8479525","C","Center","Forward","C"
+75,8480846,"Sampo Ranta","/api/v1/people/8480846","L","Left Wing","Forward","LW"
+4,8481524,"Bowen Byram","/api/v1/people/8481524","D","Defenseman","Defenseman","D"
+93,8482147,"Jean-Luc Foudy","/api/v1/people/8482147","C","Center","Forward","C"
+59,8483570,"Ben Meyers","/api/v1/people/8483570","C","Center","Forward","C"
+3,8471677,"Jack Johnson","/api/v1/people/8471677","D","Defenseman","Defenseman","D"
+11,8471699,"Andrew Cogliano","/api/v1/people/8471699","C","Center","Forward","C"
+12,8475793,"Ryan Johansen","/api/v1/people/8475793","C","Center","Forward","C"
+42,8476312,"Josh Manson","/api/v1/people/8476312","D","Defenseman","Defenseman","D"
+56,8477073,"Kurtis MacDermid","/api/v1/people/8477073","D","Defenseman","Defenseman","D"
+28,8477425,"Miles Wood","/api/v1/people/8477425","L","Left Wing","Forward","LW"
+62,8477476,"Artturi Lehkonen","/api/v1/people/8477476","L","Left Wing","Forward","LW"
+29,8477492,"Nathan MacKinnon","/api/v1/people/8477492","C","Center","Forward","C"
+27,8477494,"Jonathan Drouin","/api/v1/people/8477494","L","Left Wing","Forward","LW"
+13,8477501,"Valeri Nichushkin","/api/v1/people/8477501","R","Right Wing","Forward","RW"
+42,8478028,"Fredrik Olofsson","/api/v1/people/8478028","L","Left Wing","Forward","LW"
+7,8478038,"Devon Toews","/api/v1/people/8478038","D","Defenseman","Defenseman","D"
+96,8478420,"Mikko Rantanen","/api/v1/people/8478420","R","Right Wing","Forward","RW"
+15,8479362,"Riley Tufte","/api/v1/people/8479362","L","Left Wing","Forward","LW"
+49,8479398,"Samuel Girard","/api/v1/people/8479398","D","Defenseman","Defenseman","D"
+8,8480069,"Cale Makar","/api/v1/people/8480069","D","Defenseman","Defenseman","D"
+40,8480382,"Alexandar Georgiev","/api/v1/people/8480382","G","Goalie","Goalie","G"
+39,8480925,"Pavel Francouz","/api/v1/people/8480925","G","Goalie","Goalie","G"
+25,8481186,"Logan O'Connor","/api/v1/people/8481186","R","Right Wing","Forward","RW"