Skip to content
Task models for human robot collaboration
Branch: master
Clone or download
Latest commit c5d7ec3 Jul 17, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
samples [doc] Documentation and cleanup. Mar 28, 2018
tests Version working with 128 states with cumulative features based on obj… Feb 12, 2018
visualization Minor. Jul 17, 2018
.gitignore Updated gitignore Sep 5, 2016
.travis.yml [travis] More granular slack notifications to reduce clutter. Jul 11, 2017
README.rst [readme] Minor changes. Mar 28, 2018
requirements.txt Adds travis support. Apr 3, 2017 [utils] Excludes test directory of utils from Jul 12, 2017


Task models for human robot collaboration

Tools to manipulate and use task models for human robot collaboration.

If you are using this software and or one of its components, we warmly recommend you to cite the following paper:

[Roncone2017](1, 2) Roncone Alessandro, Mangin Olivier, Scassellati Brian Transparent Role Assignment and Task Allocation in Human Robot Collaboration IEEE International Conference on Robotics and Automation (ICRA 2017), Singapore. [PDF] [BIB]

Repository overview

The top-level directories contain the following code:

  • samples: scripts,
  • tests: unittests (run python -m unittest discover tests),
  • visualization: task models and policies visualizations based on d3.js <>.

The code from the task_models package contains a set of classes to represents models of tasks for human robot collaboration and in particular hierarchical task models. The code mostly consists in the following components:

  • The and modules define useful classes used in In addition to providing useful objects to represent hierarchies of task (HTM), the latter also implements the techniques for extracting such structure that were introduced in [Hayes2016].
  • The lib directory provides: - a python wrapper to Anthony Cassandra's POMDP solver. Please visit - a partial implementation of [Silver2010], - belief representations, - compatibility code for python 2 and 3, - additional helpers.
  • utils is a clone of
  • code mostly used for [Roncone2017].
[Silver2010]Silver, David and Veness, Joel Monte-Carlo Planning in Large POMDPs (2010)
[Hayes2016]Hayes, Bradley and Scassellati, Brian Autonomously constructing hierarchical task networks for planning and human-robot collaboration, IEEE International Conference on Robotics and Automation (ICRA 2016)

Prerequisites for using the POMDP solvers

This package requires a binary from Anthony Cassandra's POMDP solver. Please visit for any matter related to the POMDP solver. In order to be using the simplex finite grid method, a fork of the version from cmansley needs to be installed that contains a fix to the original code. You can get the fork here.

The python code is looking for the pomdp-solve executable in your $PATH. Here are some instructions on how to compile and install the solver properly (assuming that ~/src is the directory in which you usually place your code):

cd ~/src
git clone
cd pomdp-solve
mkdir build
cd build/
../configure --prefix=$HOME/.local
make install

Make sure that ~/.local/bin is in yout path and now you should have pomdp-solve installed in it, and it should be available for the python package to be used.

ICRA 2017

To generate the policy from the experiment in [Roncone2017], please use the script samples/ The script will generate the corresponding POMDP model, solve it with Anthony Cassandra's POMDP solver, and store the corresponding policy under visualization/policy/json/icra.json. To run the full experiment on the baxter robot, please refer to

You can’t perform that action at this time.