The main utilities provided by this repo are for:
- Scoring iRacing leagues, and pushing up results to a Google Sheet
- Pulling and creating reports of iRacing sessions
There are a few other scripts that may or may not work....
score_league.py - Pull all data associated with a iRacing league and score one or more seasons using our scoring methodology.
This also provides a mechanism for publishing scores to a Google sheet.
Using Protobuf to setup the data model
When updating the objects.proto, run (from this directory):
protoc.exe --python_out=. objects.proto
As part of our scoring system, we include the TrueSkill library. Based on finishing positions, it calculates a mu and sigma for skill grading. Mu being the rating and sigma being the confidence level.
We are utilizing gspread to connect and publish scores to google sheets.
Here is an example sheet.
If you would like to do this, you will need to make your own google project, and use a project oauth json file as your credentials.
If you are working within the AMS team, you can be added to our ams project.
To get the required credentials json, goto the project and click Credentials under the APIs & Services,
and click the download arrow on the AMS_Utils row under the OAuth 2.0 Client IDs section.
This will bring up a dialog where you can download the json file.
Rename it credentials.json and place it in your working directory.
If it's been a while, and you are getting errors connecting Delete this file %AppData%\Roaming\gspread\authorized_user.json
aussie_pursuit.py - Uses the iRacing API to analyze a provided session id to calculate penalty times for all cars.
An aussie pursuit race is a multiclass race where each driver gets a penalty time based on their lap time.
The intent of the penalties is to time them so that all drivers in all cars all have the ability to cross the finish line at the same time.