NOTE: this software is part of the BenchBot software stack, and not intended to be run in isolation. For a working BenchBot system, please install the BenchBot software stack by following the instructions here.

BenchBot Supervisor

The BenchBot Supervisor is a HTTP server facilitating communication between user-facing interfaces like the BenchBot API, and the low-level robot components like BenchBot Simulator or real robots. Communication is typically routed through a BenchBot Robot Controller, which provides automated process management for low-level components and wraps all ROS communications.

Installing and running the BenchBot Supervisor

BenchBot Supervisor is a Python package containing a Supervisor class that wraps a HTTP server for both upstream and downstream communication. Install by running the following in the root directory of where this repository was cloned:

u@pc:~$ pip install .

Once installed, the Python class can be used as follows:

from benchbot_supervisor import Supervisor

s = Supervisor(...args...)
s.run()

The following parameters are typically required for a useful instantiation of the supervisor:

• addons_path: path to installed BenchBot add-ons (is the same as the directory where manager.py can be found)
• task_name: string matching the 'name' field of an installed task
• robot_name: string matching the 'name' field of an installed robot
• environment_names: list of strings, each matching the 'name':'variant' field combination of an installed environment (the 'name' must be the same for all environments in the list)
• port: select a different port than the default (10000)

The module can also be executed directly, which makes the passing of arguments from the command line simple (see python -m benchbot_supervisor --help for argument details):

u@pc:~$ python -m benchbot_supervisor ...args...

As an example, the below command runs the supervisor for a scene change detection task, where active control is employed with ground truth localisation on a simulated Carter robot, and environments miniroom:1 and miniroom:5 are used:

u@pc:~$ python -m benchbot_supervisor \
    --task-name scd:active:ground_truth \
    --robot-name carter \
    --environment-names miniroom:1,miniroom:5

Employing task, robot, and environment configurations

The BenchBot Supervisor requires configuration details for the selected tasks, robots, and environments. It uses these details to manage each of the system components, like API interaction and control of the simulator / real robot. Configuration details are provided by YAML files, which are referenced via their 'name' field as shown above.

The BenchBot Add-ons Manager manages the installation of, and access to, these files. See the documentation there for further details on configuration files. All you need to do to use add-ons with the supervisor is provide the location via the 'addons_path' argument.

Interacting with the BenchBot Supervisor

The supervisor includes a RESTful HTTP API for all interaction with a user-facing API. The RESTful API includes the following commands:

Hello, I am the BenchBot supervisor

{
 ...
 'param_name': param_value,
 ...
}

Hello, I am the BenchBot robot controller