Saving incident data to a file

Incident data can reveal modeling errors in the Vissim network, such as incorrectly configured conflict areas.

As part of this evaluation, you can export incident data to OpenSCENARIO XML *.XOSC files.

Ensure that the simulation parameters specify at least 10 time steps per simulation second for simulation resolution. This enables Vissim to detect collisions occurring within a single time step.

You can output the following data and data formats:

Output	Text file	Database file	Attribute file from attribute list
Aggregated data	-	-	-
Raw data	*.inc	-	-

Defining evaluation of the incident results

1. On the Evaluation menu, click > Configuration > Direct Output tab.

2. In the Incidents row, select the option Write to file.

3. You can change the time if you wish (Using the Direct output function to save evaluation results to files).

4. Click the More button.

The Detection of incidents window opens.

5. Make the desired changes:

Element

Description

Threshold

The threshold values apply both to the Incidents direct output and to the logging of incidents in the Vehicle network performance.

Note: To use the TTC and Harsh deceleration evaluation, you must have a corresponding Automotive license.

TTC: The threshold value for Time To Collision is the time it takes for two vehicles to collide with each other. Vissim calculates the TTC based on the position of the vehicles, their trajectories, and their constant speed if the vehicles are within 100 m upstream of a conflict area during the simulation run. Only this area is relevant in Vissim for detecting potential incidents based on the TTC. Vissim takes vehicles driving in reverse into account. The TTC calculation in Vissim is based on SSAM Surrogate Safety Assessment Model and Validation: Final Report. Vissim calculates TTC in a calculation time step that is the minimum of 1/10 s and the simulation time step. The evaluation specifies the TTC value at these time intervals. Do not change the vehicle type during the simulation run if you have activated the incident evaluation or are logging incidents in the Vehicle network performance. Default value 1.5 s.
Harsh deceleration, default value: - 4.00 m/s2

OpenSCENARIO

Note: An Automotive license is required to export incidents to OpenSCENARIO.

Export incidents: If this option is selected, incident data are exported between vehicles in OpenSCENARIO XML *.XOSC files. This includes vehicles allocated to the Pedestrian category. OpenSCENARIO XML Standard 1.3.1. is supported.

Radius: Radius around the incident in which trajectories of all vehicles are recorded and exported to *.XOSC files. The position of the front edge of the vehicles is relevant. If two vehicles are involved in an incident, the position of the center point between the vehicles is relevant.
Time slot: Period around the incident in which vehicle trajectories are exported to OpenSCENARIO.
Collision, Harsh deceleration, TTC types: If this option is selected, the incident data of this type are exported.

The file name of each *.XOSC file exported is based on the following structure:

<IncidentType>_start<SSSS.SSS>_veh<Id1>_veh<Id2>_simRun<run>.xosc

Example: Collision_start237.400_veh12_veh38_simRun1.xosc

The Start time start<SSSS.SSS> of the incident is given in seconds.

The *.XOSC files are saved in theOpenSCENARIO folder in the working directory of the open *.INPX file.

For incidents involving two vehicles, Vissim exports a *.XOSC file for each vehicle.

No incident data can be exported for vehicles from the mesoscopic simulation.

6. Confirm with OK.

7. Start the simulation (Running a simulation).

A *.inc file (Incidents protocol) is saved as a text file separated by semicolons. If the file was created based on the simulation of a scenario, the file name contains the name of the scenario.

Result of incidents evaluation

The *.inc file containing incident data may include the following:

Element	Description
File	Path and name of network file
Comment	Optional comment from the simulation parameters
Date	Time of evaluation
PTV Vissim	Version number, service pack number, build number
Data block	Each row contains data for an incident and the two involved vehicles (1 and 2), separated by ';’. End time of the incident in seconds Start time of the incident in seconds Vehicle number of vehicle 1 Vehicle type of vehicle 1 Link vehicle 1 was on during the incident Lane vehicle 1 was in during the incident Position of vehicle 1 on the link in meters Vehicle number of vehicle 2 Vehicle type of vehicle 2 Link vehicle 2 was on during the incident Lane vehicle 2 was in during the incident Position of vehicle 2 on the link in meters Collision TTC (A): Time To Collision is the time in seconds it takes for two vehicles to collide with each other.

Note: An Automotive license is required to export the attributes marked with an A.

*.inc file with data on incidents - sample file in Microsoft Excel™ via the menu Data > Option From Text/CSV opened. Make sure that the option Unable to recognize data types is selected for the Data type detection attribute.