WWW-POSIM v0.6.16시뮬레이터 문서
문서 메뉴
WWW-POSIM / 시뮬레이터 문서

작업공간 익히기

첫 화면에서 월드를 시작한 뒤 각 패널과 버튼의 역할을 살펴봅니다.

계정 만들고 이메일 인증하기

  1. WWW-POSIM에서 계정 만들기를 선택하세요.
  2. 이메일과 비밀번호를 입력하세요. 받은 메일을 열고 Verify email을 누르세요.
  3. 웹사이트로 돌아와 로그인하세요. 메일이 없으면 스팸함을 확인하거나 로그인 안내에서 인증메일 다시 보내기를 선택하세요.

웹사이트와 설치형 앱 모두 이메일 인증이 필요합니다. 메인 화면으로와 로그아웃은 작업 공간에 처음 들어가는 화면에 있습니다.

부산 인근에서 시뮬레이션 시작하기

  1. 내 컴퓨터에서 실행하려면 설치하기하고 로그인한 뒤 Start simulator를 누르세요. 서버에서 실행하려면 웹사이트에 로그인하고 개인 작업 공간을 여세요.
  2. 작업 공간을 여세요. 설치형 앱에서는 이 창을 자동으로 엽니다.
  3. 준비된 지형을 선택하세요.
  4. 지형 슬라이더에서 한국해양대학교 해안 · 1 × 1 km를 선택하면 지역 지형 → 기체가 열립니다. 준비된 지형과 생성이 끝난 지도는 같은 목록에 표시됩니다. 다른 위치에서는 지도를 생성하고 준비가 끝날 때까지 기다리세요.
  5. WAM-V, 수심 0 m, Autopilot을 선택하세요. 나머지는 기본 설정을 유지하세요.
  6. 월드 시작을 누르고 로봇과 실시간 위치가 나올 때까지 기다리세요. 설치형 앱의 첫 설정 창은 월드가 실행된 뒤 닫힙니다.

주변을 보고 센서 확인하기

  1. 차량을 선택해 로봇을 따라가세요. 마우스 왼쪽 버튼으로 드래그하면 이동하고, 오른쪽 버튼으로 드래그하면 회전합니다. 스크롤로 확대하세요.
  2. 월드에서 가까운 장면을 비스듬히 내려다보세요. 지도는 북쪽이 위를 향하며 전체 영역의 지리 지도와 실시간 기체 위치를 보여줍니다. 드래그로 지도를 이동하고 스크롤로 확대하세요.
  3. 센서를 열고 카메라·LiDAR·IMU 중 하나를 선택하세요. 다른 센서를 선택하려면 목록으로 돌아가기를 누르세요.
  4. 영상이나 숫자가 갱신될 때까지 기다리세요. 센서는 가상 로봇이 보거나 느끼는 정보를 측정합니다.

LiDAR는 주변까지의 거리를 측정합니다. IMU는 움직임과 자세를 측정합니다. 휴대전화에서는 패널을 하나씩 열면 장면을 보기 쉽습니다.

기체 제어 패널 찾기

계기 읽기

아래 계기에는 장면 카메라의 방향·시뮬레이션 시간·실시간 배율이 표시됩니다. 고정 화살표는 카메라의 앞쪽을 가리키고, 방위 글자가 회전해 진북의 위치를 보여줍니다. 지도에서는 북쪽이 위를 향합니다. 1.00×는 시뮬레이션 시간이 실제 시간과 같은 속도로 흐른다는 뜻입니다. 확대·축소 버튼은 차량/월드 아래에 드래그·스크롤 안내와 함께 있습니다.

화면 조작하기

조작 동작
차량 로봇 추적. 드래그로 회전, 스크롤로 확대
월드 가까운 장면을 비스듬히 내려다보기
지도 북쪽이 위인 지리 지도와 실시간 기체 위치. 드래그로 이동
장면 렌더러 월드 화면을 브라우저 또는 Gazebo로 표시
집중 보기 장면 확대, 미니맵과 주요 상태 유지
패널 양쪽 패널 숨기기·표시
개인 작업공간의 − 패널 숨기기. 패널·탭 버튼으로 다시 열기
공개 LIVE의 − / + 내용 접기·펼치기, 제목줄 유지

휴대폰에서는 패널을 하나씩 열거나 닫아 장면 공간을 확보하세요. 패널을 숨겨도 시뮬레이션은 계속됩니다. 방위는 N, NE, E 등의 약어로 표시합니다. 위치 데이터가 얼마나 최근에 수신되었는지도 확인하세요.

센서 확인하기

센서 트리에서 로봇을 펼치고 카메라·LiDAR·IMU를 선택합니다.

디지털 확대는 수신 영상에 적용됩니다. 센서 구성은 모델마다 다릅니다.

준비된 지형과 데모 월드

데모 월드

데모 표적 살펴보기

WAM-V 데모는 홍콩 항구 지형에서 두 구형 부표와 함께 시작합니다. 산호색 부표는 전방 16 m·왼쪽 5 m, 라임색 부표는 전방 30 m·오른쪽 8 m에 있습니다. 전방 RGB 카메라와 라이다 스캔을 열어 두 표적을 확인하세요.

준비된 지형 다운로드

Mac 앱은 데모나 준비된 지형을 처음 선택할 때 해당 지형을 다운로드합니다. 다운로드 진행률이 표시되며, 지형이 준비되면 데모를 시작하거나 지역 지형 → 기체를 엽니다. 다운로드한 지형은 이후 오프라인으로 사용할 수 있습니다. 앱을 업데이트해도 각 지형의 고정된 콘텐츠 버전을 유지합니다. 다운로드에 실패하면 연결을 확인하고 데모나 지형을 다시 선택하세요.

작업 공간은 월드를 만들고 실행하는 화면입니다. 웹사이트에 사용자가 많으면 시뮬레이션을 시작하기 전에 대기해야 할 수 있습니다.

작업 공간 화면 읽기

왼쪽 장면·센서 도구, 오른쪽 ArduPilot·기체 계기, 아래 관제 지도가 배치된 WAM-V 실행 화면
한국해양대학교 해안 지형에서 WAM-V를 실행한 화면입니다. 이미지를 선택하면 원본 크기로 볼 수 있습니다.
화면 영역 내용과 용도
상단 표시줄 로봇·지형 이름, 실시간 상태, 작업 공간, 언어, 집중 보기, 패널 표시 버튼입니다. 계정 사용 시간을 관리하는 환경에서는 세션 버튼도 나타납니다.
가운데 장면 실행 중인 월드를 보여 줍니다. 기체·월드·지도 버튼으로 시점을 바꿉니다.
왼쪽 장면 및 센서 장면 탭에서 환경과 표시를 조정하고, 센서 탭에서 로봇의 측정값을 봅니다. ROS 토픽 탭에서는 발행 메시지를 살펴봅니다.
오른쪽 ArduPilot 또는 ROS2 월드에서 선택한 제어 경로입니다. ArduPilot에는 시동·운항 모드·조이스틱·임무·파라미터가, ROS2에는 직접 제어 허용·정지가 나타납니다.
오른쪽 기체 패널 자세 계기, 항목을 바꿀 수 있는 시계열 그래프, 시뮬레이션 배속, 위치·자세, 연결 정보를 보여 줍니다.
왼쪽 아래 관제 지도 로봇의 지리적 위치, 경유점, 경로 명령입니다. 제목 줄을 눌러 지도를 펼치거나 접습니다.
장면 계기 장면 카메라의 나침반, 시뮬레이션 시간, 실제 배속입니다. 카메라가 보는 방향과 기체의 진행 방향을 구분할 때 사용합니다.

− / +는 패널을 접거나 펼칩니다. 접힌 상태에서도 제목 줄로 다시 열 수 있습니다. 설정 항목의 +를 누르면 세부 내용이 나타납니다. 공간이 좁으면 다른 영역이 자동으로 접힐 수 있습니다. 패널은 양쪽 패널을 숨기거나 표시하고, 집중 보기는 장면을 크게 표시합니다. 패널을 숨겨도 시뮬레이션은 계속됩니다.

작업 공간 시작 창

데모 월드, 준비된 지형, 연습 경기장, 커스텀 월드 탭이 있는 작업 공간 시작 창
네 개의 탭에서 작업 공간을 시작할 방식을 고릅니다. 밝은 라임색 탭이 현재 선택입니다.
탭·조작 기능
데모 월드 / Demo worlds WAM-V 또는 BlueROV2를 시작합니다. 다른 로봇 미리보기에는 사용 가능 여부가 표시됩니다.
준비된 지형 / Pregenerated terrain 준비되거나 다운로드할 수 있는 지형과 저장된 완료 지형을 보여 줍니다. 필요한 다운로드를 마치면 기체 설정으로 이동합니다.
연습 경기장 / Practice arena 사용할 수 있는 환경에서 도전과제 연습 설정을 준비합니다.
커스텀 월드 지역 지형, 로봇 편집, RViz 도구, 저장 공간을 엽니다.
위치 → 기체 → 검토 지형 선택·생성, 로봇·시작 위치 설정, 검토·실행 순서입니다.
기체 설정의 제어 모드 시작할 월드에 Autopilot 또는 ROS 2 직접 제어를 선택합니다.
월드 시작 / Start world 선택한 지형과 로봇 설정을 제출합니다. 진행·오류 영역을 보고 실시간 위치가 나타날 때까지 기다립니다.

좌표와 수심을 각 입력 항목의 허용 범위 안에서 채운 뒤 검토 단계로 이동하세요. 사용자 지정 실습 시드는 0부터 1,000,000까지의 정수이며, 비워 두면 배치를 자동으로 정합니다. 자유 탐색과 관리자 기준 실행에는 사용자 지정 실습 시드를 적용하지 않습니다.

월드의 제어 방식은 월드 시작 전에 선택합니다. Autopilot과 ROS 2 직접 제어를 바꾸려면 다른 제어 방식을 선택해 월드를 시작합니다. ArduPilot 패널 안에서 운항 모드를 바꾸는 조작은 이와 구분됩니다.

시점 바꾸기

버튼·동작 효과
기체 / Vehicle 로봇을 따라갑니다. 회전과 확대·축소로 로봇을 관찰합니다.
월드 / World 장면 주변을 비스듬한 시점으로 내려다봅니다.
지도 / Map 지리 좌표가 있는 월드에서 북쪽이 위인 지도를 엽니다.
드래그·오른쪽 드래그·스크롤 현재 화면의 조작 힌트에 따라 이동·회전·확대합니다. 지도 드래그는 지도 이동입니다.
항적 지우기 / Clear track 표시된 계획 경로와 최근 항적을 지웁니다. 현재 위치부터 기록은 계속하며 임무는 취소하지 않습니다.
집중 보기 / 집중 보기 종료 장면을 크게 보거나 기본 배치로 돌아갑니다. 관제 정보도 계속 확인할 수 있습니다.

장면 → 장면 렌더러의 Browser / Gazebo는 주 장면을 그리는 방식을 선택합니다. Browser 장면에서도 물리와 센서 데이터는 Gazebo가 계산합니다. 장면 카메라와 렌더러를 바꿔도 ArduPilot 운항 모드는 바뀌지 않습니다.

장면과 환경 패널

렌더러, 환경, 표시 설정이 있는 장면 패널
필요한 항목을 펼쳐 사용합니다. 실행 중인 월드에 따라 설정 가능 여부가 달라집니다.
항목 조작과 해석
파도 / Waves 해상 상태 프리셋을 고르거나 고급 바람 설정을 엽니다. 파도 적용을 누른 뒤 아래의 확인·상태 표시를 읽습니다.
해류 / Ocean current 해류를 지원하는 런타임에서 해류 사용을 켜고 균일 해류 또는 수심별 해류를 고릅니다. 유속·방향을 편집하고, 수심별 해류에서는 노드를 좌우로 끌어 유속을 바꾸거나 표에서 수심 노드를 편집·추가합니다. 해류 적용을 누른 뒤 해류 물리 계산 확인됨을 확인합니다. 변경 전 임무·ROS 직접 제어를 중지하세요.
해상 교통 / Marine traffic AIS 보고와 동기화한 시각화 선박을 표시합니다. 사용자 월드는 로컬에 입력한 AISStream 키를 사용합니다. 수신 범위와 배속에 따라 사용 여부가 달라집니다.
장면 렌더러 / Scene renderer Browser·Gazebo를 고릅니다. 지원 환경에서는 수중 표현을 펼쳐 질감·물안개·흡수·조명·측정선을 조절합니다.
표시 / Display 해저·수면·기준 격자·로봇 축 표시를 바꿉니다. 표시를 켜도 새로운 측정값이 생기지는 않습니다.
자연광·낮/밤 장면의 조명 표현을 바꿉니다.
수면 불투명도·지도 겹치기·지도 불투명도 현재 렌더러와 시점에서 지원하는 가시성과 지도 표시를 조절합니다.
그래픽 성능 / Graphics performance 실제 측정한 브라우저 렌더링 통계를 보여 줍니다.

해류의 흐르는 방향은 0°가 동쪽, 90°가 북쪽입니다. 카메라 나침반과 각도 기준이 다릅니다. 해류 프로필의 범위·보간, 해상 상태 범위·지형 준비·광학 설정은 작업공간 익히기과 원하는 지역의 지형 만들기를 참고하세요.

센서와 ROS 토픽

로봇 카메라의 실제 영상과 스트림 조작 버튼이 있는 센서 패널
센서를 선택하면 측정 화면이 열립니다. 목록으로 돌아가기를 누르면 다른 센서를 선택할 수 있습니다.
조작 효과
센서 → 센서 이름 카메라·스캔·수치 측정값을 엽니다. 센서 구성은 로봇 모델에 따릅니다.
영상 시작·정지 / Start stream·Stop stream 해당 영상 수신을 시작하거나 중지합니다. 시뮬레이션은 계속됩니다.
확대 보기 / Enlarge 카메라 영상을 큰 창으로 엽니다.
프레임 저장 / Save frame 개인 패널의 수신 이미지 또는 공개 데모의 재생 영상 스냅샷을 저장합니다.
센서 주기 / Sensor rate 지원하는 영상 전송 주기를 요청합니다. 측정 주기는 실제 수신 결과입니다.
디지털 줌·초기화 / Digital zoom·Reset 받은 영상을 디지털 확대하거나 기본 배율로 되돌립니다.
ROS 토픽 → 검색·토픽 토픽을 찾아 메시지 화면을 엽니다.
구독 / 구독 해제 뷰어에서 선택한 토픽의 수신을 시작하거나 중지합니다.
필드·그래프·원시 값·그리기 수치 항목을 선택하고 값을 확인하거나 지원하는 공간 메시지를 그립니다. 메시지 종류와 좌표계에 따라 옵션이 달라집니다.

주 장면의 기체·월드 카메라는 관찰용 시점입니다. 센서 카메라 패널은 로봇 자체의 시뮬레이션 카메라를 보여 주므로 서로 다른 방향을 볼 수 있습니다. 외부 시각화와 제어 연결은 설치형 작업공간에서 제어를 참고하세요.

영상이 아직 안 보일 때

영상 시작 뒤의 연결 중·대기 표시는 센서와 스트림을 준비하는 상태입니다. 숫자나 영상의 수신 시각도 확인하세요. 오래됨·재연결 상태에서 남은 화면은 최신 측정값이 아닙니다. 멈춘 것처럼 보여도 월드가 준비 중인지, 센서가 선택되어 있는지 먼저 확인하세요.

공개 홍콩 데모의 RGB 카메라는 공유 H.264 영상을 사용하며 첫 버퍼가 준비될 때까지 기다립니다. 개인 작업공간의 카메라 패널은 JPEG 프레임을 요청하고, ROS 압축 영상은 별도의 수신 경로입니다. 프레임 저장은 데모에서 현재 재생 영상의 스냅샷, 개인 패널에서는 수신한 이미지 파일을 저장합니다. 센서 Hz·동영상 FPS·물리 배율은 서로 다릅니다. 영상·센서 전달 경로를 참고하세요.

ArduPilot: 시동과 운항 모드 변경

운항 모드 적용 후 시동 해제와 HOLD를 보고하는 WAM-V ArduPilot 패널
WAM-V는 ArduRover 보트 제어기를 사용합니다.
운항 모드 적용 후 ALT_HOLD를 보고하는 BlueROV2 ArduPilot 패널
BlueROV2는 ArduSub를 사용하며 운항 모드 선택지가 WAM-V와 다릅니다.
  1. ArduPilot 제목을 펼칩니다. 연결 상태, 시동 상태, 보고된 현재 모드를 읽습니다.
  2. 수동 입력을 중앙으로 돌리고 해제합니다. 실행 중인 임무는 끝내거나 중단한 뒤 수동 모드를 바꿉니다.
  3. 운항 모드 / Flight mode에서 값을 고르고 적용 / Apply을 누릅니다.
  4. 버튼 아래의 운항 모드 · …와 제목 줄을 확인합니다. 드롭다운은 요청할 값이고, 보고된 값으로 제어기의 적용 상태를 확인합니다.

시동 켜기 / Arm은 준비 상태를 검사한 뒤 추진 제어를 허용합니다. 시동 끄기 / Disarm은 이를 해제하고 실행 중인 임무를 취소합니다. 모드만 선택해도 시동이 켜지지는 않습니다. 거부되면 오류와 연결 정보를 읽으세요. 지형 준비 대기와 활성 임무는 모드 변경을 막을 수 있으며, 카메라 영상만으로 제어 준비가 완료되지는 않습니다.

WAM-V 운항 모드

메뉴의 모드 의미
MANUAL 조종자의 스로틀·조향 입력이 출력에 직접 반영됩니다.
HOLD 정지·중립 추진을 명령합니다. 관성·파도·조류에 따라 선박은 계속 움직일 수 있으므로 지리적 정점 유지와 구분합니다.
STEERING 조종 입력에 피드백을 사용해 속도와 선회를 제어합니다. 경유점 경로를 자동 실행하는 모드는 아닙니다.

제어기 동작은 ArduPilot의 Manual, Hold, Steering 설명을 참고하세요.

BlueROV2 운항 모드

메뉴의 모드 의미
MANUAL 자동 자세·수심 안정화 없이 조종자가 직접 제어합니다.
STABILIZE 자세를 안정화하며 수심은 조종자가 제어합니다.
ALT_HOLD 자세 안정화에 자동 수심 제어를 더합니다. 수직 입력이 중립이면 목표 수심을 유지하며, 수평 위치 유지는 별도입니다.

이 표는 WWW-POSIM 메뉴가 제공하는 모드입니다. 전체 제어기 모드는 공식 ArduSub 모드 문서에서 확인할 수 있습니다.

임무와 GUIDED

검사한 경유점 경로나 프리셋 임무를 시작하면 앱이 시작 절차에서 GUIDED와 시동을 요청합니다. GUIDED는 임무 실행기가 관리하며 수동 드롭다운의 선택지는 아닙니다.

관제 지도의 정지 / Stop는 실행 중인 임무를 유지 목표 주변에서 일시 정지합니다. 계속 / Continue는 재개하고 중단 / Abort는 취소 후 시동을 해제합니다. 이 동작은 ArduRover의 HOLD를 고르거나 조이스틱 입력을 중지하는 조작과 구분합니다.

조이스틱과 게임패드 입력

입력 방식·입력 게인·조작 패드가 있는 조이스틱 패널
Autopilot 월드에서 조이스틱 입력을 켜면 수동 입력 패널이 나타납니다.

ArduPilot에서 조이스틱 입력을 켜고 마우스·터치 또는 게임패드를 고릅니다. 축 이름을 읽으세요. WAM-V는 스로틀·조향을, 수중 로봇은 좌우·수직 제어도 제공합니다. 입력 게인 / Input gain은 수동 입력의 크기를 조절합니다. 입력을 중앙으로 놓고 낮은 게인으로 시작합니다.

마우스·터치 입력에서 입력 중지를 누르면 누름 상태를 해제합니다. 패드에서 손을 뗀 뒤 다시 눌러야 명령을 보냅니다. 창이 비활성화되거나 시동이 해제되거나 입력 장치를 바꾸거나 명령이 거절될 때도 누름 상태를 해제합니다.

게임패드에서는 LB/L1을 누른 동안 스틱 명령을 보냅니다. 버튼을 놓거나 입력 중지 / Stop input를 누르면 중립 입력을 보냅니다. 시동 해제와는 다르며 움직이던 로봇은 바로 멈추지 않을 수 있습니다. BlueROV2의 Y/Triangle은 ALT_HOLD, A/Cross는 STABILIZE를 요청합니다. ArduPilot에서 보고된 결과를 확인하세요. 전체 버튼 매핑과 입력 장치 프로필은 작업공간 익히기를 참고하세요.

관제 지도와 임무

경로를 확인하기 전에 경유점 좌표와 수심을 채우세요. 편집 중에 비운 입력 칸은 그대로 비워 둡니다. 새 수중 경유점의 기본 수심은 2 m입니다. 일반 범위는 0–10 m이며 지원되는 탐색 장면에서는 서버가 표시하는 현재 임무 수심 제한를 확인하세요.

경유점 편집과 경로 확인·실행·정지·계속·중단 버튼이 있는 관제 지도
경유점과 임무 명령을 같은 패널에서 사용합니다. 지도를 접어도 경로 확인·실행 버튼이 남습니다.
조작 효과
클릭·경유점 우클릭 경유점을 추가하거나 가까운 점을 삭제합니다. 드래그와 휠·핀치는 지도 이동과 확대·축소입니다.
경유점 목록 좌표와 수중 수심을 수정합니다. 수상 경유점의 수심은 0 m이며, 지도에서 만든 경유점은 1초 동안 대기합니다.
출발점 복귀·지우기 복귀 동작을 추가하거나 편집 중인 경유점 선택을 지웁니다.
경로 확인 / Check route 지형을 검사한 미리보기를 만듭니다. 경로선과 여유 거리·차단 사유를 확인합니다.
경로 실행 / Run route 준비 상태를 검사하고 시동을 켜 확인한 경로를 시작합니다.
시동 켜기·끄기 시동을 제어합니다. 시동 해제는 임무도 취소합니다.
정지·계속·중단 유지 목표에서 일시 정지·재개·취소 후 시동 해제입니다.

경로가 시작된 뒤 다시 실행하려면 경로를 다시 확인하세요. 이전 미리보기 이후 기체의 위치가 달라졌을 수 있습니다.

ArduPilot → 프리셋 시나리오 미션에서 프리셋과 수심·크기를 고른 뒤 경로를 확인합니다. 미리보기가 성공하면 버튼이 시동 후 임무 실행으로 바뀝니다. 지도 경유점이 있으면 우선하므로 프리셋을 사용하려면 경유점을 지우세요. 경로 확인은 지형과 선체 여유를 평가하며, 움직이는 선박의 완전한 회피나 COLREG 준수를 제공하지 않습니다.

기체 패널

기체 / Vehicle 패널은 오른쪽 ArduPilot 또는 ROS2 아래에 있습니다. 제목 줄의 + / − 버튼으로 펼치거나 접습니다. 휴대전화에서는 모바일 전환 버튼에서 기체를 먼저 고르세요. 내용이 화면보다 길면 패널 안에서 스크롤합니다. 시뮬레이션 속도, 위치·자세, 연결 정보를 각각 펼쳐 세부 내용을 확인합니다.

자세 계기와 수심 그래프, 배속 설정, 펼칠 수 있는 위치·연결 정보 항목이 있는 차량 패널
시동을 끈 WAM-V의 실시간 계기입니다. 세부 항목을 펼쳐 배속, 위치, 연결 상태를 확인하세요.

자세 계기와 그래프

파란 고정 표식은 로봇을 나타냅니다. 움직이는 수평선과 각도 눈금으로 롤과 피치를 읽습니다. 옆의 숫자는 기체 자세를 표시합니다.

표시 의미
방향 / Heading 기체의 나침반 방위입니다. 북쪽 0°, 동쪽 90°, 남쪽 180°, 서쪽 270°이며 영문자는 가장 가까운 방위입니다. 장면 아래의 나침반은 별도로 카메라 방향을 따릅니다.
롤 / Roll 좌우 기울기이며 단위는 도입니다.
피치 / Pitch 계기의 표시 기준으로 읽는 기수의 위아래 각도이며 단위는 도입니다.
수심 / Depth 월드의 해수면 기준 높이 0 m에서 계산한 부호 있는 수심 −Z(m)입니다. 기준면 아래는 양수, 위는 음수입니다. 해저까지의 여유 높이와는 구분됩니다.

작은 그래프 위의 드롭다운에서 수심, 방향, 피치, 롤, 속도, 추진기 입력을 고릅니다. 굵은 숫자는 선택한 값과 단위이고, 선은 최근 수신한 자세 표본 100개입니다. 선택을 바꾸면 그래프 항목이 바뀝니다. 남아 있는 추세선을 읽기 전 실시간 상태와 메시지 경과 시간을 확인하세요. 자세가 없거나 오래되면 흐리게 표시하거나 —로 표시합니다.

수심과 자세는 같은 오도메트리 표본과 측정 시각을 사용합니다. 수상 기체가 위아래로 움직이면 수심 그래프가 0을 오갈 수 있습니다. 데모에서는 이 표본을 버퍼링된 영상 재생 시각에 맞춰 표시합니다.

선택기 옆 작은 글씨에서 데이터 출처를 확인할 수 있습니다. 수심·자세·속도는 Gazebo 시뮬레이터 값을 사용합니다. 속도는 기체 좌표계의 X(전방), Y(왼쪽), Z(위쪽)를 m/s 단위로 함께 표시합니다. 추진기 입력은 추진기별 추력 명령을 N 단위로 표시하며 각각 범례가 있습니다. 실제 측정한 힘이 아니라 요청된 추력입니다. 명령 표본이 없거나 오래되면 선이 끊깁니다.

시뮬레이션 속도

시뮬레이션 속도 / Simulation speed 항목을 펼치면 두 선택 상자가 나타납니다. 값을 선택하면 즉시 요청합니다. 적용이 끝날 때까지 기다린 뒤 아래 결과를 확인하세요.

조작·표시 사용법
시뮬레이션 속도 선택 0.25·0.5·1·2·4배속을 요청합니다. 예를 들어 2배속은 실제 1초 동안 시뮬레이션 2초를 진행하도록 요청합니다.
물리 시간 간격 / Physics step 선택 물리 계산의 적분 간격을 5·10·20 ms에서 고릅니다. 이미 30 ms를 쓰는 월드는 현재 값인 30 ms도 표시합니다.
실제 / Actual와 제목 줄의 값 실제 시간에 대한 시뮬레이션 시간의 비율입니다. 컴퓨터의 계산이 따라가지 못하면 요청 배속보다 낮을 수 있습니다. 선택 상자 아래에는 적용된 물리 시간 간격도 표시합니다.

시간 정보가 준비되고, 시동이 꺼져 있으며, 임무·수동 입력·ROS 제어 스트림이 비활성화되고, 지형이 준비되면 조정할 수 있습니다. 적용 중 표시나 오류를 읽으세요. 요청 배속이 1배를 넘으면 AIS 교통을 사용할 수 없으며, 지원 배속으로 돌아오면 사용할 수 있습니다. 시간 설정의 영향은 커스텀 월드를 참고하세요.

위치·자세

위치·자세 / Position & orientation 항목을 펼치면 로컬 위치, 제공되는 지리 좌표, 원시 자세가 나타납니다. 프레임 이름은 위치의 기준 좌표계를 나타냅니다.

필드 의미
N / E / D, m 표시된 로컬 프레임 원점 기준의 북쪽·동쪽·아래쪽 위치입니다. D는 아래쪽이 양수입니다.
월드 좌표 / World coordinates 지리 좌표가 있는 세션의 위도, 경도 순서이며 단위는 도입니다.
자세 · ENU 아래 R / P / Y, 도 동·북·위 좌표계의 원시 롤·피치·요입니다. 요 0°는 동쪽, 90°는 북쪽을 향합니다.

자세 계기는 원시 각도를 표시 기준에 맞게 변환합니다. 계기 피치는 −P이고 선수 방향은 (90 − Y + 360) % 360입니다. 예를 들어 원시 요 0°는 선수 방향 90°인 동쪽에 해당합니다. ROS 도구와 비교할 때 좌표계 이름을 확인하세요. 대기 중이거나 오래된 위치 정보는 이 항목에 표시됩니다.

연결 정보와 RViz

기체 패널의 연결 정보 / Connection details를 펼치면 #순번, 메시지 경과 시간(초), 프레임과 ENU 기준이 나타납니다. 순번이 증가하고 경과 시간이 짧으면 새 자세 메시지가 도착하는지 확인할 수 있습니다. 이 정보는 자세 수신 진단이며, ArduPilot·ROS2 패널의 연결 정보는 제어기 연결을 설명합니다.

기체 제목 줄의 RViz에서 열기 / Open at RViz는 세션이 지원하는 ROS 시각화를 엽니다. 설치형 앱은 네이티브 RViz2를 제공하고 웹 작업 공간은 브라우저 뷰어를 엽니다. 월드가 준비되어야 하며 설치형 앱에서는 로컬 RViz 서비스도 준비되어야 합니다. 비활성화된 버튼에 마우스를 올리면 사유를 읽을 수 있습니다. 설치형 작업공간에서 제어를 참고하세요.

제어기 조정은 ArduPilot → ArduPilot 파라미터에서 합니다. 읽기·검색·내보내기, 변경 미리보기, 시동 해제 상태에서 허용된 값 적용을 수행하고 읽어 온 값을 확인하세요. Autopilot 파라미터 바꾸기를 참고하세요.

ROS 2 직접 제어 모드

허용·정지 버튼과 연결 진단이 있는 ROS2 직접 제어 패널
ROS 2 직접 제어로 시작한 월드에서는 ArduPilot 대신 이 패널이 나타납니다.

ROS 허용 / Enable ROS 버튼은 연결한 제어기가 현재 세션에 제한된 명령을 보낼 수 있게 합니다. ROS 중지 / Stop ROS 버튼은 다시 허용할 때까지 중립 출력을 유지합니다. 연결 정보에는 사유, 적용 순번·ACK, 추력이 나타납니다. 명령이 도착하지 않으면 연결 감시기가 출력을 중립으로 되돌립니다.

ArduPilot 시동·운항 모드 선택·내장 유도 임무는 Autopilot 월드에서 사용합니다. ROS 2 직접 제어 월드의 연결과 프로그램 작성은 설치형 작업공간에서 제어를 따라 진행하세요.

저장한 지형·차량 관리

작업 공간 → 커스텀 월드 → 저장 공간에서 모델 버전·지형·캐시와 남은 디스크를 확인합니다. 계정 저장 공간이 활성화된 호스트에서는 보관으로 항목을 선택 목록에서 숨기고, 같은 화면의 복원으로 다시 표시합니다. 보관은 파일 삭제가 아니며 사용량을 줄이지 않습니다. 대기·시작·실행·종료 중인 세션이 사용하는 항목은 작업이 끝난 뒤 보관하세요.

차량 생성기의 ZIP 내보내기 / 차량 가져오기는 다른 컴퓨터로 구성을 옮길 때 사용합니다. 복사 후 편집은 새 버전을 만듭니다. 자세한 내용은 커스텀 차량 준비하기를 참고하세요.

작은 화면과 자주 묻는 내용

공개 홍콩 데모에서 휴대전화의 데스크톱 화면은 데스크톱 배치를 현재 보이는 브라우저 영역 안에 축소해 표시합니다. 가로 화면에서 크기를 맞추고 세로 화면에서는 회전을 안내하며 모바일 화면으로 돌아가기로 패널 방식에 복귀합니다. 전체 화면은 브라우저 지원과 사용자 동작에 따라 동작합니다. 주소·탭 표시줄이 남아 있으면 그 아래의 사용 가능한 영역에 맞춥니다.

다음으로 작업공간 익히기, 설치형 작업공간에서 제어, 원하는 지역의 지형 만들기를 참고하세요.

장면 렌더러 선택하기

해상 상태 선택

해류 적용

해류를 지원하는 런타임이 연결되면 파도 아래의 장면 → 해류를 여세요. 해류 사용을 켜고 균일 해류 또는 수심별 해류를 고른 뒤 해류 적용을 누르세요. 변경 전 임무나 ROS 직접 제어를 중지하세요. 챌린지 해류는 지정된 조건을 따릅니다.

수심별 해류 편집

해류는 차량의 물에 대한 상대속도를 바꾸어 항력과 감쇠력에 영향을 줍니다. 바람으로 생긴 파도는 자체 모델로 파도에 따른 부력과 하중을 계산합니다. 해류는 파도 스펙트럼, 파장, 전파를 바꾸지 않습니다. 해류 물리 계산 확인됨은 실제 물리 계산에서 받은 최신 값이 적용한 프로필과 일치한다는 뜻입니다.

물리 시간 간격 설정

Windows와 Linux 설치형 앱은 20ms 물리 시간 간격으로 시작합니다. Mac 네이티브 앱은 10ms를 사용합니다. 기체가 무장 해제된 상태에서 기체 패널의 시뮬레이션 속도 설정으로 5ms 또는 10ms를 선택하면 시간 해상도를 높일 수 있습니다. 도전과제 프로필은 규정된 10ms 간격을 유지합니다. 실시간 배율은 요청 배속이 아닌 실제 진행 속도입니다.

장면 보기와 센서 영상

두 화면은 같은 시뮬레이션을 사용합니다. 물리 계산과 센서 데이터 생성은 Gazebo가 담당합니다. 카메라와 GPU LiDAR는 Gazebo에서 렌더링하고, IMU와 위치 데이터는 시뮬레이션에서 계산합니다. 월드를 브라우저로 표시하면서도 이 센서들을 확인할 수 있습니다.

수중 표현

실행 중인 작업 공간에서 장면 → 장면 렌더러 → 수중 표현을 여세요. 각 스위치는 Gazebo 장면과 RGBD 컬러를 포함한 카메라 컬러 영상에 실시간으로 적용됩니다. 조작부에는 렌더러가 적용을 확인한 설정이 표시됩니다. 깊이 측정과 충돌 형상은 수치값을 유지합니다.

효과 기본값과 설정 저장

카메라 가시거리

기본 BlueROV2 전방 카메라의 기하학적 클리핑 거리는 카메라 거리 제한과 가시성을 참고하세요. 수중에서 실제로 보이는 거리는 물안개·감쇠·가려짐에 따라 줄어듭니다. 차량 화면의 궤적 두께는 5 mm이며 센서 영상에는 포함되지 않습니다.

경로와 항적 표시

두 장면 렌더러에서 노란색은 계획 경로, 청록색은 실제 항적을 나타냅니다. 새 유도 미션을 시작하면 Gazebo의 청록색 항적이 지워집니다. 확대·축소 버튼 옆의 항적 지우기로 계획 경로와 실제 항적을 화면에서 함께 지울 수 있습니다. 현재 위치부터 새 항적이 이어지며 미션 보고서는 유지됩니다. 화면에는 최대 1,024개 구간이 표시되고, 기체가 이동하면 가장 오래된 구간부터 교체됩니다.

렌더링 모델의 가정

광학 효과는 Gazebo 보기에서 확인하세요. 브라우저 미리보기는 모래 질감과 해저면 선 설정을 공유합니다. 효과는 평평한 평균 해수면과 PBR 표면을 기준으로 하며, 하늘 배경에도 수중 경로 감쇠가 적용됩니다. 사용자 수면 셰이더와 비조명 재질은 자체 표현을 사용합니다. 햇빛 무늬와 부유 입자는 시각적 근사입니다. 모래 이미지 출처는 원하는 지역의 지형 만들기를 참고하세요.

AISStream 키

데모 월드는 서버에 설정된 AISStream 키로 해상 교통을 자동으로 켭니다. 설치형 앱의 데모는 서버 키가 없으면 Open Waters 공개 AIS 피드를 사용합니다. 해상 교통 패널에서 공급자와 연결 상태를 확인할 수 있습니다. 주변 선박의 표시 여부는 해당 지역에서 수신한 최신 보고에 따라 달라집니다.

사용자 월드에는 개인 키가 필요합니다. 장면 → 해상 교통을 열고 AISStream API 키를 입력한 뒤 키를 내 컴퓨터에 저장을 누르세요. 키는 현재 브라우저에 저장되며 선택한 시뮬레이터 서버로 전송됩니다. 저장한 키 삭제로 지울 수 있습니다. 해상 교통을 켜면 연결을 시작합니다. 실제 AIS 위치 보고에 따라 선박을 표시합니다.

QGC로 제어

Autopilot 차량은 ArduPilot 패널의 Open QGC로 연결합니다. 설치형 앱과 로그인한 작업공간을 열어 두세요. 연결 창에서 차량을 준비한 뒤 QGroundControl로 제어권을 넘깁니다. 설치·연결·제어권 반환은 QGC로 제어를 참고하세요.

BlueROV2 전방 조명

조이스틱 제어의 전방 조명으로 BlueROV2 조명 두 개를 함께 ON/OFF합니다. 실제 조명 상태를 읽어 확인하며 실패하거나 사용할 수 없는 명령을 성공으로 표시하지 않습니다. 기체 조명은 장면의 낮/밤 및 카메라 선택과 별개입니다.

문서 검색