POSIM v1.0.1Platform for Ocean Simulation · 文档
文档菜单
POSIM / 开始使用

Ubuntu:原生安装

在Ubuntu 26.04中编译POSIM。打开Ubuntu的终端应用,按顺序执行各个代码块,等待当前步骤完成后再继续。如果希望使用预先构建的镜像,请阅读Linux与Docker。

1. 获取源代码

mkdir -p ~/posim_ws/src
git clone https://github.com/IOES-Lab/POSIM.git ~/posim_ws/src/posim
cd ~/posim_ws

请保留目录名posim,后续导入仓库清单时会使用这个名称。

2. 安装软件栈

先阅读src/posim/extras/ros-lyrical-gz-jetty-install.sh。脚本会配置软件仓库、使用sudo并执行apt-get full-upgrade -y,因此推荐使用专用的Ubuntu环境。

POSIM_EXTRAS_DIR="$PWD/src/posim/extras" \
  bash src/posim/extras/ros-lyrical-gz-jetty-install.sh
source /opt/ros/lyrical/setup.bash
source "$HOME/.ros_ardusub_env/env"

脚本安装ROS 2 Lyrical、Gazebo Jetty、ArduSub、ArduRover、MAVROS和波浪库。Wave Sim作为外部依赖,按固定版本获取并编译,不需要递归克隆POSIM。

3. 准备工作空间依赖

vcs import src --skip-existing \
  --input src/posim/extras/repos/posim.lyrical.repos
rosdep update --rosdistro lyrical
rosdep install --rosdistro lyrical --from-paths src --ignore-src -r -y

--skip-existing会保留已有的POSIM源代码。编译前请处理所有依赖错误。

清单还会导入固定版本的ros_gz,其中包含桥接生命周期和POSIX启动修复。已有的src/ros_gz不会被替换:请比较其来源和提交版本是否符合清单,或使用新的工作空间。

4. 编译并加载环境

colcon build --merge-install --executor sequential --symlink-install
source install/setup.bash
ros2 pkg prefix posim_demos
ros2 pkg prefix ros_gz_bridge
ros2 pkg prefix ros_gz_sim

两个ros_gz路径都应指向当前工作空间的install/目录。如果显示/opt/ros/lyrical,说明仍在使用系统包。每次打开新终端,都要按照准备终端加载ROS和工作空间。

编译时内存不足

--executor sequential只让软件包依次编译,不限制单个包内部的编译进程数。可以同时限制两者:

MAKEFLAGS="-j1" CMAKE_BUILD_PARALLEL_LEVEL=1 colcon build --merge-install --executor sequential --symlink-install

更新工作空间

先将自己的修改提交到Git。记录当前版本,获取更新,然后重新安装依赖并编译:

git -C ~/posim_ws/src/posim rev-parse HEAD
git -C ~/posim_ws/src/posim pull --ff-only

接下来运行首次仿真。声呐请参阅 CPU/WGPU/CUDA 编译与配置。

5. 运行演示场景

最后检查Gazebo能否打开海洋场景。首次运行可能需要下载Fuel模型。使用Ctrl+C结束仿真,再继续准备终端。

source /opt/ros/lyrical/setup.bash
source "$HOME/.ros_ardusub_env/env"
source ~/posim_ws/install/setup.bash
ros2 launch posim_demos posim_world.launch.py \
  world_name:=posim_ocean_waves headless:=false