WWW-POSIM v0.6.16Documentazione del simulatore
Menu della documentazione
WWW-POSIM / Documentazione del simulatore

Controlla un’area di lavoro web

Esegui Python sul tuo computer per inviare comandi alla tua simulazione personale sul sito.

Preparare Python e VS Code

  1. Apri WWW-POSIM, accedi e crea un mondo WAM-V con il controllo diretto ROS 2. Attendi che il mondo sia in esecuzione.
  2. Installa VS Code e l’estensione Python di Microsoft.
  3. Segui il blocco relativo al tuo sistema. La cartella .venv contiene i pacchetti Python del progetto.

Windows: PowerShell

Installa il gestore di installazione di Python. Apri una nuova finestra PowerShell dal menu Start ed esegui:

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: Terminale

Installa Python 3.14 con il programma di installazione di Python.org. Apri Applicazioni → Utility → Terminale ed esegui:

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: terminale

Premi Ctrl+Alt+T ed esegui:

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 può chiedere la password del computer. Durante la digitazione non compaiono caratteri; al termine premi Invio.

Eseguire il programma in VS Code

  1. In VS Code, apri posim-controller nella tua cartella personale con File → Apri cartella.
  2. Installa l’estensione Python di Microsoft, se manca.
  3. Apri la tavolozza dei comandi con Ctrl+Maiusc+P su Windows/Linux o Cmd+Maiusc+P su Mac. Cerca Python: Select Interpreter e scegli l’interprete di .venv.
  4. Crea controller.py, incolla il codice seguente, sostituisci YOU@example.com con l’indirizzo del tuo account e salva.
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. Apri un terminale integrato ed esegui il comando per il tuo sistema.

Windows:

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

Mac/Ubuntu:

.venv/bin/python controller.py
  1. Alla richiesta Password:, inserisci la password di WWW-POSIM e premi Invio. La digitazione resta invisibile. Osserva WAM-V muoversi sul sito.

Il programma viene eseguito sul tuo computer e controlla la tua area di lavoro sul server. Importare il pacchetto non effettua l’accesso né apre la connessione: la connessione inizia quando si entra nel blocco with.

Risolvere i problemi

Per usare i topic ROS da un altro ambiente, consulta Terminali ROS e connessione.

Cerca nella documentazione