Skip to main content

Probabilistic Mission Design

Resin reasoning · ProMis mission design · CoFi tracking · CoCo control

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. The rules are written in Resin, a reactive probabilistic logic language whose syntax and semantics are described in its language reference. Using ProMis, scalar fields of the probability of adhering to the agent's constitution are obtained across its state space.

Building on these landscapes, we further provide CoFi, which tracks agents that are expected to follow their constitution, and CoCo, steering agents to comply with it. 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.

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.

Citation

If you use ProMis, please cite the paper below.

@ARTICLE{11193664,
  author={Kohaut, Simon and Flade, Benedict and Ochs, Daniel and Dhami, Devendra Singh and Eggert, Julian and Kersting, Kristian},
  journal={IEEE Transactions on Intelligent Transportation Systems}, 
  title={Probabilistic Mission Design for Neuro-Symbolic Unmanned Aircraft Systems}, 
  year={2025},
  volume={26},
  number={12},
  pages={22751-22760},
  doi={10.1109/TITS.2025.3609835}
}

You may further be interested in consulting the following accompanying works:

Metadata

Release files for promis 4.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for promis 4.0.0
File Size Uploaded Provenance Actions
promis-4.0.0.tar.gz 911.9 kB With provenance Details for promis-4.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for promis 4.0.0
File Interpreter ABI Platform Actions
promis-4.0.0-py3-none-any.whl Python 3 none any Details for promis-4.0.0-py3-none-any.whl

Total release size: 1.9 MB

Release files / promis-4.0.0.tar.gz

Download URL promis-4.0.0.tar.gz
Size 911.9 kB
Tags Source
SHA-256 checksum
How to use checksums
1536b241006abdbc3d8ac52df84c1d3f4560d4f07d2abbf26db24c84f7bf53ac
BLAKE2b-256 checksum
How to use checksums
c401a387bae12578a97f3f0a0cf7cdb6625c285dcf4d098fbf188a2d115261d1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Release files / promis-4.0.0-py3-none-any.whl

Download URL promis-4.0.0-py3-none-any.whl
Size 947.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a4c4dc7ccced237d3cee5b480e13fec88a467671f075d67764cf06e69d27c75c
BLAKE2b-256 checksum
How to use checksums
d699aed55038cd02815aa0447e6d3259cfb946223c927058f75ce33080440c3f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

Security for promis 4.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for promis-4.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 29, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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