Skip to content

Overworld is a lightweight and open-source framework for geometrical situation assessment for HRI. It permanently maintains a geometric state of the world from the point of view of the robot by aggregating perceptual information from several sources and reasoning on them to create a coherent world.

License

Notifications You must be signed in to change notification settings

sarthou/overworld

Repository files navigation

Release

Dependency Status

Build Status

Installation

Overworld

First of all, if you don't yet have the required dependencies, install them.

sudo apt install -y libglm-dev libglfw3-dev

To install Overworld, you just have to clone it and Ontologenius in the src folder of your ROS workspace and compile it. Enjoy !

cd src
git clone https://github.com/sarthou/ontologenius.git
git clone https://github.com/RIS-WITH/common_ground_ontology.git
git clone https://github.com/sarthou/overworld.git
cd ..
catkin_make # or catkin build

Usage

Overworld has only one executable being overworld_node which takes only one required argument: a configuration. A lot of optional arguments are available, take a look to (Overworld's Website)[https://sarthou.github.io/overworld/overview/launchers.html].

The configuration file is used to define the used perception modules and to configure them.

Because Overworld is strongly linked to the semantic knowledge base Ontologenius, you have to launch both:

Terminal 1:

roslaunch overworld tuto_ontologenius.launch

Terminal 2:

roslaunch overworld tuto_overworld.launch

Ontologenius

The knowledge base Ontologenius can be used as a source of information for Overworld to spawn the objects. It can provide the visual mesh, the collision mesh, or the color of an object. In addition, it is used to store the symbolic facts generated by Overworld.

More information about this link and tutorials to show its use will come soon.

About

Overworld is a lightweight and open-source framework for geometrical situation assessment for HRI. It permanently maintains a geometric state of the world from the point of view of the robot by aggregating perceptual information from several sources and reasoning on them to create a coherent world.

Topics

Resources

License

Stars

Watchers

Forks