RViz와 Foxglove 뷰어
실행 중인 월드의 센서 데이터를 읽기 전용 뷰어에서 확인합니다.
RViz Web (Lichtblick)
웹 서버 작업 공간에서 월드를 실행한 뒤 기체 패널의 접기 표시줄에 있는 Open at RViz 버튼을 누릅니다. 새 탭이 자동으로 연결되고 사용 가능한 센서 화면을 불러옵니다. RViz Web은 Lichtblick를 사용하는 WWW-POSIM 센서 뷰어입니다. 별도 계정이나 ROS, 뷰어 설치가 필요하지 않습니다.
패널과 그래프 선택
- 웹 서버에서는 WWW-POSIM 로그인 세션으로 뷰어에 연결합니다.
- 설치형 앱은 네이티브 RViz2를 포함하며 RViz 열기로 실행합니다.
- Overview는 사용 가능한 카메라 영상, 포인트 클라우드나 스캔, 수치 센서 그래프를 한 화면에 배치합니다.
- 그래프는 최근 30초를 표시하며 축 이름, 색상별 데이터와 현재 값을 보여 줍니다.
- 카메라·공간 센서·그래프 탭은 페이지당 최대 6개 패널을 표시하며, 원시 메시지는 별도 탭에서 확인합니다.
- IMU 축, 위치·속도, GPS, 압력, 거리 등 지원하는 수치 항목을 자동으로 선택합니다.
- 탭을 선택하면 해당 센서를 볼 수 있고, 표시 중인 패널에 따라 데이터를 구독합니다.
- 측정값을 제공하지 않는 센서는 제외합니다.
- 월드나 로봇을 변경하면 뷰어를 다시 열어 새 레이아웃을 만드세요.
읽기 전용 접근과 제한
연결은 읽기 전용입니다. 제어 명령 발행, 파라미터 변경, 로봇 서비스 호출은 차단됩니다. 데이터는 토픽당 초당 최대 5개 메시지, 뷰어당 최대 256개 구독, 상위 연결 메시지당 최대 2 MB로 제한됩니다. 이 화면은 원래 전송 속도로 기록하는 용도가 아니라 센서를 확인하는 용도입니다. 공개 LIVE 화면은 개인 월드의 토픽 접근 권한을 제공하지 않습니다.
네이티브 뷰어 표시
- 뷰어를 연 작업공간 세션에 연결된 실행 중인 월드의 데이터를 표시합니다.
- 상단에는 사용자가이드 버튼과 밑줄이 있는 다운로드로 이동 링크가 있습니다.
- 네이티브 RViz2를 사용하려면 설치하기에 따라 앱을 설치한 뒤 실행 창에서 RViz 열기를 누르세요.
- 센서 개요는 격자, WAM-V 또는 BlueROV2 선체 모델과 현재 차량 좌표축 하나를 표시하며, 읽기 전용 세션 프로필에 있는 카메라·스캔·포인트 클라우드·경로 화면을 추가합니다.
- 개별 좌표계를 살펴보려면 Displays에서 TF를 켜세요.
- 선체는 측정된 위치·자세를 따라 움직이고, 카메라 영상은 실제 센서 스트림으로 갱신됩니다.
- 수치 센서의 시간 그래프는 웹 뷰어에서 확인할 수 있습니다.
연결 대기와 다시 연결
뷰어가 연결되지 않으면 작업공간의 월드가 실행 중인지, 로그인·사용 권한이 유지되는지 확인하고 새로 고침을 누르세요. 호스트가 지원하면 새 연결 권한으로 직접 미디어 서버에 접속합니다. 월드·로봇을 바꾸면 작업공간에서 다시 열어 현재 센서 목록과 레이아웃을 받으세요. 브라우저 탭에 남은 영상만으로 최신 데이터라고 판단하지 말고 토픽 시각과 그래프 갱신을 확인하세요.
기본 로봇의 /model/wamv/...·/model/bluerov2/... 예제와 차량 생성기의 /vehicle/sensors/... 토픽은 다를 수 있습니다. 저장한 차량은 ROS 토픽 또는 ros2 topic list에서 이름을 확인한 뒤 코드를 맞추세요.
Foxglove 연결
같은 ROS 2 데이터를 Foxglove의 Rosbridge 연결로 볼 수 있습니다.
- 실행 중인 작업공간에서 RViz Web (Lichtblick)를 엽니다.
- 뷰어 상단의 Foxglove Web 또는 Foxglove Desktop을 누릅니다. WWW-POSIM이 연결 주소를 자동으로 전달합니다. 데스크톱 옵션은 Foxglove를 먼저 설치하세요.
- Foxglove에서 요청하면 로그인합니다. 직접 연결에는 Developer 좌석이 필요합니다. 현재 연결 요건과 요금제를 확인하세요.
- 5분 안에 연결합니다. 로그인에 더 오래 걸리거나 나중에 재연결이 실패하면 RViz Web으로 돌아와 Foxglove 버튼을 다시 눌러 새 주소를 받으세요.
직접 주소로 연결
직접 주소를 입력하려면 Foxglove 버튼을 누른 뒤 Foxglove 연결 주소를 펼쳐 주소를 복사하고, Foxglove에서 Open connection → Rosbridge를 선택합니다. 이 주소는 rosbridge 프로토콜을 사용하므로 Foxglove WebSocket 대신 Rosbridge를 선택하세요. 개인용 주소는 현재 월드에 대한 읽기 전용 접근을 허용합니다. 주소를 공유하지 마세요. 로그아웃, 서버 슬롯 종료 또는 월드 변경 시 접근이 종료됩니다. 연결된 뷰어는 연결 허용 시간인 5분이 지나도 같은 세션의 접근 권한이 유지되는 동안 계속 사용할 수 있습니다.
센서 레이아웃 가져오기
Lichtblick는 생성된 센서 레이아웃을 자동으로 불러옵니다. Foxglove 사용자는 센서 레이아웃 다운로드를 누르고 Foxglove 레이아웃 메뉴에서 JSON을 가져오거나 직접 패널을 구성할 수 있습니다. 패널 호환성은 Foxglove 버전에 따라 달라집니다.
설치형 앱: RViz 열기
시뮬레이터와 작업공간을 실행한 뒤 로컬 브라우저에서 작업 공간 → RViz → RViz 열기를 선택합니다. 설치형 앱의 런처는 열어 두세요. 기체 패널의 접기 표시줄에 있는 Open at RViz 버튼도 사용할 수 있습니다. 런처의 ROS 터미널 열기, VS Code에서 열기 옆에서도 RViz 열기를 선택합니다. 현재 차량의 설정과 시뮬레이션 시계를 사용하는 RViz 창이 따로 열립니다. 읽기 전용 연결로 센서 데이터를 표시하며 차량의 제어권을 가져오지 않습니다.
첫 실행과 요구 사항
Mac, Windows, Linux 설치형 앱에는 RViz와 필요한 ROS·Qt 라이브러리가 포함됩니다. RViz를 열면 준비 창이 바로 나타나 실행 환경과 센서 연결의 준비 상태를 보여 줍니다. 처음 실행할 때 사용자 캐시에 압축을 풉니다. ROS나 RViz를 별도로 설치할 필요가 없습니다. Linux에서는 X11/XWayland를 사용할 수 있는 그래픽 데스크톱이 필요합니다. RViz 창을 닫아도 시뮬레이터와 ROS 터미널은 계속 실행됩니다.