raunakbh92/AutoRisk.jl

Julia package for assessing automotive risk

AutoRisk

quickstart

install

• First install the julia components of AutoRisk

Pkg.clone("https://github.com/sisl/AutoRisk.jl.git")
Pkg.build("AutoRisk")

# check that AutoRisk can be imported
using AutoRisk

# check that all the tests pass
Pkg.test("AutoRisk")

package outline

The goal of this package, "AutoRisk", is to make it easy to collect datasets focused on automotive risk. It builds on AutomotiveDrivingModels.jl

src

generation

• Source code in this subdirectory deals with the generation of roadways, scenes, and behavior.

roadway

• In performing a simulation, the first decision to make is what roadway should be used in the simulation.
  • Currently two roadways are considered, a stadium roadway and a straight roadway.

scene

• Scene generation in a simulation context entails populating a roadway with vehicles, each with their own state (i.e., position, velocity, acceleration, heading, etc).
  • The currently implemented heuristic scene generation populates a roadway using a set of heuristic rules.

behavior

• Behavior generation deals with populating a scene with driver models that have different types of behavior.
  • The simplest case is that of generating static parameter values for heuristic driver models.
  • Slightly more complex is sampling parameter values in an either correlated or uncorrelated manner for those heuristic models.

evaluation

• The evaluation subdirectory deals with evaluating the safety or risk associated with a generated scene. This can be viewed as a form of "policy evaluation", where the policy is defined by the driver models. The goal is to give risk estimates (where each risk estimate takes the form of a probability distribution over some event like e.g., hard braking), and we perform that here by simulating a scene many times and computing aggregate statistics from those samples.

collection

• This subdirectory contains code that orchestrates the collection of datasets. Specifically, there is a type of that controls the interaction between the generators and evaluators previously discussed, a type that runs collectors in parallel across multiple processes, and a type that acts as a container for the collected data.

analysis

• Each roadway, scene, behavior, and evaluation grouping is uniquely identified by a seed associated with it. Because of this, given a seed, we can visualize what the scene looks like and how evaluation of it proceeds. This directory deals with this process of analyzing the scenes and how they are evaluated, and for now just contains some evaluation code.

scripts

• This directory contains scripts for using AutoRisk to collect datasets (collection), for fitting models to those datasets (compression and prediction), and for visualizing datasets and scenarios (visualization).

test

• This directory contains test for the AutoRisk source files. To run tests:

julia runtests.jl

data

• This directory holds data associated with the project such as generated datasets, log files, neural network files (useable from julia), snapshots and summaries (files saved by tensorflow during training), and visualizations (generally the output from the visualization scripts).