README.md 2.13 KB
Newer Older
Diego García Fierro's avatar
Diego García Fierro committed
1
# Driver Emotions Agent based Social Simulation System
Diego García Fierro's avatar
Diego García Fierro committed
2

Diego García Fierro's avatar
Diego García Fierro committed
3
## Description ##
Diego García Fierro's avatar
Diego García Fierro committed
4

Diego García Fierro's avatar
Diego García Fierro committed
5
An **Agent based Social Simulation System** is proposed to analyse the way factors such as **emotions**, **personality** and **stress** interact and shape **driving styles**. Driver Agents are characterized by emotions, a personality profile, stress and distractions they might experience during the simulation, as well as several driving traits that define the way a driver behaves on the road: speed, acceleration, braking, steering and response time. A level system based on the intensity and the tendency of drivers towards each driving trait is defined in order to characterize driving styles. 
Diego García Fierro's avatar
Diego García Fierro committed
6

Diego García Fierro's avatar
Diego García Fierro committed
7
A model for **accident probability estimation** is included as well. The proposed model uses the Poisson Distribution to calculate accident probability. An accident dataset with accident reports of the city of Las Vegas (USA) between 2015 and 2018, used to obtain accident ocurrence rates for the Poisson Distribution application, is included in the repository. 
Diego García Fierro's avatar
Diego García Fierro committed
8

Diego García Fierro's avatar
Diego García Fierro committed
9
## Usage ##
Diego García Fierro's avatar
Diego García Fierro committed
10

Diego García Fierro's avatar
Diego García Fierro committed
11
Execution of the Simulation Model is carried out through the *run.py* file. Drivers taking part in the simulation can be modified in the *general.ini* configuration file, as well as steps for each simulation. 
Diego García Fierro's avatar
Diego García Fierro committed
12
13
14
15
16

Driver Agents are assigned random emotion, personality profile and stress values at the beginning of the simulation. Emotions, stress and distractions each Driver Agent is exposed to can change throughout the simulation. In each simulation step, the contribution that emotions and stress have to driving styles is considered. Personality is only evaluated at the beginning of the simulation. 

Accident probability, calculated depending on the driving trait each Driver Agent stands out for (the one with more contributions and therefore the one that characterizes the Driver Agent's style the most) and the presence of distractions, is provided for each simulation step. 

Diego García Fierro's avatar
Diego García Fierro committed
17
Data collected from each simulation is specified in both the *add_collectors(self)* function in the *Model.py* file and in the *DriverCollector.py* file. 
Diego García Fierro's avatar
Diego García Fierro committed
18

Diego García Fierro's avatar
Diego García Fierro committed
19
## Support ## 
Diego García Fierro's avatar
Diego García Fierro committed
20
21
22

[Mesa Documentation](https://mesa.readthedocs.io/en/stable/index.html)