Skip to content

Event Injection

During simulation runs, it can be advantageous to deterministically trigger events (such as harsh acceleration or hash braking) at fixed times throughout the journey timeline. To facilitate this kind of event modelling, the triggering of pre-configured events into the running simulation model is supported via event injection.

A brief overview of how to get started with run-time event injection is provided in the following tutorial video:

At present, event injection events are modelled after a subset of webhook event triggers. These are briefly outlined in the table below:

Event
Description
harsh_acceleration Trigger abrupt changes in the accelerator pedal position.
harsh_braking Trigger abrupt changes in the brake pedal position.

Event Modelling

Event injection modelling is carried out under the event injection view, this can be navigated to by selecting Event Injection from the configuration drawer:

Event Injection in Navigation Drawer

This will then navigate to the Event Injection view, from which events can be selected, configured, and added to the event timeline:

Event Injection Event Selection

Note that the injection time itself is relative to the simulation start time, and will persist across runs. Each simulation stop/start cycle will reset the injection timers, with any premature stopping of the simulation automatically cancelling the remaining injection events.

As multiple events are scheduled, they will automatically appear in the timeline view:

Event Injection Event Timeline

events in the timeline view can further be temporarily disabled or deleted outright before returning to the simulation view.

With a number of events now modelled, run the simulator as normal. At the prescribed intervals, the defined events will be injected into the running simulation:

Event Injection Simulation View

Each of the injected events will be combined together with the event update received from the vehicle dynamics model, and will automatically update the simulation UI when the events are injected. If configured, webhook notifications will also be triggered for each of the injected events.