StoneFish ROS 2 Marine Robotics Simulator

Overview

The repository provides a Docker container with a bash scripts that can seamlessly build and run the container.

Docker container offers ROS 2 environment whare you can launch vehicles in StoneFish.

The repository provides all necessary commands and references that can boost your software's research and development process, which utilizes the ROS 2 stack.

SITL allows you to simulate the vehicle hardware and firmware ArduSub on your host directly.

There are several scripts in: /extras_rov, /extras_boat to communicate with vehicle using Pymavlink.

Prerequisites

• Install NVIDIA Container Toolkit to support Docker to access GPU (required).
• Repository has been tested on: Ubuntu 22.04, Ubuntu 24.04, ArchLinux (Kernel 6.8).

Notes

Adjust paths in run.sh.

local_workspace="/home/markus/underwater/ros2_marine_robotics_sim_env/src"
local_stonefish="/home/markus//underwater/ros2_marine_robotics_sim_env/stonefish"
local_sf_ws="/home/markus//underwater/ros2_marine_robotics_sim_env/sf_ws"
local_gz_ws="/home/markus//underwater/ros2_marine_robotics_sim_env/gz_ws"
local_SITL_Models="/home/markus//underwater/ros2_marine_robotics_sim_env/SITL_Models"

Build Docker

git clone https://github.com/markusbuchholz/stonefish_ros2_marine_robotics.git

cd /stonefish_ros2_marine_robotics/docker

sudo ./build.sh

Run Docker

sudo ./run.sh

cd ../stonefish

# IMPORTANT. You build only once since the stonefish volume is on your HOST.
mkdir -p build && cd build

cmake ..

make -j$(nproc)

# IMPORTANT. You have to run these two commands every time you run Docker container.
# 1.
sudo make install
# 2.
export LD_LIBRARY_PATH=/home/stonefish/build/libStonefish.so:$LD_LIBRARY_PATH

cd ../../sf_ws/

colcon build --packages-select stonefish_ros2
source install/setup.bash

colcon build --packages-select cola2_msgs
source install/setup.bash

colcon build
source install/setup.bash

Start StoneFish with BlueROV2

ros2 launch cola2_stonefish bluerov_fls_simulation.launch.py

Start StoneFish with BlueBoat

ros2 launch cola2_stonefish blueboat_launch.py

Start StoneFish with BlueROV2 with ArduPilot

#terminal 1
ros2 run stonefish_bluerov2 ardusim_patch.py

#terminal 2
ros2 launch cola2_stonefish bluerov_fls_simulation.launch.py

#terminal 3
sim_vehicle.py -v ArduSub -f vectored_6dof --model JSON --map  -l 55.99541530863445,-3.3010225004910683,0,0 -m --streamrate=-1

#terminal 4
cd /home/sf_ws/src/extras_rov
# run example script
# check for other scripts
python3 python3 pos_req.py

Links

• StoneFish github
• ArduSub
• Pymavlink
• Stonefish_bluerov2
• StoneFish paper