WWW-POSIM v0.6.16Documentation du simulateur
Menu de la documentation
WWW-POSIM / Documentation du simulateur

Commander un espace de travail web

Exécutez Python sur votre ordinateur pour envoyer des commandes à votre simulation personnelle sur le site.

Préparer Python et VS Code

  1. Ouvrez WWW-POSIM, connectez-vous et créez un monde WAM-V avec la commande directe ROS 2. Attendez que le monde fonctionne.
  2. Installez VS Code et l’extension Python de Microsoft.
  3. Suivez le bloc correspondant à votre système. Le dossier .venv contient les paquets Python du projet.

Windows : PowerShell

Installez le gestionnaire d’installation de Python. Ouvrez une nouvelle fenêtre PowerShell depuis le menu Démarrer et exécutez :

py install 3.14
mkdir "$HOME\posim-controller"
cd "$HOME\posim-controller"
py -3.14 -m venv .venv
.\.venv\Scripts\python.exe -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl

Mac : Terminal

Installez Python 3.14 avec le programme fourni par Python.org. Ouvrez Applications → Utilitaires → Terminal, puis exécutez :

mkdir -p ~/posim-controller
cd ~/posim-controller
python3.14 -m venv .venv
.venv/bin/python -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl

Ubuntu : terminal

Ouvrez un terminal avec Ctrl+Alt+T, puis exécutez :

sudo apt update
sudo apt install -y python3-venv python3-pip
mkdir -p ~/posim-controller
cd ~/posim-controller
python3 -m venv .venv
.venv/bin/python -m pip install https://github.com/IOES-Lab/homebrew-www-posim/releases/download/v0.6.16/www_posim_ros-0.4.3-py3-none-any.whl

sudo peut demander le mot de passe de votre ordinateur. Aucun caractère ne s’affiche pendant la saisie ; appuyez sur Entrée une fois terminé.

Exécuter le programme dans VS Code

  1. Dans VS Code, ouvrez le dossier posim-controller de votre dossier personnel avec Fichier → Ouvrir le dossier.
  2. Installez l’extension Python de Microsoft si nécessaire.
  3. Ouvrez la palette de commandes avec Ctrl+Maj+P sur Windows/Linux ou Cmd+Maj+P sur Mac. Recherchez Python: Select Interpreter et sélectionnez l’interpréteur de .venv.
  4. Créez controller.py, collez le code suivant, remplacez YOU@example.com par l’adresse de votre compte et enregistrez.
from www_posim_ros import Session

with Session.remote(email="YOU@example.com", control=True) as sim:
    topic = next(name for name, kind in sim.topics.items()
                 if kind == "nav_msgs/msg/Odometry")
    print(sim.latest(topic)["pose"]["pose"]["position"])
    sim.set_velocity(forward=0.3, yaw_rate=0.0, duration=2.0)
  1. Ouvrez un terminal intégré et lancez la commande adaptée à votre système.

Windows :

.\.venv\Scripts\python.exe controller.py

Mac/Ubuntu :

.venv/bin/python controller.py
  1. À l’invite Password:, saisissez votre mot de passe WWW-POSIM et appuyez sur Entrée. La saisie reste invisible. Observez le déplacement de WAM-V sur le site.

Le programme s’exécute sur votre ordinateur et commande votre propre espace de travail sur le serveur. Importer le paquet ne connecte pas votre compte ; la connexion s’ouvre à l’entrée dans le bloc with.

Résoudre les problèmes

Pour utiliser les topics ROS depuis un autre environnement, consultez Terminaux ROS et connexion.

Rechercher dans la documentation