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

기술 사양

WWW-POSIM의 기본 실행 환경, 데이터, 물리 모델과 로봇 인터페이스입니다. 플랫폼이나 월드에 따라 달라지는 값은 별도로 표시합니다.

소프트웨어

항목 사양
ROS ROS 2 Lyrical
Gazebo Jetty · Gazebo Sim 10; macOS 패키지: 10.5.0
수상 자동조종 ArduRover 4.7.2 · SITL
수중 자동조종 ArduSub 4.7.2 · SITL
ArduPilot 소스 fb773567896014da007bca58358704d4a0d8516f
브라우저 그래픽 Three.js 0.186.1 · React Three Fiber 9.8.1

시뮬레이션 시간

항목 사양
기본 실행 속도 목표 1×
macOS 물리 시간 간격 10 ms
Windows/Linux 앱 물리 시간 간격 20 ms
도전과제 평가 시간 간격 10 ms
웹 서버 시간 간격 서버 설정에 따라 다름

주기는 시뮬레이션 시간 기준입니다. 실제 실행 배율(RTF), 물리 갱신 주기, 센서 주기와 화면 FPS는 서로 다른 값입니다.

물리와 렌더링

항목 사양
강체 운동·충돌 Gazebo Physics · 기본 DART 엔진
해양 물리 Wave Sim 파도·부력·유체력
BlueROV2 유체력 파도에 따른 부력과 선형·회전 감쇠
Gazebo 장면·센서 엔진 호스트의 Ogre2 · macOS는 Metal
브라우저 장면 Three.js/WebGL이 시뮬레이터 상태로 지형·로봇·바다를 렌더링
브라우저 파도 형상 물리 파도 계산에서 얻은 샘플

지형·파도·해저 범위

항목 사양
WAM-V 데모 지형 준비된 홍콩 항구 · 2 × 2 km 중심과 주변부를 합쳐 6 × 6 km · 수치 고도·수심과 항공영상
사용자 월드 기본 모드 고정 1 × 1 km 영역 · 필요에 따라 지형 생성 선택 가능
초기 지형 자료 범위 1,000 × 1,000 m · 129 × 129개 표본
동적 지형 격자 간격 7.8125 m
기본 동적 지형 타일 1,000 × 1,000 m
개인 작업 공간 필수 해저 5 × 5개 타일 · 5 × 5 km
LIVE 필수 해저 7 × 7개 타일 · 기본 타일 기준 7 × 7 km
동적 지형을 끈 고정 영역 기본값 1 × 1 km · 513 × 513개 표본 · 간격 1.953125 m
주기적 물리 파도 타일 256 × 256 m · 64 × 64개 셀
개인 Gazebo 상세 수면 3 × 3 반복 타일 · 768 × 768 m
LIVE 파도 시각화 타일 15 × 15개 타일 · 3,840 × 3,840 m

물리 파도 계산 타일, 눈에 보이는 수면, 수치 지형과 로드된 충돌 해저의 범위는 서로 다릅니다. 반복 파도 타일은 하나의 주기적 파도장을 공유합니다. WAM-V 데모는 준비된 홍콩 지형을 사용합니다. 도전과제는 별도로 수심 20 m의 평탄한 경기장을 사용합니다. 지형 방식별 해상도와 지형 LOD: 차량 가까이는 자세하게를 확인하세요.

필요한 지형의 생성과 배치

항목 사양
자료 준비 수치 고도·수심과 이용 가능한 육상 영상을 받아 미터 단위 지역 격자로 투영
타일 생성 공유 격자에서 시각·충돌 메시 생성 · 경계 연속성을 위해 2개 셀의 주변 샘플 포함
Gazebo 배치 지역 좌표에 실제 SDF 지형 엔티티 배치
준비 상태 확인 엔티티 존재와 RGBD 깊이 확인 · 반지름 0.25 m·질량 10 kg 구체를 떨어뜨려 경사면을 반영한 메시 거리로 접촉 판정 · 지형 준비 상태 검사
미리 불러오기 위치·속도로 다음 외곽 행 준비 · 120초 앞을 기준으로 최소 250 m, 타일 폭의 40% 이내
대기와 재개 필수 지형이 부족하면 대기 · 현재 영역 전체가 검증되면 재개
캐시와 메모리 관리 저장한 샘플과 최근 타일 재사용 · 유지 수 제한에 따라 먼 엔티티 제거

데이터셋

항목 사양
GEBCO 2026 전 지구 고도·수심 · 원본 격자 15각초
Copernicus GLO-30 육상 고도 · 명목 30 m
Copernicus Marine 202511 지원 지역의 연안 수심
EMODnet DTM 2024 주로 유럽 해역의 지역 수심
KHOA BADA2024 이용 가능한 국내 해역 수심
Cesium World Bathymetry 라이선스와 수치 자료 접근이 설정되면 우선 적용
OpenStreetMap 해안선 육지·바다 경계 보정
Sentinel-2 RGB 육상 영상 · 명목 10 m

실제로 사용한 자료는 월드의 출처 정보에 기록됩니다. 생성 메시의 격자 간격을 줄여도 원본 측정 자료의 정확도가 높아지지는 않습니다.

기본 로봇

항목 사양
WAM-V 추진기 좌·우 2개
BlueROV2 추진기 6개
WAM-V 질량 본체 링크 180 kg · 모델 링크 합계 211.151 kg
BlueROV2 질량 본체 링크 10 kg · 모델 링크 합계 약 10.0132 kg
WAM-V 본체 충돌 형상 크기 5.006 × 2.487 × 1.291 m
BlueROV2 본체 충돌 상자 0.457 × 0.338 × 0.065 m
BlueROV2 전방 조명 전방 스포트라이트 2개; 기본 ON; 모델 감쇠 범위 25 m
BlueROV2 제조사 외형 치수 0.457 × 0.338 × 0.254 m

충돌 형상 크기는 시뮬레이션 형상 기준이며 실제 제품의 전체 치수와 구분합니다. 질량 합계는 SDF 링크 질량의 합입니다.

기본 센서와 상태 출력

항목 사양
WAM-V GNSS 기본 제공 · 5 Hz · 지연 0.2초 · GPS_INPUT → ArduPilot EKF
BlueROV2 위성 GNSS 기본 켜짐 · 명시적으로 끌 수 있음 · 안테나 침수 판정 · 재획득 3초
WAM-V IMU 200 Hz
BlueROV2 IMU 설정 1,000 Hz · 실제 갱신은 물리 계산 간격의 제한을 받음
두 로봇의 전방 RGB 640 × 480 px · 5 Hz · 수평 시야각 1.05 rad (60.2°)
BlueROV2 검사 RGB-D 640 × 480 px · 5 Hz · 수평 시야각 60.2° · 아래쪽 45°
WAM-V 2D LiDAR 5 Hz · 360°에 360개 샘플 · 거리 0.2–50 m · 거리 해상도 0.02 m
BlueROV2 자력계 20 Hz · Gazebo
WAM-V 위치·자세·속도 20 Hz
BlueROV2 위치·자세·속도 100 Hz

카메라는 구독 시 활성화됩니다. 표준 ROS 연결의 JPEG 영상은 시뮬레이션 시간 기준 최대 1 Hz입니다. Odometry는 시뮬레이터 상태이며 실제 위치 센서의 오차를 포함한 측정값이 아닙니다. 수신 주기는 센서 설정 주기보다 낮을 수 있습니다.

GNSS와 항법에서 측정 품질, 안테나 좌표계, 신호 중단과 복귀를 설명합니다.

차량 생성기로 저장한 구성은 센서 종류·토픽·장착 위치·설정이 달라질 수 있습니다. 생성한 센서는 /vehicle/sensors/{sensor_id} 아래의 토픽을 사용하며 출력별 접미사가 붙습니다. 실제 목록과 좌표계는 실행 중인 ROS 토픽과 내보낸 sensor-manifest.json에서 확인하세요. DVL·Ping·멀티빔 구분은 선택 센서와 공급자를 참고하세요.

각 측정의 구현, SDF 파라미터 이름, 잡음·좌표계·유효성 규칙은 센서 구현과 파라미터를 참고하세요.

카메라 거리 제한과 가시성

항목 사양
기본 WAM-V 전방 RGB near 0.1 m · far 5,000 m
기본 BlueROV2 전방 RGB near 0.1 m · far 5,000 m
BlueROV2 검사 RGB-D near 0.1 m · far 80 m
차량 생성기의 카메라 저장한 센서 설정 사용 · 위의 기본 로봇 카메라와 구분
개인 Gazebo 장면 카메라 Near 0.1 m · far = max(5,000 m, 지형 3차원 대각선 × 16)
LIVE Gazebo 장면 카메라 Near 0.1 m · far 5,000 m · 1280 × 720 픽셀
브라우저 World/Vehicle 카메라 Near 0.03–40 m 자동 조정 · far 최소 8,000 m, 월드 크기·시점 거리에 따라 확장

클리핑은 기하학적으로 그릴 거리 범위입니다. 수중 감쇠, 가려짐, 로드된 지형과 영상 자료 범위에 따라 실제로 식별 가능한 거리는 더 짧아집니다. 장면 카메라와 로봇 센서는 별개입니다.

ROS 토픽과 메시지

항목 사양
/clock rosgraph_msgs/msg/Clock
/model/{robot}/odometry nav_msgs/msg/Odometry
/model/{robot}/imu sensor_msgs/msg/Imu
/model/{robot}/camera/compressed sensor_msgs/msg/CompressedImage · JPEG, ≤1 Hz
/model/wamv/scan sensor_msgs/msg/LaserScan
/model/bluerov2/inspection/image/compressed sensor_msgs/msg/CompressedImage · RGB
/tf, /tf_static tf2_msgs/msg/TFMessage
/mavros/battery sensor_msgs/msg/BatteryState · ArduPilot 모드
/wwos/cmd_vel geometry_msgs/msg/TwistStamped · WAM-V ROS 직접 제어
/wwos/thrusters std_msgs/msg/Float64MultiArray · ROS 직접 제어, 추력 N

{robot}은 wamv 또는 bluerov2입니다. 연결기는 검사 카메라의 RGB 영상을 제공합니다. RGB-D 센서의 깊이는 별도의 네이티브 출력입니다. 유효한 명령이 0.75초 동안 들어오지 않으면 추진 명령을 중립으로 전환합니다.

좌표계·단위·모델 가정

항목 사양
지리 좌표 WGS 84 · 위도·경도(도)
지역 월드 축 ENU · 동쪽 / 북쪽 / 위쪽
Gazebo 기체 축 FLU · 앞쪽 / 왼쪽 / 위쪽
ArduPilot 기체 축 FRD · 앞쪽 / 오른쪽 / 아래쪽
ArduPilot 항법 축 NED · 북쪽 / 동쪽 / 아래쪽
ROS 운동 단위 m · s · m/s · rad/s · m/s² · N

자동조종 연결 경계에서 좌표계를 변환합니다. 시뮬레이션 설정값이 제조사의 운항 시간, 내압 수심이나 센서 정확도를 보장하지는 않습니다.

자료 출처

문서 검색