The goal of this repo is to generate predictive models for FRC matches. The folders are structured by competition year. See 2019/generate_training_data.py for a very bare-bones approach to producing input examples. I've achieved about 68% accuracy using a random forest implementation (four-fold cross-validation) using only the team names as inputs. Note however this uses information from the future to predict past results. Lots of work to do to add more features (even historical features) and also build towards only predicting forwards in time.

The rest of this README has auto-generated details about the swagger API generated from https://www.thebluealliance.com/swagger/api_v3.json I encountered some unexpected webcast types and made minor modifications to models\webcast.py to handle them. See https://github.com/swagger-api/swagger-codegen#online-generators for more information on auto-generating client API code. Note there's a lot of missing information below. Start from 2019/generate_training_data.py for a working example.

For 2020 notebooks see the 2020 folder.

Information and statistics about FIRST Robotics Competition teams and events.

All endpoints require an Auth Key to be passed in the header X-TBA-Auth-Key. If you do not have an auth key yet, you can obtain one from your Account Page. A User-Agent header may need to be set to prevent a 403 Unauthorized error.

This Python package is automatically generated by the Swagger Codegen project:

• API version: 3.04.1
• Package version: 1.0.0
• Build package: io.swagger.codegen.languages.PythonClientCodegen

Python 2.7 and 3.4+

If the python package is hosted on Github, you can install directly from Github

pip install git+https://github.com//.git

(you may need to run pip with root permission: sudo pip install git+https://github.com//.git)

Then import the package:

import swagger_client 

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import swagger_client

Please follow the installation procedure and then run the following:

from __future__ import print_function
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apiKey
configuration = swagger_client.Configuration()
configuration.api_key['X-TBA-Auth-Key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['X-TBA-Auth-Key'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.TBAApi(swagger_client.ApiClient(configuration))
if_modified_since = 'if_modified_since_example' # str | Value of the `Last-Modified` header in the most recently cached response by the client. (optional)

try:
    api_response = api_instance.get_status(if_modified_since=if_modified_since)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling TBAApi->get_status: %s\n" % e)

All URIs are relative to https://www.thebluealliance.com/api/v3

• APIStatus
• APIStatusAppVersion
• Award
• AwardRecipient
• DistrictList
• DistrictRanking
• DistrictRankingEventPoints
• EliminationAlliance
• EliminationAllianceBackup
• EliminationAllianceStatus
• Event
• EventDistrictPoints
• EventDistrictPointsPoints
• EventDistrictPointsTiebreakers
• EventInsights
• EventInsights2016
• EventInsights2017
• EventInsights2018
• EventOPRs
• EventPredictions
• EventRanking
• EventRankingExtraStatsInfo
• EventRankingRankings
• EventRankingSortOrderInfo
• EventSimple
• Match
• MatchAlliance
• MatchScoreBreakdown2015
• MatchScoreBreakdown2015Alliance
• MatchScoreBreakdown2016
• MatchScoreBreakdown2016Alliance
• MatchScoreBreakdown2017
• MatchScoreBreakdown2017Alliance
• MatchScoreBreakdown2018
• MatchScoreBreakdown2018Alliance
• MatchScoreBreakdown2019
• MatchScoreBreakdown2019Alliance
• MatchSimple
• MatchSimpleAlliances
• MatchTimeseries2018
• MatchVideos
• Media
• Team
• TeamEventStatus
• TeamEventStatusAlliance
• TeamEventStatusAllianceBackup
• TeamEventStatusPlayoff
• TeamEventStatusRank
• TeamEventStatusRankRanking
• TeamEventStatusRankSortOrderInfo
• TeamRobot
• TeamSimple
• WLTRecord
• Webcast

• Type: API key
• API key parameter name: X-TBA-Auth-Key
• Location: HTTP header