Skip to content

Latest commit

 

History

36 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BirdsEyeTrajectoryReconstructionSHRP2NDS

This repository provides information and guidelines to use the reconstructed trajectories of naturalistic crashes and near-crashes in the SHRP2 NDS. The current README provides a concise overview of the dataset, a step‑by‑step DUL application guide (when necessary), a structure description of the dataset, and pointers to the reconstruction method and data dictionaries.

There are two options to access the dataset, both provided by the Virginia Tech Transportation Institute (VTTI).

  1. A public dataset free to be downloaded at https://doi.org/10.15787/VTT1/T7UUC1, where the raw data from SHRP2 NDS are removed while the derived data remain.
  2. The complete dataset is published at https://doi.org/10.15787/VTT1/EFYEJR. To legally use the data, one is required to obtain a SHRP2 Data Use License (DUL) since the raw data from SHRP2 NDS are included.

The detailed difference between these two versions can be compared via their corresponding data dictionaries: public version; complete version.

Note: If the DOI link shows ``Service temporarily unavailable'', first try opening the final Dataverse URL (https://dataverse.vtti.vt.edu/dataset.xhtml?persistentId=doi:10.15787/VTT1/T7UUC1) in Chrome Incognito mode. If that still fails, please download the dataset via the Dataverse Data Access API following the guide.

Discussions open to everyone

We enable GitHub Discussions for this repository, where you are welcome to ask questions, share insights, and discuss the application and use of this dataset. We encourage everyone to participate in the discussions, as it helps foster a collaborative environment for learning and improvement.

Event statistics

Event counts and distribution

Quick navigation

Important notes

1 About SHRP2 NDS

SHRP2 NDS is abbreviated from the Second Strategic Highway Research Program’s (SHRP2) Naturalistic Driving Study (NDS). It collected data with 3,300+ drivers' participation between 2010 and 2013 across six U.S. states. The participants' personal vehicles were equipped with data acquisition systems that recorded video footage, vehicle network data (e.g., speed, brake, and accelerator positions), and signals from additional sensors such as forward radar and accelerometers. A unique asset of SHRP2 NDS is the manually annotated safety‑critical events, i.e., crashes and near‑crashes, along with safe baseline segments for parallel comparison. For a full technical description of SHRP2 NDS, see 1.

2 Reconstructed data overview

2.1 Number of events

Number of events Originally recorded Subject-vehicle reconstructed Both subject and object reconstructed
Safe baselines 32,509 10,919 3,893
Safety-critical 8,895 8,111 6,664
  -Crashes 1,942 1,807 1,042
  -Near-crashes 6,953 6,304 5,262

This dataset contains reconstructed bird's eye view trajectories (at 10 fps) of 10,919 safe baseline trips and 8,111 trips involving safety-critical events (crashes and near-crashes). Among all the trips, 3,893 safe baseline trips have both the subject vehicle and at least one surrounding object reconstructed; and for safety-critical trips the number is 6,664, including 1,402 crashes and 5,262 near-crashes. The dataset is processed from two existing datasets that were derived from SHRP2 NDS 23.

2.2 Note on perception data

We would like to note that this dataset mainly contains Bird's Eye View (BEV) trajectories along with event information, and perception data such as video footage are not included. In case you are interested in perception data, please also apply for DULs of the basis datasets that this current dataset is built upon, i.e., 2 and 3.

2.3 Example events

We show 3 examples of the reconstructed events below. Event 15396984 is a crash, while 116594166 and 133297581 are near-crashes. The subject vehicle is marked as a red rectangle and the surrounding objects are shown as coloured circles, all with light green historical trajectories in the past 1 second.

Event 15396984 Event 116594166 Event 133297581

2.4 Note on data quality

Out of responsibility and transparency, we note here that the data quality of subject vehicles is much higher than that of the surrounding objects, and that the conflicting object in a safety-critical event was not always recorded. Therefore, the eventual number of useful crashes and near-crashes should be around 2.5k to 3k, depending on your filtering method.

3 Summary of useful information

To help you decide quickly

  • Driving behaviour or vehicle dynamics research? You have raw brake/steer/acceleration signals plus 10 Hz smoothed trajectories of the subject vehicles in various interaction situations.
  • Collision risk or interaction studies? You have detected objects around the subject vehicle, with 10 Hz global trajectories, all tied to the same clock.
  • Looking for certain events (crash vs. near-crash, under specific lighting/weather)? The metadata table tells you what kind of incident each event was, how severe, when and how the driver reacted, plus lighting/weather/road-surface conditions.
  • Linking to other SHRP2 datasets? Every record matches the original SHRP2 crash/near-crash hierarchy by event ID.

Below we provide a snapshot of what this dataset contains, just enough to let you decide whether to dive into the full data dictionary.

  1. Subject vehicle trajectories and signals
    For each subject (participant) vehicle,
    • original time-series states (speed, yaw rate, acceleration, brake/steer inputs, turn-signal status) and Kalman-filtered bird’s-eye trajectory (position, heading, speed, acceleration) at 10 Hz;
    • every record is tagged with an event_id (which links to crash/near-crash events) and precise timestamps (both raw ms and resampled seconds).
  2. Surrounding object trajectories
    For each object that was detected by the forward radar,
    • raw relative offsets/velocities (in the subject vehicle's local frame) and, after transforming to global coordinates and Kalman-filtered bird’s-eye trajectory (position, heading, speed) at 10 Hz;
    • each object carries a unique target id to track its path before, during, and after a safety-critical incident.
  3. Event metadata
    A compact table for all events, with
    • event category (e.g., crash, near-crash, safe baseline) and event type (e.g., leading, adjacent lane, merging, pedestrian, animal, etc);
    • vehicle dimensions (subject vehicle and primary/secondary objects);
    • key timestamps when a crash or near-crash starts, when impact or closest approach occurs, and when the driver first reacts (if applicable);
    • short narrative description, and a flag indicating whether enough object data (≥ 5 s) exists for analysis.
  4. Environment conditions (available in the complete version only)
    For each safe-critical event, environmental information is provided
    • lighting (daylight, dusk, dark, etc.),
    • weather (rain, fog, clear, etc.),
    • road-surface state (dry, wet, icy, etc.),
    • and traffic density (levels A1–F).

For more detailed information, please feel free to explore the full data dictionary for exact variable names and formats.

4 DUL application

Typical duration: 1 week ~ 1 month, depending on whether your institution is based in the U.S. and other potentially relevant context.

  1. Send a request to VTTI
    Email datasharing@vtti.vt.edu with
  2. Complete the DUL form
    VTTI will reply with an application form that covers data security, intended use, and authorised users. A single licence can cover a whole team.
  3. Submit the signed documents
    Follow the submission instructions included in the form.
  4. Await approval
    When the application is approved, you will receive personalised download credentials.
  5. Download and store the files
    Log in, grab the archives, and store them in accordance with your DUL.

5 Structure preview of the dataset

The folder structure of the complete version you will access is like

----- Parent folder
  |-- readme.md (this file)
  |-- ReconstructedTrajectories.zip
  |-- SafetyCriticalTestSet.zip
  |-- MethodExplanation.pdf
  |-- OverallDataDictionary.pdf

and of the public version you will access is like

Free to download directly at https://doi.org/10.15787/VTT1/T7UUC1
----- OverallDataDictionary_T7UUC1.pdf
----- T7UUC1_Bird'sEyeView_Dataset.zip
  |-- ReconstructedTrajectories.zip
  |-- SafetyCriticalTestSet.zip

where ReconstructedTrajectories.zip contains the reconstructed trajectories of all the trips, and SafetyCriticalTestSet.zip contains the safety-critical test set. Within each of the zipped files. The MethodExplanation.pdf describes the methods used to process these data.

6 Method summary and data dictionary

In this repository under the folder ./pdfs/, we provide MethodExplanation.pdf, OverallDataDictionary_PublicVersion.pdf and OverallDataDictionary.pdf to know more details about this dataset.

7 Suggested citation and disclaimer

If you find this dataset useful, please kindly cite us:

For the public version:

@report{jiao2026shrpcrash,
author = {Jiao, Yiru and Calvert, Simeon and Costa, Rufina},
publisher = {VTTI},
title = {Bird’s eye view trajectory reconstruction of naturalistic crashes and near-crashes in the SHRP2 NDS (Public Version)},
year = {2026},
doi = {10.15787/VTT1/T7UUC1},
}

For the complete version:

@report{jiao2025shrpcrash,
author = {Jiao, Yiru and Calvert, Simeon},
publisher = {VTTI},
title = {Bird’s eye view trajectory reconstruction of naturalistic crashes and near-crashes in the SHRP2 NDS},
year = {2025},
doi = {10.15787/VTT1/EFYEJR},
}

In addition, a disclaimer below is recommended to be included in your Acknowledgements according to the DUL you will obtain:

This study used data from a derived set of the SHRP2 Naturalistic Driving Study, ``Bird's eye view trajectory reconstruction of naturalistic crashes and near-crashes in the SHRP2 NDS'' (doi: 10.15787/VTT1/EFYEJR). The data are accessed under the SHRP2 Data Use License your DUL number, issued by the Virginia Tech Transportation Institute (VTTI). The findings and conclusions presented here are those of the authors and do not necessarily represent the views of VTTI, the Transportation Research Board, the National Academies, or the Federal Highway Administration.

References

Footnotes

  1. J. M. Hankey, M. A. Perez, and J. A. McClafferty. Description of the SHRP 2 Naturalistic Database and the Crash, Near-Crash, and Baseline Data Sets. Tech. rep. Virginia Tech Transportation Institute, 2016.

  2. E. Sears, M. A. Perez, K. Dan, T. Shimamiya, T. Hashimoto, M. Kimura, S. Yamada, and T. Seo. A Study on the Factors That Affect the Occurrence of Crashes and Near-Crashes. Version V2. 2019. URL: https://doi.org/10.15787/VTT1/FQLUWZ 2

  3. C. K. Layman, M. A. Perez, T. Sugino, and J. Eggert. Research of Driver Assistant System. Version V3. 2019. URL: https://doi.org/10.15787/VTT1/DEDACT 2

About

This repository shares information and guidelines to use the reconstructed trajectories of naturalistic crashes and near-crashes in the SHRP2 NDS.

Topics

Resources

Stars

14 stars

Watchers

0 watching

Forks

Packages

Contributors