Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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.

Installation & 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.

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

promis-4.0.0.dev2.tar.gz (3.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

promis-4.0.0.dev2-py3-none-any.whl (3.1 MB view details)

Uploaded Python 3

File details

Details for the file promis-4.0.0.dev2.tar.gz.

File metadata

  • Download URL: promis-4.0.0.dev2.tar.gz
  • Upload date:
  • Size: 3.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for promis-4.0.0.dev2.tar.gz
Algorithm Hash digest
SHA256 5ea87c1cf6b13b9c2edba609aa7ddb7623395acbf67862ed94c4bf44d43b3e56
MD5 f4723e854cb03fba16ccc57959049e2f
BLAKE2b-256 7885b5ee8fb87786d764cd3d8f7f930caf915144ce0a0752267f6bd322bb21eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for promis-4.0.0.dev2.tar.gz:

Publisher: python-publish.yml on HRI-EU/ProMis

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file promis-4.0.0.dev2-py3-none-any.whl.

File metadata

  • Download URL: promis-4.0.0.dev2-py3-none-any.whl
  • Upload date:
  • Size: 3.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for promis-4.0.0.dev2-py3-none-any.whl
Algorithm Hash digest
SHA256 01fca69fdfb3d8dc504686f1c4400e54ded34abdb7e281e3c956f23048b47ec8
MD5 8328f0d9c7040832836a96bbb38d781f
BLAKE2b-256 5e19fb102ee2ccb23778666eeb83d2bae6fe80c6660d30b4ed767d1dd97d8f9f

See more details on using hashes here.

Provenance

The following attestation bundles were made for promis-4.0.0.dev2-py3-none-any.whl:

Publisher: python-publish.yml on HRI-EU/ProMis

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

4.0.0.dev2 This release

2 files

3.0.0

2 files

2.0.0

2 files

1.0.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page