BT Studio is an open-source tool crafted for the development of robotic applications. Its primary objective is to facilitate the quick deployment of behavior tree-based robotic applications within ROS 2. In BT Studio, a robotic app is defined as an graphical tree coupled with actions scripted in Python, which the tool then translates into a ROS 2 package. This process circumvents the unnecessary complexities often associated with ROS-specific configurations, offering developers a more streamlined approach.
- Clone the repo and enter it
git clone https://github.com/JdeRobot/bt-studio
cd bt-studio- Install the necessary packages
sudo apt update
sudo apt install npm python3-vcstool python3-pip python3-rosdep python3-colcon-common-extensions python3-autopep8 -y- Install the backend dependencies
cd backend
pip install virtualenv
virtualenv backend_env
source backend_env/bin/activate
pip install django djangorestframework- Launch the backend
python3 manage.py runserverDo not close the terminal where this is executing!. Django provides the necessary backend funcionalities. For continuing the process, simply open a new terminal.
- Install the appropiate nodejs version
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
nvm install 16
nvm use 16- Install Yarn
sudo npm install --global yarn- Setup the frontend
From the bt_studio folder:
cd frontend
yarn install
yarn startA new window in the browser should have opened. If not, go to BT Studio
- Create new app
You may create a new app clicking the + button in the upper right corner, or swap to the the demo project clicking the change button next to it and typing demo. In the demo project, you may find a reference implementation of a bump and go app for a differential robot using a LIDAR. Feel free to explore and use whatever you need!
- Write actions
You may create as many actions as needed using the file browser. The actions must have a .py extension and follow this structure:
import py_trees
class TemplateAction(py_trees.behaviour.Behaviour):
def __init__(self, name, ports = None):
""" Constructor, executed when the class is instantiated """
# Configure the name of the behaviour
super().__init__(name)
self.logger.debug("%s.__init__()" % (self.__class__.__name__))
# Get the ports
self.ports = ports
...
def setup(self, **kwargs: int) -> None:
""" Executed when the setup function is called upon the tree """
# Get the node passed from the tree (needed for interaction with ROS)
try:
self.node = kwargs['node']
except KeyError as e:
error_message = "Couldn't find the tree node"
raise KeyError(error_message) from e
...
def initialise(self) -> None:
""" Executed when coming from an idle state """
...
def update(self) -> py_trees.common.Status:
""" Executed when the action is ticked. Do not block! """
....
return new_status
def terminate(self, new_status: py_trees.common.Status) -> None:
""" Called whenever the behavior switches to a non-running state """
...For examples of how to use ports in your actions, please refer to the example actions provided with the repo in the actions folder. The structure is the same as py_trees actions, as this project uses the library underneath. Kudos to @stonier!
- Define the tree structure
Using the existing blocks, you may define the logic of your app. Here you have available all the defined actions. This can be done previously to step 2 if you prefer to define the logic of the tree before its implementation!
- Downloading the app
Clicking the green download button, a ROS 2 app is generated. This can be unziped in a ROS 2 workspace and installed as any other package.
- You need to ROS 2 humble installed in your system. Please follow this guide if you haven't. After that, source the ros underlay. It is highly recommended to add this line at the end of your
.basrhcfile.
source /opt/ros/humble/setup.bash- Moving the app to a ROS 2 ws
mkdir -p your_ws/src
mv your_app.zip your_ws/src
unzip your_ws/src/your_app.zip- Init rosdep
You may have to init the ROS dependency manager if you haven't done it before.
sudo rosdep init
rosdep update- Downloading auxiliary tools and dependencies
These are a testing environment in the Webots simulator and a tree execution visualizer.
cd src/your_app/
vcs import < demo/thirdparty.repos
cd ../..
rosdep install --from-paths src -r -y --ignore-src- Compiling
colcon build --symlink-install
source install/setup.bash- Launching a testing environment
You may choose whatever environment for your app to execute into, but we provide some prepared packages for convenience.
ros2 launch tb4_sim tb4_launcher.py
py-trees-tree-viewer- Launching the app
Now, using the app executor, you may launch the app itself.
ros2 run your_app_name executorYou can see a running application as reference here:
In the future, this project will have total integration with RoboticsAcademy, so developers will be able to deploy the trees in a dockerized environment.