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