POSIM v1.0.1Platform for Ocean Simulation · Documentation
Menu de la documentation
POSIM / Bien démarrer

Ubuntu : installation native

Compilez POSIM sous Ubuntu 26.04. Ouvrez l’application Terminal et exécutez les blocs un par un, en attendant la fin de chaque étape. Pour utiliser une image prête à l’emploi, suivez Linux avec Docker.

1. Récupérer les sources

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

Conservez le nom du répertoire posim : le manifeste des dépôts l’utilise dans les étapes suivantes.

2. Installer la pile logicielle

Lisez d’abord src/posim/extras/ros-lyrical-gz-jetty-install.sh. Ce script configure des dépôts, utilise sudo et lance apt-get full-upgrade -y. Un environnement Ubuntu dédié est recommandé.

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"

Il installe ROS 2 Lyrical, Gazebo Jetty, ArduSub, ArduRover, MAVROS et les bibliothèques de vagues. Wave Sim est récupéré à une révision fixée puis compilé comme dépendance externe ; un clonage récursif de POSIM n’est pas nécessaire.

3. Préparer les dépendances de l’espace de travail

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 conserve le dépôt POSIM déjà présent. Vérifiez chaque erreur de dépendance avant de compiler.

Le manifeste importe également une révision fixée de ros_gz avec les corrections du cycle de vie du pont et du lancement POSIX. Un répertoire src/ros_gz existant reste inchangé : comparez son origine et sa révision au manifeste, ou utilisez un nouvel espace de travail.

4. Compiler et charger l’environnement

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

Les deux chemins ros_gz doivent appartenir au répertoire install/ de cet espace de travail. Un chemin sous /opt/ros/lyrical indique que le paquet système reste sélectionné. Dans chaque nouveau terminal, chargez ROS et l’espace de travail comme indiqué dans Préparer les terminaux.

Si la compilation manque de mémoire

--executor sequential sérialise les paquets, mais pas les processus du compilateur. Pour limiter les deux :

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

Mettre à jour l’espace de travail

Enregistrez vos modifications dans Git avant la mise à jour. Notez la révision, récupérez les changements, puis reprenez la résolution des dépendances et la compilation :

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

Passez à la première simulation. Pour le sonar, consultez la compilation et la configuration CPU/WGPU/CUDA.

5. Lancer le monde de démonstration

Cette dernière vérification ouvre la scène océanique dans Gazebo. Le premier lancement peut télécharger des modèles Fuel. Arrêtez avec Ctrl+C avant de poursuivre avec les terminaux.

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