About iRaceInsight

iRaceInsight is a light(ish) agent much like Garage61 and VRS that reads SDK data from the iRacing Simulator.

During sessions it will push that data to the iRaceEngineer and you can view it on the dash.

Data Storage

The iRaceInsight app will create the following folder C:\Users\username\iRaceInsight. Inside it will create: - A logs folder for storing log files - A save folder for saving information related to MQTT tranmissions and ... (This is useful for debugging) - A configuration file iRaceInsight.conf that will need some updates before you can use iRaceInsight successfully.

Update Interval

iRacings SDK updates at 60 FPS which equates to one frame every 0.0167 seconds or 16.7 milliseconds.

We update the GUI every 16ms by default but this can be changed in the iRaceInsight.conf.

Data Gathered

In addition to the update interval, there are a few things to understand about the data from the iRacing SDK:

  1. Data is outputted to Disk and/or Live. Not all data goes to both. Not all data is available in replays.
  2. There are certain variables that are only available on specific cars if implemented e.g. Boost Levels and Hybrid technology.
  3. iRacing uses CamelCase labels for the outputted metrics e.g. LapBestLapTime (Players best lap time).
  4. Any variables that are internally calculated will be (should be) lowercase with underscore.

Stored Data

Session Info

LABEL VARIABLE DESCRIPTION
Series SeriesID
SeasonID
SessionID
SubSessionID
LeagueID
SessionNum
Event_Date
CustID
TeamID
TrackID
CarID
CarFuel_KgPerLtr
CarFuel_MaxLtr
CarFuel_FuelPct
Ephemeral
TeamRacing

Session Status

LABEL VARIABLE DESCRIPTION
SimSession
SessionNum
PlayerCarIdx Players carIdx
SessionState Session state - irsdk_SessionState
SessionTick Current update number
SessionTimeOfDay Time of day in seconds
SessionTime Seconds since session start
SessionTimeRemain Seconds left till session ends
SessionLapsTotal Total number of laps in session
SessionLapsRemainEx New improved laps left till session ends

Weather

LABEL VARIABLE DESCRIPTION
SimSession
SessionNum
Air Temp. AirTemp Temperature of air at start/finish line
Humidity RelativeHumidity Relative Humidity at start/finish line
Track Temp. TrackTempCrew Temperature of track measured by crew around track
Density AirDensity Density of air at start/finish line
Pressure AirPressure Pressure of air at start/finish line
Fog Level FogLevel Fog level
Skies Skies Skies (0=clear/1=p cloudy/2=m cloudy/3=overcast)
Precipitation Precipitation Precipitation at start/finish line
Wind WindDir Wind direction at start/finish line
Wind WindVel Wind velocity at start/finish line
Track Wet TrackWetness How wet is the average track surface
Wet Declared WeatherDeclaredWet The steward says rain tires can be used

Lap Data

LABEL VARIABLE DESCRIPTION
Lap No CarIdxLap Lap count by car index.
Position CarIdxPosition Cars position in race by car index.
Class Position CarIdxClassPosition Cars class position in race by car index.
Last Lap Time CarIdxLastLapTime Cars last lap time.
F2 Time CarIdxF2Time Race time behind leader or fastest lap time otherwise.
Clean Lap clean_lap Where any incident points obtained on the Last Lap
Fuel Used fuel_used Fuel used on the Last Lap
Track Temp TrackTempCrew Temperature of track measured by crew around track
Track Wetness TrackWetness How wet is the average track surface. See irsdk_TrackWetness.

Pit Stats

LABEL VARIABLE DESCRIPTION
Pit In Lap pit_in_lap The lap that the pits were entered on.
In Time in_time Time entered pit lane from SessionTime.
Out Time out_time Time left the pit lane from SessionTime.
Total Time stop_length The Total Time spent in the Pits calculated from out_time - in_time
Service Start service_start_time The time that the service started from SessionTime and the PitstopActive flag
Service Stop service_end_time The time that the service stops from SessionTime and the PitstopActive flag
Service Time service_time The Total Time of the service calculated from service_end_time - service_start_time

Tyres

Tyre Data from each pit stop is also stored.

Calculated Data

Some data is calculated on the fly from the stored data such as the driver stats.