Humanoid Path Planner - Affordance module

Author: Anna Seppala

Description

HPP - AFFORDANCE is a library that builds representations of a robot's environment in terms of affordances, which describe surrounding objects based on their application possibilities. For instance, large vertical surfaces may be applied for leaning, whereas smaller horizontal surface areas (e.g. stairs) allow for a robot to step on them. This idea was presented in multiple papers by Kaiser et al. [(link)] (http://h2t.anthropomatik.kit.edu/english/21_459.php):

"Extracting Whole-Body Affordances from Multimodal Exploration" (IEEE/RAS 2014)

"Extraction of Whole-Body Affordances for Loco-Manipulation Tasks" (IJHR 2015)

"Validation of Whole-Body Loco-Manipulation Affordances for Pushability and Liftability" (IEEE/RAS 2015)

The HPP - AFFORDANCE module is loosely based on the methods of affordance extraction presented above but analyses triangulated mesh files based on triangle normals.

This library is part of the software Humanoid Path Planner (link).

Installation

from robotpkg apt binaries

Follow "Binary packages in robotpkg/wip" instructions: http://robotpkg.openrobots.org/robotpkg-wip.html 2 apt install robotpkg-hpp-affordance

from sources

To install HPP - AFFORDANCE, you will need to install one other package of the Humanoid Path Planner software with its respective dependecies. Please see the instructions below for the full installation of HPP - AFFORDANCE:

Install HPP - FCL - see https://github.com/humanoid-path-planner/hpp-fcl
Install Eigen 3 - see http://eigen.tuxfamily.org/

Clone the HPP - AFFORDANCE repository onto your local computer and update the submodule:

   git clone --recursive https://github.com/humanoid-path-planner/hpp-affordance.git
   cd hpp-affordance

Use CMake to install the HPP - AFFORDANCE library. For instance:
```
   mkdir build
   cd build
   cmake ..
   make install
```

Documentation