https://github.com/samcfuchs/frc-data

A library of scripts to retrieve and process FRC data from The Blue Alliance
https://github.com/samcfuchs/frc-data

data-science frc tba-api

Last synced: about 1 month ago
JSON representation

A library of scripts to retrieve and process FRC data from The Blue Alliance

• Host: GitHub
• URL: https://github.com/samcfuchs/frc-data
• Owner: Samcfuchs
• Created: 2019-04-16T15:41:24.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-12-08T05:10:04.000Z (about 2 years ago)
• Last Synced: 2023-03-01T07:45:53.986Z (almost 2 years ago)
• Topics: data-science, frc, tba-api
• Language: Jupyter Notebook
• Size: 1.33 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 10
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# FRC Data Retrieval

Various data retrieval scripts to import, clean, and save FRC data to csv files

All data is written to files in the `data` folder.

## Installation

Use `pip install -r requirements.txt` to install all required packages for this

project.

In order to use the APIs these scripts access, you'll need to obtain

authorization keys. You can get a TBA key

[here](https://www.thebluealliance.com/account/). Additionally, TeamInfo.py uses

google's geocoder API to get geographic coordinates for each team. Learn more

about the geocoding API and get a key

[here](https://developers.google.com/maps/documentation/geocoding/get-api-key).

Once you have authorization keys, add them to a `keys.json` file in the project

root as `TBA_API_KEY` and `GOOGLE_API_KEY` respectively.

## Analytics

Once the data is saved to csv files, it can be analyzed with a number of tools.

It's simple to open in excel, but I've also used R, Tableau, TIBCO Spotfire, and

python scripts to allow deeper insights into databases of this size. I encourage

you to conduct your own exploratory data analysis and publish your findings!

## Futurity

I've worked pretty hard to ensure that these scripts are as general and

future-proof as possible, but since I don't control the APIs or databases I'm

using, there's always the possibility that a change in the future could break

these. If you're encountering errors, please feel free to create an issue or PR.

In particular, the MatchData script does a lot of preprocessing of the data from

The Blue Alliance, and as a result it needs to be updated on a yearly basis.

Unfortunately, FIRST releases its API spec as late as week 1 competitions

sometimes, so I'm unable to update them until then.