Skip to content

DCUSnSLab/flexbe_behavior_engine

 
 

Repository files navigation

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.

FlexBE CI

Iron ROS Build Farm

Jazzy ROS Build Farm

Rolling ROS Build Farm

Installation

For released versions, FlexBE is available as apt install package ros-<DISTRO>-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:

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

Publications

Please use the following publications for reference when using FlexBE:

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.

Maintainers

About

Contains the behavior engine FlexBE.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 96.9%
  • Shell 2.7%
  • CMake 0.4%