FlexBE Behavior Engine

FlexBE is a high-level behavior engine coordinating the capabilities of a robot in order to solve complex tasks. Behaviors are modeled as hierarchical state machines (HFSM) where states correspond to active actions and transitions describe the reaction to outcomes. Main advantage over similar approaches is the good operator integration and an intuitive user interface. Besides executing behaviors in full autonomy, the operator can restrict execution of certain transitions or trigger them manually. Furthermore, FlexBE supports modifying the whole structure of a behavior during its execution without restarting it. The user interface features a runtime control interface as well as a graphical editor for state machines.

Please refer to the FlexBE Homepage (flexbe.github.io) for further information, tutorials, application examples, and much more.

You may also want to check out the quick start tutorial demonstrations at FlexBE Turtlesim Demo.

Iron

Jazzy

Rolling

Installation

For released versions, FlexBE is available as ` apt install package ros--flexbe-*`

To build from source, execute the following commands to install FlexBE for ROS 2 systems:

cd "ros2_ws"/src
git clone https://github.com/FlexBE/flexbe_behavior_engine.git

Next, navigate to the “ros2_ws” top-level directory and build FlexBE:

colcon build

Furthermore, create your own repository for behavior development (contains examples):

ros2 run flexbe_widget create_repo [your_project_name]

This version of the flexbe_behavior_engine requires version 4.0+ of the FlexBE user interface.

It is recommended to install the FlexBE user interface by following one of these steps:

• https://github.com/FlexBE/flexbe_app.git - classic FlexBE App (iron or ros2-devel branches)
• https://github.com/FlexBE/flexbe_webui.git - new Python-based webserver version

Usage

Use the following launch file for running the onboard engine:

ros2 launch flexbe_onboard behavior_onboard.launch.py

Use the following launch file for running the operator control station (requires the FlexBE App or WebUI):

ros2 launch flexbe_webui flexbe_ocs.launch.py

Note: replace flexbe_webui with flexbe_app to run the “classic” UI (after ros2 run flexbe_app nwjs_install).

Use the following launch file to run both of the above, e.g., for testing on a single computer:

ros2 launch flexbe_webui flexbe_full.launch.py

For running tests use: colcon test --ctest-args --packages-select <flexbe_package>

Next Steps

• Do some of the tutorials.

• Visit the FlexBE GitHub Organization for additional available states.

• If you are converted an existing system from ROS 1 to ROS 2, we provide a ROS 2 Conversion Best Practices Guide to assist in converting any custom FlexBE state implementations.

Publications

Please use the following publications for reference when using FlexBE:

• Philipp Schillinger, Stefan Kohlbrecher, and Oskar von Stryk, “Human-Robot Collaborative High-Level Control with Application to Rescue Robotics”, IEEE International Conference on Robotics and Automation (ICRA), Stockholm, Sweden, May 2016.

• Joshua Zutell, David C. Conner and Philipp Schillinger, “ROS 2-Based Flexible Behavior Engine for Flexible Navigation ,”, IEEE SouthEastCon, April 2022.

Further Publications

Refer to the following publications to get an impression about ways to use FlexBE. Let us know if you know a paper which should be added to the list.

• Stefan Kohlbrecher et al. “A Comprehensive Software Framework for Complex Locomotion and Manipulation Tasks Applicable to Different Types of Humanoid Robots.” Frontiers in Robotics and AI 3 (2016): 31.

• Spyros Maniatopoulos, Philipp Schillinger, Vitchyr Pong, David C. Conner, and Hadas Kress-Gazit, “Reactive High-level Behavior Synthesis for an Atlas Humanoid Robot”, IEEE International Conference on Robotics and Automation (ICRA), Stockholm, Sweden, May 2016.

• Alberto Romay et al., “Collaborative autonomy between high-level behaviors and human operators for remote manipulation tasks using different humanoid robots,” Journal of Field Robotics, September 2016.

• David C. Conner and Justin Willis, “Flexible Navigation: Finite state machine-based integrated navigation and control for ROS enabled robots,” SoutheastCon 2017.

Maintainers

• Philipp Schillinger (@pschillinger, Contact)
• David Conner (@dcconner)

Any contribution that you make to this repository will be under the 3-Clause BSD License, as dictated by that license.