Giter Site home page Giter Site logo

josedv82 / nba-game-density-app Goto Github PK

View Code? Open in Web Editor NEW
7.0 3.0 2.0 2.47 MB

An app to visually explore the density (and other related factors) of the schedule for NBA teams.

Home Page: https://josedv.shinyapps.io/NBASchedule/

License: MIT License

R 100.00%
nba-stats nba nba-visualization shiny shinyapps shinydashboard

nba-game-density-app's Introduction

NBA Game Density App

An app to explore the density of the NBA Schedule.

Intro

This app let users manipulate different aspects related to the game density (frequency of games) in the NBA for both, a selected team and its opponents over the last 5 seasons. Users can manipulate factors such as court advantage, travel stress, time zones crossed, game density index, direction of travel, etc to understand period of higher or lower schedule stress.

Live Website

NBA Game Density App

App Description

NBA schedules are characterized by high density with teams having to play multiple games every week in different cities. Furthermore, there are many other factors such as late games, frequent travel, different time zones that may affect a team's performance.

This app provides a platform to manipulate different game density factors to better understand what type of schedule stress teams are undergoing at different times during the season. This can help coaches plan travel, training and recovery strategies accordingly.

Based on the schedule parameters set by the user, the app provides a few different reports and visualization options in two ways, team level and individual player.

App Workflow

Left SideBar

Users can control the app and the tabs they want to see from the left side menu. A few filtering options are presented here to filter by season and team.

Team by Team Item

Based on the user selection, a mini-table with game density information is displayed below.

There are four tabs available within the team by team item:

Game Card

The landing page of the app. A comparison of different parameters for each game, including information about score, location, rest days, game index and moving index as well as a dynamic map tracking flight routes for the selected team prior to the game of interest.

Furthermore, a link to watch the game highlights is provided. Currently, more than 90% of the games have video highlights available, providing more than 200 hours of video footage. (Video highlights are only available up to the 2020 season)

Likewise, boxscores for each game are available for both, the selected them and the oponent. Individual player loads are provided along with common game stats for different aspects of the game.

Finally, users wishing to visualize shotcharts for every player/game can do that from the GameCard View. Upon selecting a player, the shot chart will highlight shots made/missed, the locations on the court. The court will have different degrees of shadows to highlight what are the most commong shooting locations for each player/season.

Schedule Table

Likely the most important report in the app. A dynamic table showing full season metrics. Different metrics are reported on this table, using color codes to alert users about the magnitude of the parameters. This table provides a birds-eye-view of the schedule density to identify periods of higher and lower schedule stress.

Rolling View Visualization

On the 3rd tab, users can interact with a dynamic visualization containing a line chart of the rolling density for the selected team (orange) and the opponents (blue). Complementary, a boxplot chart is provided to better understand the distribution of the data points throughout the season.

Outcome Tab

The Outcome tab provides 2tables.Table one (left) shows game outcomes by density type for each game. For example, wins and losses in situations when the selected team plays 3 games in 4 days (3IN4) vs a team playing on a back to back (B2B).

The second table (right) simply summarises the number of wins and losses by location (away or home).

Player Load Tab

Player Load is an arbitrary score calculated based on how many rest days a player had prior to a game as well as the total number of minutes the player was on the court. Based on those two parameters an overall load metric is calculated. The Player Load tab enables users to explore longitudinal load trends for each player.

A dynamic search filter is available enabling users to select number of last games and provide cummulative load metrics for those.

All Teams Item

The all teams item provides a summary table counting all types of density for each team for each season. Users can filter by "away games", "home games" or both.

The Heatmap tab shows rolling index for each team for the whole season, enabling users to compare this metric for all teams at any time.

Travel Routes

The travel route tab displays approximate regular season flight paths for each team.

The coordinates used are the main coordinates for each city. It is important to stress the fact that these paths are purely estimations based on the location of consecutive games as well as the time elapsed between them. Therefore, they may not be accurate representations of how teams actually managed their travels.

Player Load Table

The Player Load table enables league wide comparisons all load related metrics for all players in the season. A variety of filtering options are available at the top for users to slice and filter their data based on their preferences.

Research / Media Item

This part of the app contains a dynamic table showing NBA travel and density related research and media articles. While this research is independent from the author of this website, we thought it may be of interest for users wanting to learn more about how different factors related to schedule density may affect performance and injuries.

All articles listed on the table contained a link that users can follow to reach the original text. New articles (if available) are uploaded monthly.

Potentially further reports will be implemented.

Game Index Metric and Right Side Bar

Game Index is a metric that provides information about potential travel/schedule stress a team might be undergoing (note this metric is arbitrary and has not been validated). It is a composite score accounting for several factors such as rest days between games, travels prior to game, direction of travel, time zones crossed, accumulated density, game location. Rather than setting fixed weights for each parameters used to calculate overall game index, we provide options for users to manipulate each parameters based on their own preferences.

Users can also opt to look at a moving average of the Index metric for 'x' number of games. The last tab on the right side bar provides this option.

Data Sources

The data used to create this app was downloaded from BigDataBall and Basketball-Reference.

For more information on nomenclature used throughout this app when refering to types of rest days, please visit this link.

Game Stats, player images and all shot related data was downloaded using the package NBAstatR which allows users to pin the stats.nba.com website.

Video highlights of the games have been escraped from Youtube

Final Comments

Data related to teams travel and player load is based on information publicly available from a variety of sources as stated above. It may not be an accurate representation of the way teams really managed their schedule.

AIRBALL

If interested in quickly extracting some of the metrics used throughout this app, I created an R package called {airball} which enables seamless extraction of travel/schedule metrics (by team and player) and injuries for all NBA seasons since the 1947.

nba-game-density-app's People

Contributors

josedv82 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

Forkers

nliced jkope892

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.