Thanks to visit codestin.com
Credit goes to github.com

Skip to content

HRI-EU/ProMis

Repository files navigation

Probabilistic Mission Design

This repository implements Probabilistic Mission Design (ProMis). ProMis enables users to formalize their knowledge of local rules, such as traffic regulations, to constrain an agent's actions and movements. To achieve this, we employ probabilistic first-order logic, a mathematical framework that combines formal reasoning with probabilistic inference. This provides a weighted belief whether the encoded rules are satisfied for a state or action.

Using ProMis, we pave the way towards Constitutional Agents. Such agents can give reasons for their actions and act in a principled fashion even under uncertainty. To this end, ProMis provides high-level, easy-to-understand, and adaptable control over the navigation process, for example, to seamlessly integrate local laws, operator requirements, and environmental uncertainties into logical and spatial constraints.

Using ProMis, scalar fields of the probability of adhering to the agent's constitution are obtained across its state space. These can then be utilized for tasks such as path planning, automated clearance granting, explaining the impact of, and optimizing mission parameters. For instance, the following shows ProMis being applied in a diverse set of scenarios, with a high probability of satisfying all flight restrictions being shown in blue, a low probability being shown in red, and unsuitable spaces being transparent.

Usage

To install ProMis, please follow the instructions here. For an in-depth walkthrough on applying ProMis in your own applications, you can check our usage guide. An interactive version of the usage guide is also available in this repository.

Cite

Please consult and cite the following publications for an in-depth discussion of the methods implemented in this repository.

For specific use cases, please cite the following works as well.

Documentation

ProMis' documentation is available online. It can also be built locally with the following commands.

git clone 
pip install ".[doc]"

mkdir -p doc/source/notebooks
cp examples/*.ipynb doc/source/notebooks
sphinx-build -b html doc/source _build/html

To view the documentation, open the file ProMis/doc/build/html/index.html using the browser of your choice.

Contributing

This project is set up to be checked and formatted with ruff check and ruff format. Use pytest to run automated tests.

License

Copyright (c) 2023 Simon Kohaut, Honda Research Institute Europe GmbH, Felix Divo, and contributors. See LICENSE.md for details.

About

Probabilistic Mission Design for Neuro-Symbolic Transportation Systems.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •