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