Shedsoft

 

Field Reference

This is a fairly comprehensive list of the fields available to you in iRDDU2.  It is not complete but that doesn't mean you can't use the missing ones.  Any native iRacing API field can be accessed using the [SIM|IR: field prefix syntax.  For example [SIM|IR:VelocityX].

Field ID

Default Unit of Measure

Description

[SIM|BESTLAP]

Second

Best lap time

[SIM|BESTLAPNO]

None

Best lap number

[SIM|FUELLEVEL]

Litre

Current fuel level.

[SIM|INCIDENTS]

None

Number of incidents incurred.  This is based on the iRacing session string and isn’t terribly reliable.

[SIM|LASTLAP]

Second

Previous lap time

[SIM|LASTLAPNO]

None

Previous lap number within the session

[SIM|OILPRESSURE]

Bar

Oil Pressure

[SIM|OILTEMP]

C

Oil Temperature

[SIM|POSITION]

None

Local car's position within the session

[SIM|RPMPERCENTAGE]

None

Number between 0 and 100 representing the current RPM as a percentage of the local car's redline

[SIM|DRIVERCARREDLINE]

None

Maximum RPM of local driver's car

[SIM|SIMTYPE]

Text

String showing the currently running sim.

[SIM|SPEED]

MetresPerSecond

Current speed of local car

[SIM|TIME]

Second

[SIM|BLACKFLAG]

None

Is black flag being show to local driver
Returns 1 if true, otherwise 0.

[SIM|WHITEFLAG]

None

Is white flag being show to local driver
Returns 1 if true, otherwise 0.

[SIM|BLUEFLAG]

None

Is blue flag being show to local driver
Returns 1 if true, otherwise 0.

[SIM|YELLOWFLAG]

None

Is yellow flag being show to local driver
Returns 1 if true, otherwise 0.

[SIM|MEATBALLFLAG]

None

Is black and orange flag being show to local driver
Returns 1 if true, otherwise 0.

[SIM|GREENFLAG]

None

Is green flag being show to local driver
Returns 1 if true, otherwise 0.

[SIM|CHEQUEREDFLAG]

None

Is chequered flag being show to local driver
Returns 1 if true, otherwise 0.

[SIM|FUELPRESSURE]

Bar

Fuel pressure

[SIM|STINTLAPS]

None

Number of laps for local driver since the last stop

[SIM|RUNLAPS]

None

Number of laps for local driver since the start of the current run

[SIM|RUNFUEL]

None

Fuel used in current run

[SIM|CARID#{Driver ID}]

None

[SIM|CARNAME#{Driver ID}]

None

Name of car for selected driver.

[SIM|CAR#{Driver ID}]

None

[SIM|CARNUMBER#{Driver ID}]

None

Car number of selected driver

[SIM|CLUB#{Driver ID}]

Text

iRacing club of selected driver

[SIM|DRIVERNAME#{Driver ID}]

Text

Name of selected driver

[SIM|TIMETOHERE#{Driver ID}]

Second

[SIM|LICENCE#{Driver ID}]

Text

[SIM|PITLANESTATUS#{Driver ID}]

Text

[SIM|PITSTOPCOUNT#{Driver ID}]

None

[SIM|RACEDISTANCE#{Driver ID}]

None

[SIM|STATUS#{Driver ID}]

Text

Status of selected driver

VAL(

None

VAL( string to convert )
Converts a string to a number.  If the string does not contain a valid number, empty string is returned.

STR(

None

STR( number to convert )
Converts a numeric value to it's string representation using default formatting.

IF(

None

IF( condition, value if true, value if false )
Evaluates condition formula.  If the result is non zero the value if true is returned, if not then the value if false.

CHANGED(

None

CHANGED( value to check )
Checks the value passed and compares it to it's most recently stored value.  If they differ then 1 is returned, otherwise 0.

INCREASED(

None

INCREASED( value to check )
Returns 1 if the value has increased since the last time the function was called.  This function only works for numeric values, strings and bitmaps will always return 0.

DECREASED(

None

DECREASED( value to check )
Returns 1 if the value has decreased since the last time the function was called.  This function only works for numeric values, strings and bitmaps will always return 0.

SCALEVALUE(

None

Scales a value based on two numeric ranges.

ABS(

None

Strips the sign from a number

CONVERT(

None

Converts a numeric value between two units of measure.  Convetr takes three arguments:
Value to convert
Unit to convert from
Unit to convert to

For example:
CONVERT([SIM|SPEED],"METRESPERSECOND","MPH")

MAX(

None

MAX( value )
Returns the maximum value attained.

MIN(

None

MIN( value )
Returns the minimum value attained.

AVG(

None

SMOOTH(

None

SMOOTH takes two arguments; the value to smooth and the number of previous values to average.  For example:
SMOOTH([SIM|RPM],10) would return the average of the last ten RPM values passed to the function.

PROPERCASE(

Text

Converts a string to proper case where the first letter of each word is capitalised.

[SIM|SYS:CURRENTTIME]

None

Current time (local).

[SIM|SYS:CURRENTGMTTIME]

None

Current time (GMT/UTC).

[SIM|SYS:CURRENTDATE]

None

Current date (local).

[SIM|SYS:CURRENTGMTDATE]

None

Current date (GMT/UTC).

[SIM|SYS:CURRENTDATETIME]

None

Current date and time (local).

[SIM|SYS:CURRENTGMTDATETIME]

None

Current date and time (GMT/UTC).

[SIM|IR:CAMCAMERASTATE]

None

State of camera system

[SIM|IR:SESSIONFLAGS]

None

Session flags

[SIM|IR:ENGINEWARNINGS]

None

Bitfield for warning lights

[SIM|IR:CARIDXONPITROAD]

None

On pit road between the cones by car index

[SIM|IR:ISINGARAGE]

None

1=Car in garage physics running

[SIM|IR:ISREPLAYPLAYING]

None

0=replay not playing 1=replay playing

[SIM|IR:REPLAYPLAYSLOWMOTION]

None

0=not slow motion 1=replay is in slow motion

[SIM|IR:DRIVERMARKER]

None

Driver activated flag

[SIM|IR:ISONTRACK]

None

1=Car on track physics running

[SIM|IR:LAPDELTATOBESTLAP_OK]

None

Delta time for best lap is valid

[SIM|IR:LAPDELTATOOPTIMALLAP_OK]

None

Delta time for optimal lap is valid

[SIM|IR:LAPDELTATOSESSIONBESTLAP_OK]

None

Delta time for session best lap is valid

[SIM|IR:LAPDELTATOSESSIONOPTIMALLAP_OK]

None

Delta time for session optimal lap is valid

[SIM|IR:ONPITROAD]

None

Is the player car on pit road between the cones

[SIM|IR:REPLAYSESSIONTIME]

Second

Seconds since replay session start

[SIM|IR:SESSIONTIME]

Second

Seconds since session start

[SIM|IR:SESSIONTIMEREMAIN]

Second

Seconds left till session ends

[SIM|IR:LAT]

Degree

Latitude in decimal degrees

[SIM|IR:LON]

Degree

Longitude in decimal degrees

[SIM|IR:CARIDXLAPDISTPCT]

None

Percentage distance around lap by car index

[SIM|IR:CARIDXRPM]

None

Engine rpm by car index

[SIM|IR:CARIDXSTEER]

Radian

Steering wheel angle by car index

[SIM|IR:BRAKE]

None

0=brake released to 1=max pedal force

[SIM|IR:CLUTCH]

None

0=disengaged to 1=fully engaged

[SIM|IR:FUELLEVEL]

Litre

Liters of fuel remaining

[SIM|IR:FUELLEVELPCT]

None

Percent fuel remaining

[SIM|IR:FUELPRESS]

Bar

Engine fuel pressure

[SIM|IR:LAPBESTLAPTIME]

Second

Players best lap time

[SIM|IR:LAPCURRENTLAPTIME]

Second

Estimate of players current lap time as shown in F3 box

[SIM|LAPDELTATOBESTLAP]

Second

Delta time for best lap

[SIM|LAPDELTATOBESTLAP_DD]

None

Normalized delta time for best lap

[SIM|LAPDELTATOOPTIMALLAP]

Second

Delta time for optimal lap

[SIM|LAPDELTATOOPTIMALLAP_DD]

None

Normalized delta time for optimal lap

[SIM|LAPDELTATOSESSIONBESTLAP]

Second

Delta time for session best lap

[SIM|LAPDELTATOSESSIONBESTLAP_DD]

None

Normalized delta time for session best lap

[SIM|LAPDELTATOSESSIONOPTIMALLAP]

Second

Delta time for session optimal lap

[SIM|LAPDELTATOSESSIONOPTIMALLAP_DD]

None

Normalized delta time for session optimal lap

[SIM|IR:LAPDIST]

Metre

Meters traveled from S/F this lap

[SIM|IR:LAPDISTPCT]

None

Percentage distance around lap

[SIM|IR:LAPLASTLAPTIME]

Second

Players last lap time

[SIM|IR:LATACCEL]

MPSSquared

Lateral acceleration (including gravity)

[SIM|IR:LFSHOCKDEFL]

Metre

LF shock deflection

[SIM|IR:LONGACCEL]

MPSSquared

Longitudinal acceleration (including gravity)

[SIM|IR:LRSHOCKDEFL]

Metre

LR shock deflection

[SIM|IR:MANIFOLDPRESS]

Bar

Engine manifold pressure

[SIM|IR:OILLEVEL]

Litre

Engine oil level

[SIM|IR:OILPRESS]

Bar

Engine oil pressure

[SIM|IR:OILTEMP]

C

Engine oil temperature

[SIM|IR:PITCH]

Radian

Pitch orientation

[SIM|IR:PITCHRATE]

None

Pitch rate

[SIM|IR:PITOPTREPAIRLEFT]

Second

Time left for optional repairs if repairs are active

[SIM|IR:PITREPAIRLEFT]

Second

Time left for mandatory pit repairs if repairs are active

[SIM|IR:RFSHOCKDEFL]

Metre

RF shock deflection

[SIM|IR:ROLL]

Radian

Roll orientation

[SIM|IR:ROLLRATE]

None

Roll rate

[SIM|IR:RPM]

None

Engine rpm

[SIM|IR:RRSHOCKDEFL]

Metre

RR shock deflection

[SIM|IR:SHIFTGRINDRPM]

None

RPM of shifter grinding noise

[SIM|IR:SHIFTINDICATORPCT]

None

DEPRECATED use DriverCarSLBlinkRPM instead

[SIM|IR:SHIFTPOWERPCT]

None

Friction torque applied to gears when shifting or grinding

[SIM|IR:SPEED]

MetresPerSecond

GPS vehicle speed

[SIM|IR:STEERINGWHEELANGLE]

Radian

Steering wheel angle

[SIM|IR:STEERINGWHEELPCTTORQUE]

None

Force feedback % max torque on steering shaft

[SIM|IR:STEERINGWHEELTORQUE]

Nm

Output torque on steering shaft

[SIM|IR:THROTTLE]

None

0=off throttle to 1=full throttle

[SIM|IR:VELOCITYX]

MetresPerSecond

X velocity

[SIM|IR:VELOCITYY]

MetresPerSecond

Y velocity

[SIM|IR:VELOCITYZ]

MetresPerSecond

Z velocity

[SIM|IR:VERTACCEL]

MPSSquared

Vertical acceleration (including gravity)

[SIM|IR:VOLTAGE]

V

Engine voltage

[SIM|IR:WATERLEVEL]

Litre

Engine coolant level

[SIM|IR:WATERTEMP]

C

Engine coolant temp

[SIM|IR:YAW]

Radian

Yaw orientation

[SIM|IR:YAWRATE]

None

Yaw rate

[SIM|IR:ALT]

Metre

Altitude in meters

[SIM|IR:LFPRESSURE]

kPa

LF tyre pressure

[SIM|IR:LFRIDEHEIGHT]

Metre

LF ride height

[SIM|IR:LFSPEED]

MetresPerSecond

LF wheel speed

[SIM|IR:LFTEMPL]

C

LF tyre left surface temperature

[SIM|IR:LFTEMPM]

C

LF tyre middle surface temperature

[SIM|IR:LFTEMPR]

C

LF tyre right surface temperature

[SIM|IR:LRPRESSURE]

kPa

LR tyre pressure

[SIM|IR:LRRIDEHEIGHT]

Metre

LR ride height

[SIM|IR:LRSPEED]

MetresPerSecond

LR wheel speed

[SIM|IR:LRTEMPL]

C

LR tyre left surface temperature

[SIM|IR:LRTEMPM]

C

LR tyre middle surface temperature

[SIM|IR:LRTEMPR]

C

LR tyre right surface temperature

[SIM|IR:RFPRESSURE]

kPa

RF tyre pressure

[SIM|IR:RFRIDEHEIGHT]

Metre

RF ride height

[SIM|IR:RFSPEED]

MetresPerSecond

RF wheel speed

[SIM|IR:RFTEMPL]

C

RF tyre left surface temperature

[SIM|IR:RFTEMPM]

C

RF tyre middle surface temperature

[SIM|IR:RFTEMPR]

C

RF tyre right surface temperature

[SIM|IR:RRPRESSURE]

kPa

RR tyre pressure

[SIM|IR:RRRIDEHEIGHT]

Metre

RR ride height

[SIM|IR:RRSPEED]

MetresPerSecond

RR wheel speed

[SIM|IR:RRTEMPL]

C

RR tyre left surface temperature

[SIM|IR:RRTEMPM]

C

RR tyre middle surface temperature

[SIM|IR:RRTEMPR]

C

RR tyre right surface temperature

[SIM|IR:CARIDXGEAR]

None

-1=reverse 0=neutral 1..n=current gear by car index

[SIM|IR:CARIDXLAP]

None

Lap count by car index

[SIM|IR:CARIDXTRACKSURFACE]

None

Track surface type by car index

[SIM|IR:CAMCAMERANUMBER]

None

Active camera number

[SIM|IR:CAMCARIDX]

None

Active camera's focus car index

[SIM|IR:CAMGROUPNUMBER]

None

Active camera group number

[SIM|IR:RACELAPS]

None

Laps completed in race

[SIM|IR:REPLAYFRAMENUM]

None

Integer replay frame number (60 per second)

[SIM|IR:REPLAYFRAMENUMEND]

None

Integer replay frame number from end of tape

[SIM|IR:REPLAYPLAYSPEED]

None

Replay playback speed

[SIM|IR:REPLAYSESSIONNUM]

None

Replay session number

[SIM|IR:GEAR]

None

-1=reverse 0=neutral 1..n=current gear

[SIM|IR:LAP]

None

Lap count

[SIM|IR:LAPBESTLAP]

None

Players best lap number