POSIM v1.0.1Platform for Ocean Simulation · Documentación
Menú de documentación
POSIM / Primeros pasos

Ubuntu: instalación nativa

Compila POSIM en Ubuntu 26.04. Abre la aplicación Terminal y ejecuta los bloques de uno en uno, esperando a que termine cada paso. Para usar una imagen preparada, sigue Linux con Docker.

1. Descargar el código

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

Mantén el nombre posim para que coincida con el manifiesto de repositorios.

2. Instalar ROS, Gazebo y las dependencias

Lee primero src/posim/extras/ros-lyrical-gz-jetty-install.sh. El script configura repositorios, usa sudo y ejecuta apt-get full-upgrade -y. Se recomienda un entorno Ubuntu dedicado.

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"

Instala ROS 2 Lyrical, Gazebo Jetty, ArduSub, ArduRover, MAVROS y las bibliotecas de olas. Wave Sim se descarga en una revisión fijada y se compila como dependencia externa; no hace falta clonar POSIM de forma recursiva.

3. Preparar los paquetes del workspace

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 conserva el código POSIM que acabas de clonar. Revisa cualquier error de dependencias antes de compilar.

El manifiesto también importa una revisión fijada de ros_gz con correcciones del ciclo de vida del puente y del lanzamiento POSIX. Si ya existe src/ros_gz, no se actualiza automáticamente: compara su origen y revisión con el manifiesto o utiliza un espacio de trabajo nuevo.

4. Compilar y cargar el entorno

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

Ambas rutas de ros_gz deben apuntar a la carpeta install/ de este espacio de trabajo. Si aparece /opt/ros/lyrical, todavía se está usando el paquete del sistema. En cada terminal nueva, carga ROS y el workspace como explica Preparar las terminales.

Si falta memoria durante la compilación

--executor sequential limita los paquetes simultáneos, pero no los procesos del compilador. Para limitar ambos:

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

Actualizar el espacio de trabajo

Guarda tus cambios en Git antes de actualizar. Anota la revisión, descarga los cambios y repite la resolución de dependencias y la compilación:

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

Continúa con la primera simulación. Para el sonar, consulta la compilación y configuración de CPU/WGPU/CUDA.

5. Ejecutar el mundo de demostración

La última comprobación abre Gazebo con la escena oceánica. La primera ejecución puede descargar modelos Fuel. Detén la simulación con Ctrl+C antes de continuar con las terminales.

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