WWW-POSIM v0.6.16Simulator-Dokumentation
Dokumentationsmenü
WWW-POSIM / Simulator-Dokumentation

Einen Web-Arbeitsbereich steuern

Führen Sie Python auf Ihrem Computer aus, um Ihre persönliche Simulation auf der Website zu steuern.

Python und VS Code vorbereiten

  1. Öffnen Sie WWW-POSIM, melden Sie sich an und erstellen Sie eine WAM-V-Welt mit direkter ROS-2-Steuerung. Warten Sie, bis die Welt läuft.
  2. Installieren Sie VS Code und die Microsoft-Erweiterung Python.
  3. Führen Sie den passenden Block für Ihr Betriebssystem aus. Im Ordner .venv liegen die Python-Pakete dieses Projekts.

Windows: PowerShell

Installieren Sie den Python-Installationsmanager. Öffnen Sie über das Startmenü ein neues PowerShell-Fenster und führen Sie Folgendes aus:

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

Installieren Sie Python 3.14 mit dem Installationsprogramm von Python.org. Öffnen Sie Programme → Dienstprogramme → Terminal und führen Sie Folgendes aus:

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

Öffnen Sie mit Strg+Alt+T ein Terminal und führen Sie Folgendes aus:

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 fragt möglicherweise nach dem Passwort Ihres Computers. Bei der Eingabe erscheinen keine Zeichen; drücken Sie danach die Eingabetaste.

Das Programm in VS Code ausführen

  1. Öffnen Sie in VS Code über Datei → Ordner öffnen den Ordner posim-controller in Ihrem Benutzerverzeichnis.
  2. Installieren Sie bei Bedarf die Microsoft-Erweiterung Python.
  3. Öffnen Sie die Befehlspalette mit Strg+Umschalt+P unter Windows/Linux oder Cmd+Umschalt+P auf dem Mac. Suchen Sie nach Python: Select Interpreter und wählen Sie den Interpreter aus .venv.
  4. Erstellen Sie controller.py, fügen Sie den folgenden Code ein und ersetzen Sie YOU@example.com durch die E-Mail-Adresse Ihres Kontos. Speichern Sie die Datei.
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. Öffnen Sie ein integriertes Terminal und führen Sie den Befehl für Ihr System aus.

Windows:

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

Mac/Ubuntu:

.venv/bin/python controller.py
  1. Geben Sie bei Password: Ihr WWW-POSIM-Passwort ein und drücken Sie die Eingabetaste. Die Eingabe bleibt unsichtbar. Beobachten Sie die Bewegung von WAM-V auf der Website.

Das Programm läuft auf Ihrem Computer und steuert Ihren eigenen Arbeitsbereich auf dem Server. Der Import des Pakets meldet Sie noch nicht an und öffnet keine Verbindung. Erst beim Eintritt in den with-Block wird die Verbindung hergestellt.

Probleme beheben

Für ROS-Topics aus einer anderen Umgebung siehe ROS-Terminals und Verbindung.

Dokumentation durchsuchen