Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 31 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,36 @@
# Automated Driving Open Research (ADORe)

![ADORe Logo](documentation/landing_page/img/adore_logo_white.png)

## About ADORe
Eclipse ADORe is a modular software library and toolkit for decision making, planning, control and simulation of
automated vehicles. It is developed by [The German Aerospace Center (DLR),
Institute for Transportation Systems 🔗](https://www.dlr.de/ts/en).

ADORe provides some of the following features and capabilities:
- Algorithms and data models applied in real automated driving system for
motion planning and control
- Mechanisms for safe interaction with other CAVs, infrastructure, traffic
management, interactions with human-driven vehicles, bicyclists, pedestrians
automated vehicles. It is developed by [The German Aerospace Center (DLR), Institute for Transportation Systems 🔗](https://www.dlr.de/ts/en).
- ADORe is [ROS 2 🔗](https://ros.org) based
- ADORe is fully containerized using [Docker 🔗](https://docker.io)
- ADORe is currently deployed on DLR TS institute research vehicles [FASCar 🔗](https://www.dlr.de/en/research-and-transfer/research-infrastructure/fascar-en) and [VIEWCar II🔗](https://www.dlr.de/en/research-and-transfer/research-infrastructure/view-car)
- ADORe is currently deployed on DLR TS institute research vehicles [FASCar 🔗](https://www.dlr.de/en/research-and-transfer/research-infrastructure/fascar-en) and [VIEWCar II🔗](https://www.dlr.de/en/research-and-transfer/research-infrastructure/view-car)
- ADORe is developed with algorithms and data models applied in real automated driving system for motion planning and control
- ADORe features mechanisms for safe interaction with other CAVs, infrastructure, traffic management, interactions with human-driven vehicles, bicyclists, pedestrians

ADORe is designed around both single agent automated driving (SAAD) and multi agent automated driving (MAAD), to allow both individual and cooperative driving behaviors. ADORes features can be seperated into the following categories.

![ADORe Overview](documentation/landing_page/img/adore_categories_overview.svg)

### SAAD

While driving automated for a single agent, for example on a vehicle like the DLR NGC, ADORe utilized the SAAD modules, viewing ADORe SAAD as a black box of inputs and outputs, get a representation as seen below.

![ADORe SAAD](documentation/landing_page/img/adore_saad.svg)

An ADORe control system works in concert with a perception stack (not provided) to control an autonomous vehicle
platform.
Using V2X radio messages, a list of detected objects and ego vehicle position and velocity, the ADORe control system
provides control inputs to a vehicle platform in order to steer it along a given high-definition roadmap to the desired
goal location.
![ADORe architectural overview](https://github.com/DLR-TS/adore_support/blob/master/documentation/adore_overview_v03_20221027.png?raw=true)
Diving deeper into the ROS2 node structure of ADORe SAAD leads to be the structure seen below.

![ADORe SAAD Structure](documentation/landing_page/img/adore_saad_structure.svg)


### MAAD

When using ADORe for control of multiple agent in a cooperative environment, ADORe MAAD can calculate trajectories and behaviors for multiple vehicles at once. Viewing ADORe MAAD as a black box of inputs and outputs, it can been show as seen here.

![ADORe MAAD](documentation/landing_page/img/adore_maad.svg)

# Documentation
In order to get started, it is advised to first check system requirements, follow the installation instruction and then
Expand All @@ -35,6 +46,11 @@ try out the demo scenarios.
Here you can see one of our automated test vehicles being operated by ADORe:
[![ADORe example video 🔗](https://github.com/DLR-TS/adore_support/blob/master/vivre_flythrough_screenshot2.png?raw=true)](https://youtu.be/tlhPDtr4yxg)

https://www.youtube.com/watch?v=bRZc1iFohCU
https://www.youtube.com/watch?v=MANc_xQ_8sI
https://www.youtube.com/watch?v=Aqvd82A40S4
https://www.youtube.com/watch?v=IYbv7Y2nt-k

# Example application
The following video shows an automated vehicle controlled by ADORe in an urban setting in Braunschweig, Germany:
[![ADORe example video](https://github.com/DLR-TS/adore_support/blob/master/adore_vivre_video_preview_20221027.png?raw=true)](https://youtu.be/tlhPDtr4yxg)
Expand Down
4 changes: 4 additions & 0 deletions documentation/landing_page/img/adore_categories_overview.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions documentation/landing_page/img/adore_maad.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions documentation/landing_page/img/adore_saad.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions documentation/landing_page/img/adore_saad_structure.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading