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:
- Data is outputted to Disk and/or Live. Not all data goes to both. Not all data is available in replays.
- There are certain variables that are only available on specific cars if implemented e.g. Boost Levels and Hybrid technology.
- iRacing uses CamelCase labels for the outputted metrics e.g. LapBestLapTime (Players best lap time).
- 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.