Skip to content
SportVU movement tracking data.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.


Ever since the nba stopped public access of their movement data, I though it would be good to have a copy of @neilmj data repo incase he deletes his data repo.

Credit: @neilmj

Data Setup

1.To unzip the 7z file run this command

cd data
sudo ./

Additional Data Conversions

  1. Additional scripts are provided. To complete these steps, add your project directory to the file in the movement package.
import os
# change this data_dir for personal path
if os.environ['HOME'] == '/home/neil':
    data_dir = '/home/neil/projects/nba-movement-data'
    raise Exception("Unspecified data_dir, unknown environment")
  1. Install the user package. You may need to run this in sudo.
python build
python install
  1. Convert the JSON files.
python movement/
  1. Convert the full-court to half-court. An explanation of moving the SportVU movement can be found here.
python movement/
  1. The fixed shot times, along with the shot locations in half court space are in data/shots/fixed_shots.csv. They are formed from executing the script.

In the fixing logic, the shot time is defined as the highest acceleration point before the ball reaches it's peak, within a defined window. The logic can be seen below. plot

You can’t perform that action at this time.