> For the complete documentation index, see [llms.txt](https://dahl-design.gitbook.io/properties/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dahl-design.gitbook.io/properties/properties/lap-timing.md).

# Lap timing

Propertes based on recodering, storing and tracking info about your laps. Built into the plugin is a system for storing your **lap records in a .csv file**. This file is automatically generated in your SimHub main folder, and you can view you lap times there. The reasoning for this is that the *PersistantTrackerPlugin.AllTimeBest* lap times will include corner cutting/off-track lap times, as well as joker laps for rally cross, making it useless in many cases. Also, the .csv store additional information on these lap times, used for other calculations.

The plugin also features a **lap time delta system**, completely indenpentent from iRacing or SimHub delta telemetry. It is based on recodring your lap time at several (Around 20 per kilometer, minimum 40) checkpoints around the track; for previous lap, session best land and lap record -> and then comparing your current lap on each checkpoint. The motivation to build this system is that the delta from telemetry was often confusing and not matching session best and lap record laps. It was hard to tell what the delta was referring to. Also, last lap delta was not availble.

The downside of this delta system is that the 60 Hz data flow limits the resolution of lap timing. So the delta values produced are not accurate to the 0.001s. They are very accurate to 0.1s, and fairly accurate to the 0.01s.

The **delta change** properties are strings of several values that represent delta changes over a given number of mini sectors (20). This is to avoid having to make 60 properties for delta change. You can extract the sector you want using the the javascript split() command in the dashboard editor; see how I did it in Dashboard.

<table data-view="cards"><thead><tr><th>Name</th><th>Description</th><th>Type</th></tr></thead><tbody><tr><td>Pace</td><td>Dynamic estimation of race pace, adjusts to sudden changes in pace (damage, new tires) and excludes outlaps, inlaps and laps with time lost to crash/road-off</td><td>timespan</td></tr><tr><td>PredictedLapTime</td><td>An estimation of what current lap time will be based on performance on previous laps, performance on current lap, variations in delta on current lap, distance driven and a few more factors.</td><td>timespan</td></tr><tr><td>SessionBestLap</td><td>Session best valid lap time.</td><td>timespan</td></tr><tr><td>LapRecord</td><td>All time best valid lap time. Stored in the LapRecords.csv file in SimHub folder</td><td>timespan</td></tr><tr><td>OptimalLapTime</td><td>Fastest lap this session based on your fastest valid sector times</td><td>timespan</td></tr><tr><td>QualyWarmUpLap</td><td>Whether you're on warmup lap or not</td><td>boolean</td></tr><tr><td>QualyLap1Status</td><td>Lone qualify lap 1 status: 1 - Waiting, 2 - Lap started, 3 - Lap ruined, 4 - Lap finished and valid</td><td>1-4</td></tr><tr><td>QualyLap2Status</td><td>Lone qualify lap 2 status: 1 - Waiting, 2 - Lap started, 3 - Lap ruined, 4 - Lap finished and valid</td><td>1-4</td></tr><tr><td>QualyLap1Time</td><td>Lap time on 1st qualy lap, will show live lap time when you're on lap 1</td><td>timespan</td></tr><tr><td>QualyLap2Time</td><td>Lap time on 2nd qualy lap, will show live lap time when you're on lap 2</td><td>timespan</td></tr><tr><td>DeltaLastLap</td><td>Delta to last lap time</td><td>seconds</td></tr><tr><td>DeltaSessionBest</td><td>Delta to session best lap time</td><td>seconds</td></tr><tr><td>DeltaLapRecord</td><td>Delta to record lap time</td><td>seconds</td></tr><tr><td>DeltaLastLapChange</td><td>String containing the change in delta to last lap time over 20 mini sectors, separated by a comma.</td><td>string</td></tr><tr><td>DeltaSessionBestChange</td><td>String containing the change in delta to session best lap time over 20 mini sectors, separated by a comma.</td><td>string</td></tr><tr><td>DeltaLapRecordChange</td><td>String containing the change in delta to the record lap time over 20 mini sectors, separated by a comma.</td><td>string</td></tr><tr><td>LapStatus</td><td>Status of current lap. 1 - Valid lap, 2 - Invalid lap, 3 - Out lap, 4 - Black flag/will get deleted, 5 - In lap, 6 - Joker lap</td><td>1 - 6</td></tr><tr><td>SpeedDeltaLapRecord</td><td>Delta to the car speed at the same track location on your record lap.</td><td>km/h</td></tr><tr><td>SpeedPercentDeltaLapRecord</td><td>Percent increase/decrease in car speed compared to record lap at this track location</td><td>percent</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dahl-design.gitbook.io/properties/properties/lap-timing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.