Skip to main content

CoBaIR is a Python library for Context Based Intention Recognition

Project description

CoBaIR

CoBaIR is a python library for Context Based Intention Recognition. It provides the means to infer an intention from given context. An intention is a binary value e.g. repair pipe that can either be present or not. Only one intention can be present at a time. Context on the otherhand can have multiple discrete instantiations e.g. weather:sunny|cloudy|raining. If context values are continuous, discretizer functions can be used to create discrete values. From the inferred intention in a HRI scenario the robot can perform corresponding actions to help the human with a specific task.

Publications

For a more in-depth explanation consult the following papers:

Install

pip install CoBaIR

You can install the library from your local copy after cloning this repo with pip using pip install . or install the newest experimental features from the develop branch with pip install git+https://github.com/dfki-ric/CoBaIR.git@develop

Known Issues

On some Linux Distros there seems to be a problem with a shared library. This Solutions suggests to export LD_PRELOAD=/usr/lib/x86_64-linux-gnu/libstdc++.so.6 which works on Ubuntu 22.04.

Graphical User Interface

GUI

To make the configuration of a scenario easier we provide a Graphical User Interface(GUI). The GUI can be started with

python start_configurator.py

if you want to start the GUI with a loaded config use

python start_configurator.py -f config.yml

Tutorial

For a step-by-step guide on how to use CoBaIR, check out our Tutorial.

Documentation

The Documentation can be accessed on https://dfki-ric.github.io/CoBaIR/

Bayesian Approach

In the bayesian approach CoBaIR uses a two-layer Bayesian Net of the following structure. two-layer Bayesian Net

Config Format

Configs will be saved in yml files. For convenience the is a configurator which can be started with

python start_configurator.py

Bayesian Approach

The configuration file for a two layer bayesian net for context based intention recognition follows the given format:

# List of contexts. Contexts can have different discrete instantiations. 
# Number of instantiations must be larger than 1.
# For all discrete instantiations a prior probability must be given(sum for one context must be 1)
contexts:
  context 1:
    instantiation 1 : float
      .
    instantiation m_1 : float
  context n:
    instantiation 1 : float
      .
    instantiation m_n : float
# List of intentions. Intentions are always binary(either present or not)
# For every intention the context variables and their influence on the intention is given
# [very high, high, medium, low, very low, no] => [5, 4, 3, 2, 1, 0]
intentions: 
  intention 1:
    context 1:
        instantiation 1: int # one out of [5, 4, 3, 2, 1, 0]
        .
        instantiation m_1: int # one out of [5, 4, 3, 2, 1, 0]
    context n:
        instantiation 1: int # one out of [5, 4, 3, 2, 1, 0]
        .
        instantiation m_n: int # one out of [5, 4, 3, 2, 1, 0]
  intention p:
    context 1:
        instantiation 1: int # one out of [5, 4, 3, 2, 1, 0]
        .
        instantiation m_1: int # one out of [5, 4, 3, 2, 1, 0]
    context n:
        instantiation 1: int # one out of [5, 4, 3, 2, 1, 0]
        .
        instantiation m_n: int # one out of [5, 4, 3, 2, 1, 0]
# decision_threshold is a float value between 0 and 1 which decides 
# when an intention should be considered in inference.
# Probability must be greater than decision_threshold.
decision_threshold: float

How to contribute

If you find any Bugs or want to contribute/suggest a new feature you can create a Merge Request / Pull Request or contact me directly via adrian.lubitz@dfki.de

Run tests

Tests are implemented with pytest. To install test dependencies you need to run

pip install -r requirements/test_requirements.txt

Then you can run

python -m pytest tests/

You can as well see the test report for a specific commit in gitlab under pipeline->Tests

Coverage

If you want to see coverage for the tests you can run

coverage run -m pytest tests/

Use

coverage report

or

coverage html

You can as well see the coverage for a specific job in gitlab under jobs

To show results of the coverage analysis.

Build docu

Documentation is implemented with the material theme for mkdocs.

Dependencies

Install all dependencies for building the docu with

pip install -r requirements/doc_requirements.txt

Build

Build the docu with

mkdocs build

The documentation will be in the site folder.

Authors

Adrian Lubitz & Arunima Gopikrishnan

Funding

CoBaIR is currently developed in the Robotics Group of the University of Bremen, together with the Robotics Innovation Center of the German Research Center for Artificial Intelligence (DFKI) in Bremen. CoBaIR has been funded by the German Federal Ministry for Economic Affairs and Energy and the German Aerospace Center (DLR). CoBaIR been used and/or developed in the KiMMI-SF project.

Project details


Download files

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

Source Distribution

CoBaIR-4.0.3.tar.gz (31.0 kB view details)

Uploaded Source

Built Distribution

CoBaIR-4.0.3-py3-none-any.whl (38.0 kB view details)

Uploaded Python 3

File details

Details for the file CoBaIR-4.0.3.tar.gz.

File metadata

  • Download URL: CoBaIR-4.0.3.tar.gz
  • Upload date:
  • Size: 31.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.18

File hashes

Hashes for CoBaIR-4.0.3.tar.gz
Algorithm Hash digest
SHA256 cb8404852f92a8bc7322fdf177317238b74ff1e3d6c1922175b7b53ae5e0b561
MD5 d52292fbf8e8e0eb5895edc357b146e1
BLAKE2b-256 b1c5dbcbde7930c69e81b05929549969ad577beb89440b632b821f6bcc50b91a

See more details on using hashes here.

File details

Details for the file CoBaIR-4.0.3-py3-none-any.whl.

File metadata

  • Download URL: CoBaIR-4.0.3-py3-none-any.whl
  • Upload date:
  • Size: 38.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.18

File hashes

Hashes for CoBaIR-4.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b35ae15742d8014d290cdfb97b46725682d99a96c26123ccfe02f2b79ee8e3ea
MD5 585df807f0e11070752455d1384d3f48
BLAKE2b-256 1e65e426f7135d4fa637f0144681631e0c2af656de3286ca9e754172058e86d4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page