nfelodcm 0.1.16__tar.gz → 0.1.18__tar.gz

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: nfelodcm
-Version: 0.1.16
+Version: 0.1.18
 Summary: Python package for loading and caching CSVs hosted on github into pandas dataframes
 Author-email: Robert Greer <nfl@robbygreer.com>
 Maintainer-email: Robert Greer <nfl@robbygreer.com>

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/__init__.py

@@ -2,4 +2,5 @@ from .nfelodcm.nfelodcm import get_df
 from .nfelodcm.nfelodcm import load
 from .nfelodcm.nfelodcm import get_map
 from .nfelodcm.nfelodcm import get_season_state
+from .nfelodcm.nfelodcm import list_tables
 from .nfelodcm.tests import test_all_maps

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/coaches.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/coaches/commits?path=coaches.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:16:46.766999+00:00"
+    "last_freshness_check": "2025-04-11T03:43:44.723569+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/filmmargins.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/filmmargin/commits?path=film_margins.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:09:33.640711+00:00"
+    "last_freshness_check": "2025-04-11T03:40:13.559253+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/games.json

@@ -1,7 +1,7 @@
 {
   "name": "games",
   "description": "nflgamedata games",
-  "last_local_update": "2025-02-16T22:09:31.790994",
+  "last_local_update": "2025-02-21T21:36:03.065281",
   "download_url": "https://raw.githubusercontent.com/nflverse/nfldata/master/data/games.csv",
   "compression": null,
   "engine": "c",
@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/nflverse/nfldata/commits",
     "gh_release_tag": null,
     "sla_seconds": 500,
-    "last_freshness_check": "2025-02-16T22:09:31.154882+00:00"
+    "last_freshness_check": "2025-04-11T03:40:12.791636+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/hfa.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/nfelohfa/commits?path=estimated_hfa.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:16:48.864737+00:00"
+    "last_freshness_check": "2025-04-11T03:43:45.669221+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/logos.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/nflverse/nflverse-pbp/commits?path=teams_colors_logos.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:09:33.199326+00:00"
+    "last_freshness_check": "2025-04-11T03:40:13.189362+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/market_data.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/nfelomarket_data/commits?path=Data/lines.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:16:00.686478+00:00"
+    "last_freshness_check": "2025-04-11T03:43:14.936702+00:00"
   },
   "iter": {
     "type": null,

nfelodcm-0.1.18/nfelodcm/Maps/nfelo_games.json

@@ -0,0 +1,67 @@
+{
+  "name": "nfelo_games",
+  "description": "nfelo projections and components by game",
+  "last_local_update": "2025-04-11T03:43:09.514955",
+  "download_url": "https://raw.githubusercontent.com/greerreNFL/nfelo/refs/heads/main/output_data/nfelo_games.csv",
+  "compression": null,
+  "engine": "c",
+  "freshness": {
+    "type": "gh_commit",
+    "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/nfelo/commits?path=output_data/nfelo_games.csv",
+    "gh_release_tag": null,
+    "sla_seconds": 900,
+    "last_freshness_check": "2025-04-11T03:43:08.957068+00:00"
+  },
+  "iter": {
+    "type": null,
+    "start": null
+  },
+  "assignments": [],
+  "map": {
+    "game_id": "object",
+    "starting_nfelo_home": "float32",
+    "starting_nfelo_away": "float32",
+    "hfa_mod": "float32",
+    "home_bye_mod": "float32",
+    "away_bye_mod": "float32",
+    "div_game_mod": "float32",
+    "dif_surface_mod": "float32",
+    "home_time_advantage_mod": "float32",
+    "home_538_qb_adj": "float32",
+    "away_538_qb_adj": "float32",
+    "home_net_qb_mod": "float32",
+    "home_net_bye_mod": "float32",
+    "nfelo_dif_base": "float32",
+    "nfelo_dif_open": "float32",
+    "nfelo_dif_close": "float32",
+    "nfelo_home_line_open": "float32",
+    "nfelo_home_line_close": "float32",
+    "nfelo_home_probability_close": "float32",
+    "nfelo_home_probability_open": "float32",
+    "nfelo_home_cover_prob_close": "float32",
+    "nfelo_home_push_prob_close": "float32",
+    "nfelo_home_loss_prob_close": "float32",
+    "nfelo_away_cover_prob_close": "float32",
+    "nfelo_away_push_prob_close": "float32",
+    "nfelo_away_loss_prob_close": "float32",
+    "home_open_ev": "float32",
+    "away_open_ev": "float32",
+    "home_close_ev": "float32",
+    "away_close_ev": "float32",
+    "home_line_open": "float32",
+    "home_line_open_price": "float32",
+    "away_line_open_price": "float32",
+    "home_line_close": "float32",
+    "home_line_close_price": "float32",
+    "away_line_close_price": "float32",
+    "total_line_open": "float32",
+    "under_price_open": "float32",
+    "over_price_open": "float32",
+    "total_line_close": "float32",
+    "under_price_close": "float32",
+    "over_price_close": "float32",
+    "home_implied_win_probability_open": "float32",
+    "home_implied_win_probability_close": "float32",
+    "hfa_base_mod": "float32"
+  }
+}

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/participants.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/nflverse/nflverse-data/releases/tags",
     "gh_release_tag": "pbp_participation",
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:16:40.111639+00:00"
+    "last_freshness_check": "2025-04-11T03:43:38.965336+00:00"
   },
   "iter": {
     "type": "season",

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/pbp.json

@@ -1,7 +1,7 @@
 {
   "name": "pbp",
   "description": "nflfastR play-by-play",
-  "last_local_update": "2025-02-16T22:15:30.902710",
+  "last_local_update": "2025-04-11T03:42:49.815214",
   "download_url": "https://github.com/nflverse/nflverse-data/releases/download/pbp/play_by_play_{0}.csv.gz",
   "compression": "gzip",
   "engine": "c",
@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/nflverse/nflverse-data/releases/tags",
     "gh_release_tag": "pbp",
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:09:35.145636+00:00"
+    "last_freshness_check": "2025-04-11T03:40:14.186786+00:00"
   },
   "iter": {
     "type": "season",

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/player_stats.json

@@ -1,7 +1,7 @@
 {
   "name": "player_stats",
   "description": "nflfastR player stats",
-  "last_local_update": "2025-02-16T22:15:53.903240",
+  "last_local_update": "2025-04-11T03:43:12.955364",
   "download_url": "https://github.com/nflverse/nflverse-data/releases/download/player_stats/player_stats.csv.gz",
   "compression": "gzip",
   "engine": "c",
@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/nflverse/nflverse-data/releases/tags",
     "gh_release_tag": "player_stats",
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:15:50.270905+00:00"
+    "last_freshness_check": "2025-04-11T03:43:10.220176+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/players.json

@@ -1,7 +1,7 @@
 {
   "name": "players",
   "description": "nflfastR player meta data",
-  "last_local_update": "2025-02-16T22:16:46.380017",
+  "last_local_update": "2025-04-11T03:43:44.328746",
   "download_url": "https://github.com/nflverse/nflverse-data/releases/download/players/players.csv",
   "compression": null,
   "engine": "c",
@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/nflverse/nflverse-data/releases/tags",
     "gh_release_tag": "players",
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:16:42.813778+00:00"
+    "last_freshness_check": "2025-04-11T03:43:41.668023+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/qbelo.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/nfeloqb/commits?path=qb_elos.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:15:57.129304+00:00"
+    "last_freshness_check": "2025-04-11T03:43:13.960461+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/qbr.json

@@ -1,7 +1,7 @@
 {
   "name": "qbr",
   "description": "nflverse QBR",
-  "last_local_update": "2025-02-16T22:09:30.769332",
+  "last_local_update": "2025-04-11T03:40:12.469427",
   "download_url": "https://github.com/nflverse/nflverse-data/releases/download/espn_data/qbr_season_level.csv",
   "compression": null,
   "engine": "c",
@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/nflverse/nflverse-data/releases/tags",
     "gh_release_tag": "espn_data",
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:09:29.563951+00:00"
+    "last_freshness_check": "2025-04-11T03:40:11.568916+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/rosters.json

@@ -1,7 +1,7 @@
 {
   "name": "rosters",
   "description": "nflfastR rosters",
-  "last_local_update": "2025-02-16T22:16:39.581240",
+  "last_local_update": "2025-04-11T03:43:38.547563",
   "download_url": "https://github.com/nflverse/nflverse-data/releases/download/rosters/roster_{0}.csv",
   "compression": null,
   "engine": "c",
@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/nflverse/nflverse-data/releases/tags",
     "gh_release_tag": "rosters",
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:16:02.273228+00:00"
+    "last_freshness_check": "2025-04-11T03:43:15.395917+00:00"
   },
   "iter": {
     "type": "season",

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/srs_ratings.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/nfelosrs/commits?path=srs_ratings.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:15:59.563723+00:00"
+    "last_freshness_check": "2025-04-11T03:43:14.511337+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/stadiums.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/Stadiums/commits?path=data/stadiums.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:16:47.582418+00:00"
+    "last_freshness_check": "2025-04-11T03:43:45.025132+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/team_stadiums.json

@@ -1,7 +1,7 @@
 {
   "name": "team_stadiums",
   "description": "Metadata and analytics for NFL teams and their stadiums",
-  "last_local_update": "2025-02-16T22:09:34.777661",
+  "last_local_update": "2025-02-21T21:36:04.215102",
   "download_url": "https://raw.githubusercontent.com/greerreNFL/Stadiums/refs/heads/main/data/team_stadiums.csv",
   "compression": null,
   "engine": "c",
@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/Stadiums/commits?path=data/team_stadiums.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:09:34.634198+00:00"
+    "last_freshness_check": "2025-04-11T03:40:13.883435+00:00"
   },
   "iter": {
     "type": null,
@@ -18,11 +18,15 @@
   },
   "assignments": [],
   "map": {
+    "team": "object",
+    "team_fastr": "object",
+    "stadium": "object",
+    "is_current": "bool",
     "stadium_name": "object",
     "lat": "float32",
     "lon": "float32",
     "altitude": "float32",
-    "heading": "float32",
+    "heading": "int32",
     "first_game_date": "object",
     "last_game_date": "object",
     "surface_type": "object",
@@ -33,7 +37,7 @@
     "zipcode": "object",
     "country": "object",
     "tz": "object",
-    "tz_offset": "float32",
+    "tz_offset": "int32",
     "wikipedia_url": "object",
     "img_sat_url": "object",
     "img_logo_url": "object",
@@ -44,7 +48,7 @@
     "operator": "object",
     "capacity": "float32",
     "broke_ground": "float32",
-    "opened": "float32",
+    "opened": "int32",
     "closed": "float32",
     "demolished": "float32",
     "construction_cost": "float32",

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/wepa.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/wepa/commits?path=data/wepa_by_game_pit.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:15:54.752364+00:00"
+    "last_freshness_check": "2025-04-11T03:43:13.566080+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Maps/wt_ratings.json

@@ -10,7 +10,7 @@
     "gh_api_endpoint": "https://api.github.com/repos/greerreNFL/nfelosrs/commits?path=wt_ratings.csv",
     "gh_release_tag": null,
     "sla_seconds": 900,
-    "last_freshness_check": "2025-02-16T22:16:48.337189+00:00"
+    "last_freshness_check": "2025-04-11T03:43:45.314437+00:00"
   },
   "iter": {
     "type": null,

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/Utilities/__init__.py

@@ -4,4 +4,5 @@ from .set_season_state import set_season_state
 from .checks import check_struc
 from .checks import check_map_type
 from .checks import check_data
-from .checks import check_data_folder
+from .checks import check_data_folder
+from .load_maps import load_maps

nfelodcm-0.1.18/nfelodcm/Utilities/load_maps.py

@@ -0,0 +1,30 @@
+## built-in ##
+import pathlib
+import json
+from typing import Dict
+
+def load_maps() -> Dict[str, Dict]:
+    '''
+    Loads all maps from the Maps folder
+
+    Parameters:
+    * None
+
+    Returns:
+    * Dict[str, Dict] - a dictionary of table names and their corresponding maps
+    '''
+    ## container for maps ##
+    maps = {}
+    ## get maps ##
+    maps_dir = pathlib.Path(__file__).parent.parent.resolve() / 'Maps'
+    existing_maps = list(maps_dir.glob('*.json'))
+    ## check that maps were found ##
+    if len(existing_maps) > 0:
+        for map_path in existing_maps:
+            ## parse the name ##
+            table = map_path.stem
+            ## load the map ##
+            with open(map_path, 'r') as map_json:
+                maps[table] = json.load(map_json)
+    ## return ##
+    return maps

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm/nfelodcm.py

@@ -1,8 +1,12 @@
-import pandas as pd
-import numpy
+## built-in ##
 import pathlib
 import json
+from typing import List, Dict
+## external ##
+import pandas as pd
+import numpy
 
+## local ##
 from .Engine import DCMTable
 import nfelodcm.nfelodcm.Utilities as utils
 
@@ -14,19 +18,39 @@ utils.set_season_state()
 utils.check_data()
 
 ## wrappers and classes to interact with the package ##
-def get_df(table):
+def get_df(table: str) -> pd.DataFrame:
     """
-    gets a single table
+    Load a single dataframe
+
+    Parameters:
+    * table: str - the name of the table to load
+
+    Returns:
+    * pd.DataFrame - the dataframe loaded from the table
     """
     engine = DCMTable(table)
     return engine.localIO.df
 
-def load(tables):
+def load(tables: List[str]) -> Dict[str, pd.DataFrame]:
     """
     loads an array of tables and returns a dictionary
+
+    Parameters:
+    * tables: List[str] - a list of table names to load
+
+    Returns:
+    * Dict[str, pd.DataFrame] - a dictionary of table names and their corresponding dataframes
     """
     ## init db structure ##
     db = {}
+    ## check that all passed tables have maps ##
+    map_data = utils.load_maps()
+    maps = list(map_data.keys()) if len(map_data) > 0 else []
+    missing_maps = [t for t in tables if t not in maps]
+    if len(missing_maps) > 0:
+        raise Exception('MAP ERROR: The following tables do not have maps: {0}'.format(
+            '\n     '.join(missing_maps)
+        ))
     ## add tables ##
     for table in tables:
         db[table] = get_df(table)
@@ -49,7 +73,7 @@ def get_map(url):
             col, dtype
         ))
 
-def get_season_state(state_type='last_full_week'):
+def get_season_state(state_type='last_full_week') -> tuple:
     '''
     Returns the season and week of the specified state type:
        'last_full_week' (default): the last week in which no games are still unplayed
@@ -67,4 +91,21 @@ def get_season_state(state_type='last_full_week'):
             state_type, '\n     '.join(list(global_variables['season_states'].keys()))
         ))
     ## if state valid, return ##
-    return global_variables['season_states'][state_type]['season'], global_variables['season_states'][state_type]['week']
+    return global_variables['season_states'][state_type]['season'], global_variables['season_states'][state_type]['week']
+
+def list_tables() -> None:
+    '''
+    Lists all tables available to the package
+
+    Parameters:
+    * None
+
+    Returns:
+    * None (prints list of tables)
+    '''
+    ## get maps ##
+    maps = utils.load_maps()
+    ## print ##
+    print('Available tables:')
+    for table, table_map in maps.items():
+        print('     {0} - {1}'.format(table, table_map['description']))

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: nfelodcm
-Version: 0.1.16
+Version: 0.1.18
 Summary: Python package for loading and caching CSVs hosted on github into pandas dataframes
 Author-email: Robert Greer <nfl@robbygreer.com>
 Maintainer-email: Robert Greer <nfl@robbygreer.com>

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/nfelodcm.egg-info/SOURCES.txt

@@ -27,6 +27,7 @@ pyproject.toml
 ./nfelodcm/Maps/hfa.json
 ./nfelodcm/Maps/logos.json
 ./nfelodcm/Maps/market_data.json
+./nfelodcm/Maps/nfelo_games.json
 ./nfelodcm/Maps/participants.json
 ./nfelodcm/Maps/pbp.json
 ./nfelodcm/Maps/player_stats.json
@@ -43,6 +44,7 @@ pyproject.toml
 ./nfelodcm/Utilities/checks.py
 ./nfelodcm/Utilities/extract_map.py
 ./nfelodcm/Utilities/global_variables.json
+./nfelodcm/Utilities/load_maps.py
 ./nfelodcm/Utilities/retrieve_season_state.py
 ./nfelodcm/Utilities/set_season_state.py
 nfelodcm/nfelodcm.py
@@ -75,6 +77,7 @@ nfelodcm/Maps/games.json
 nfelodcm/Maps/hfa.json
 nfelodcm/Maps/logos.json
 nfelodcm/Maps/market_data.json
+nfelodcm/Maps/nfelo_games.json
 nfelodcm/Maps/participants.json
 nfelodcm/Maps/pbp.json
 nfelodcm/Maps/player_stats.json
@@ -91,5 +94,6 @@ nfelodcm/Utilities/__init__.py
 nfelodcm/Utilities/checks.py
 nfelodcm/Utilities/extract_map.py
 nfelodcm/Utilities/global_variables.json
+nfelodcm/Utilities/load_maps.py
 nfelodcm/Utilities/retrieve_season_state.py
 nfelodcm/Utilities/set_season_state.py

{nfelodcm-0.1.16 → nfelodcm-0.1.18}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nfelodcm"
-version = "0.1.16"
+version = "0.1.18"
 readme = "README.md"
 requires-python = ">=3.11"
 license = {text = "MIT"}