POSIM v1.0.1Platform for Ocean Simulation · Documentazione
Menu della documentazione
POSIM / Per iniziare

Ubuntu: installazione nativa

Compila POSIM su Ubuntu 26.04. Apri l’applicazione Terminale ed esegui un blocco alla volta, aspettando che ogni passaggio termini. Per usare un’immagine pronta, segui Linux con Docker.

1. Scaricare i sorgenti

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

Mantieni il nome della directory posim: viene usato dal manifesto dei repository.

2. Installare lo stack software

Leggi prima src/posim/extras/ros-lyrical-gz-jetty-install.sh. Lo script configura repository, usa sudo ed esegue apt-get full-upgrade -y. È consigliato un ambiente Ubuntu dedicato.

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"

Installa ROS 2 Lyrical, Gazebo Jetty, ArduSub, ArduRover, MAVROS e le librerie delle onde. Wave Sim viene scaricato a una revisione fissata e compilato come dipendenza esterna; non serve clonare POSIM in modo ricorsivo.

3. Risolvere le dipendenze 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 il repository POSIM già clonato. Controlla ogni errore di dipendenza prima della compilazione.

Il manifesto importa anche una revisione fissata di ros_gz con correzioni al ciclo di vita del bridge e all’avvio POSIX. Se src/ros_gz esiste già, rimane invariato: confronta origine e revisione con il manifesto oppure usa un workspace nuovo.

4. Compilare e caricare l’ambiente

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

Entrambi i percorsi ros_gz devono appartenere alla directory install/ del workspace. Se compare /opt/ros/lyrical, viene ancora selezionato il pacchetto di sistema. Carica ROS e il workspace in ogni nuovo terminale, come spiegato in Preparare i terminali.

Se la memoria non basta

--executor sequential esegue un pacchetto alla volta, ma non limita i processi del compilatore. Per limitare entrambi:

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

Aggiornare il workspace

Salva prima le tue modifiche in un commit Git. Annota la revisione, scarica gli aggiornamenti, poi ripeti la risoluzione delle dipendenze e la compilazione:

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

Prosegui con la prima simulazione. Per il sonar, consulta compilazione e configurazione CPU/WGPU/CUDA.

5. Avviare il mondo dimostrativo

L’ultima verifica apre Gazebo con la scena oceanica. Al primo avvio può essere necessario scaricare modelli Fuel. Ferma la simulazione con Ctrl+C prima di passare alla preparazione dei terminali.

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