Skip to main content

User Guide

Validrive is a desktop app that helps you review and validate driving events quickly, without having to click through Daredeevil manually.

Instead of opening Excel, copying, searching, replaying, and marking events one by one, Validrive lets you do it all in one simple window.

1. Installation

  • Validrive comes as a single file: Validrive.exe
  • Place it anywhere on your computer (for example, on your Desktop).
  • Double-click to open it.

No setup or installation is needed.

2. Loading your data

  1. Click Upload File.
  2. Select your Excel (.xlsx) or CSV file with event information.
  3. The events will appear in the left panel.
  4. A preview of your file appears on the right. You can show or hide this preview at any time using the Show preview checkbox.

Required columns

Your file must contain these columns:

  • caps → the capsule name (e.g. CERTIF_BCB_5503_ACC_20230313_095820_400Mid_RSL)
  • event_type → the type of event (e.g. lane_change, lane_keep)
  • start_time → when the event starts (in seconds, e.g. 1.44)
  • end_time → when the event ends (in seconds, e.g. 4.23)

Example file

capsevent_typestart_timeend_time
CERTIF_BCB_5503_ACC_20230313_095820_400Midlane_change12.4517.56
CERTIF_BCB_5503_ACC_20230313_100250_400Midlane_keep4044.33

3. Connecting to Daredeevil

  1. In Validrive, click Connect Browser.
  2. A Chrome window will open automatically. Validrive will:
  • Launch Daredeevil,
  • Detect your file and create a capsule list,
  • Choose the right environment (classic Daredeevil or SW500) based on the caps column.
    If the capsule name contains “SDV”, it will connect to SW500 Daredeevil. Otherwise, it connects to the standard Daredeevil.
  1. If you want to stop the connection at any time, click Disconnect Browser.

Note: Before connecting, make sure you are already logged in to Daredeevil in Chrome. Validrive uses your existing login cookies, so you won’t be asked to log in again inside the app.

4. Actions

Once connected, you can perform different actions on each event from your file.
By default, all events start as invalidated until you review them.

Validate

Mark an event as reviewed. This doesn’t mean the event was necessarily “correct” — only that you have checked it and confirmed the information is fine as given.

Examples:

  • An event labeled lane_change really is a lane change → mark as validated.
  • An event labeled braking was checked and the label is consistent → mark as validated.

Correct event

Modify the event information if the original data was wrong or incomplete. You can:

  • Change the event type.
  • Adjust the start/end time.
  • Edit a custom column (any additional field in your file).

Examples:

  • The file says lane_keep, but in the video you see a lane_change → correct type.
  • The event is labeled as starting at 12.0s, but the real action starts at 12.8s → correct start time.
  • Add a custom note in a comment column → correct custom column.

Invalidate

Leave the event as not reviewed. This is the default state for all events when first loaded.
It means you haven’t validated or corrected it yet.

Examples:

  • A new event appears in your file → it is automatically invalidated until you check it.
  • You skip an event because you’re not sure yet → keep it invalidated.

Split

Break one long event into several smaller ones. Each sub-event gets its own ID and can be validated or corrected individually.

Example:

  • An event from 10.0s to 30.0s actually contains two separate lane changes:
    • First lane change from 10.0s to 18.0s.
    • Second lane change from 18.5s to 30.0s.

Merge

Combine multiple consecutive events into one single event.

Example:

  • Two events (15.0s to 16.5s and 16.7s to 18.5s) are actually part of the same lane change → merge into one event from 15.0s to 18.5s.

Replay

Re-watch the current event in Daredeevil from its exact start frame.

Examples:

  • You validated an event but want to double-check → replay it.
  • You corrected the timing and want to see if the new start time matches → replay it.

Undo

Cancel your last change. This restores the event list to its previous state.

Examples:

  • You accidentally validated the wrong event → undo.
  • You corrected start time but typed the wrong value → undo.

Report

See a summary of your progress: how many events are validated, corrected, invalidated, etc.

Example:

  • End of session: check the report to see you reviewed 120 events, with 80 validated, 30 corrected, and 10 still invalidated.

5. Filtering events

On the left, you can use filters to find events:

  • By duration (longer/shorter than X seconds).
  • By event type.
  • By capsule name (contains certain text).
  • By status (Validated / Corrected / Invalidated).

There are quick filters for the most common cases, and personalized filters where you can filter by any column in your file.

6. Images

If your file includes an image_path column, you can display images linked to each event.

  • Use relative paths if the images are in the same folder as your Excel file.
    Example: screenshots:image1.png
  • Or use absolute paths if the images are stored elsewhere.
    Example: C:\Users\Name\Desktop\img1.png

In Validrive, check the “Show image” box to enable image previews.

Example file with images

capsevent_typestart_timeend_timeimage_path
CERTIF_BCB_5503_ACC_20230313_095820_400Midlane_change12.017.5screenshots:image1.png
CERTIF_BCB_5503_ACC_20230313_100250_400Midlane_keep40.044.2C:\Users\Me\img2.png

7. Saving results

All your changes are saved automatically into the copy of your Excel/CSV file that Validrive created when you first uploaded it.
Your original file stays untouched.