웹 작업공간에서 제어
내 컴퓨터에서 Python을 실행해 웹사이트의 개인 시뮬레이션을 제어합니다.
웹사이트: Python과 VS Code 준비하기
서버에서 시뮬레이션을 실행하려면 이 순서를 사용하세요.
- WWW-POSIM에 로그인하고 ROS 2 직접 제어 방식의 WAM-V 개인 월드를 만드세요. 월드 실행이 끝날 때까지 기다리세요.
- VS Code와 Microsoft의 Python 확장을 설치하세요.
- 아래에서 내 컴퓨터에 맞는 블록 하나만 따라 하세요. 터미널에 블록을 복사해 붙여 넣고 Enter를 누르세요.
.venv폴더는 이 프로젝트의 Python 패키지를 보관합니다.
Windows — PowerShell
Python 설치 관리자를 설치하세요. 시작 메뉴에서 새 PowerShell 창을 연 뒤 붙여 넣으세요.
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 — 터미널
Python.org의 macOS 설치 프로그램으로 Python 3.14를 설치하세요. 응용 프로그램 → 유틸리티 → 터미널을 열고 붙여 넣으세요.
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 — 터미널
Ctrl+Alt+T를 눌러 터미널을 열고 붙여 넣으세요.
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가 컴퓨터 비밀번호를 물을 수 있습니다. 입력하는 동안 글자가 보이지 않는 것이 정상입니다. 비밀번호를 입력한 뒤 Enter를 누르세요.
웹사이트: VS Code에서 프로그램 실행하기
- VS Code에서 파일 → 폴더 열기를 선택하고 홈 폴더의
posim-controller를 여세요. - 아직 설치하지 않았다면 Microsoft의 Python 확장을 설치하세요.
- Windows/Linux에서는 Ctrl+Shift+P, Mac에서는 Cmd+Shift+P로 명령 팔레트를 여세요. Python: Select Interpreter에서 프로젝트의
.venv를 선택하세요. controller.py파일을 만들고 아래 코드를 붙여 넣으세요.YOU@example.com을 계정 이메일로 바꾸고 저장하세요.
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)
- 터미널 → 새 터미널을 선택하세요. 내 컴퓨터에 맞는 명령을 실행하세요.
Windows:
.\.venv\Scripts\python.exe controller.py
Mac/Ubuntu:
.venv/bin/python controller.py
Password:가 나오면 WWW-POSIM 비밀번호를 입력하고 Enter를 누르세요. 입력하는 동안 글자가 보이지 않습니다. 웹사이트에서 WAM-V가 움직이는지 확인하세요.
프로그램은 내 컴퓨터에서 실행되며 내 서버 작업 공간에 명령을 보냅니다. 패키지를 가져오기만 해서는 로그인하거나 연결하지 않습니다. with 블록에 들어갈 때 연결합니다.
잘 되지 않을 때
No module named www_posim_ros: 프로젝트의 Python을 선택하세요. 웹사이트 프로젝트라면 해당.venvPython으로 패키지 설치 명령을 다시 실행하세요.- 최근 센서 값이 없음: 월드가 실행 중이고 로봇이 보이는지 확인하세요. 토픽 이름만 보인다고 데이터가 도착한 것은 아닙니다.
- ROS 2 직접 제어 작업 공간을 시작하라는 안내: 해당 제어 방식을 선택해 월드를 만드세요.
controller_busy: 같은 월드를 제어하는 다른 프로그램을 멈추고 다시 실행하세요.- 월드나 로봇을 변경함: 프로그램을 멈춘 뒤 다시 실행해 현재 연결 정보를 받으세요.
- 설치형 ROS 도구 오류: 준비된 환경의
~/.www-posim-ros/domain-76/client.log를 확인하세요. 필요하면 ROS 도구를 멈추고 다시 여세요.