시뮬레이션·렌더링·센서 구조
WWW-POSIM이 작업공간을 조정하고 POSIM·Gazebo가 물리와 센서를 계산합니다. 브라우저 또는 네이티브 뷰어가 결과를 표시합니다.
처리 흐름
- 1. 지형 검증과 세션 준비
스키마·엔진 및 라이브러리 호환성·필수 자료를 확인합니다. 배치 위치를 변환·검사하고 세션별 월드와 로봇 SDF를 준비하며 nonce로 인스턴스를 구분합니다.
- 2. Gazebo·제어기 시작
모델 질량·관성·충돌·관절·환경 시스템을 불러옵니다. ArduPilot, ROS 2 직접 제어 또는 자동 항해 명령 경로를 선택합니다.
- 3. 명령 → 물리 적분
구동력·부력·유체력·파도·접촉을 적용합니다. Gazebo가 시뮬레이션 시간을 진행하며 위치·자세·속도를 계산합니다. 화면 애니메이션이 물리를 구동하지 않습니다.
- 4. 상태 → 센서·ROS 2
설정한 센서 메시지를 만들고 브리지·앱 서비스로 상태를 전달합니다. 카메라·GPU LiDAR 렌더링은 계속 Gazebo와 그래픽 실행 환경에 의존합니다.
- 5. 작업 화면·RViz 표시
브라우저는 엔진 상태와 지형을 그리며 Gazebo 모드는 엔진 장면 영상을 전달합니다. 웹 RViz는 세션별 ROS 연결·레이아웃으로 Lichtblick을 열고 설치형 앱은 번들 네이티브 RViz를 실행합니다.
- 6. 관찰 → 범위 확장 또는 복구
시작·토픽과 TF·장면 영상·진행을 각각 확인합니다. 이동 전에 검증한 지형을 준비합니다. 부동 원점 이동 시 물리 속도를 보존하면서 목표·추종 항적을 같은 기준으로 변환합니다.
기술 구성 목록
| 기술 | 담당 기능과 인터페이스 | 상세 목록 |
|---|---|---|
| POSIM-Terrain·지리 라이브러리 | WGS 84·투영 수치 지형, 래스터·해안선 결합, 메시와 출처입니다. | 지형 생성 과정과 알고리즘 |
| Gazebo + Wave Sim | 강체·접촉, 추진력, 부력·항력과 주기적 파도입니다. | 해양 동역학과 렌더링 |
| POSIM·Gazebo 센서 | 렌더링, 운동 상태 기반 측정, 음향 계산, 보정 좌표계와 유효성입니다. | 센서 구현과 파라미터 |
| POSIM-Routing·POSIM-Control | 지형 여유, 제한된 경로 탐색, 네이티브 항해 추진과 운동 정책입니다. | 경로 계획과 제어 알고리즘 |
| ArduPilot SITL·MAVROS | 비행제어기 모드·항법 추정, MAVLink/ROS 변환과 구동기 연결입니다. | GNSS와 항법, 설치형 작업공간에서 제어 |
| Ogre2·Three.js | 엔진 장면·센서 렌더링과 브라우저 장면 렌더링입니다. 물리 상태를 받아 서로 다른 경로로 그립니다. | 수중 렌더링, 아래 전송 목록 |
| POSIM-SLAM | 선택한 입력·외부 파라미터·제공자가 필요한 센서 기반 추정·매핑 구성 요소입니다. | 오도메트리·참값과 연구 기록, 공개 라이브러리 |
| WWW-POSIM 래퍼 | 계정·세션, 월드 조합, 연결 권한, 타일 수명, 뷰어 UI와 설치형 배포입니다. | 구성 요소와 라이브러리 |
공개 라이브러리 목록은 재사용 가능한 구현을 설명합니다. 실제 앱 구성에는 선택한 플러그인 바이너리, 일치하는 SDK, 기체 조합과 메시지 연결도 필요합니다. 센서 선택 규약이나 녹화된 SLAM 시연만으로 모든 설치 패키지에서 추정기가 실행된다고 볼 수 없습니다.
시계·좌표계·자료 식별
| 규약 | 연구에서 중요한 이유 |
|---|---|
| 시뮬레이션 시계·실제 시계 | 물리·센서 획득은 시뮬레이션 시간, 입장·연결 만료·일부 감시는 실제 경과 시간을 사용합니다. 처리량·지연 측정에는 둘 다 기록하세요. |
지형 map·기체 FLU |
지리 지형을 지역 미터 좌표계로 투영합니다. 기체 축은 전·좌·상방이며 센서 외부 파라미터가 장착을 연결합니다. |
| 카메라 광학·FCU 좌표계 | 영상은 우·하·전방 축입니다. ArduPilot 연결은 ENU/FLU를 NED/FRD로 바꾸며 GNSS 항법에는 별도 FCU 지도 원점이 있습니다. 축 이름만 바꾸지 말고 변환을 보존하세요. |
| 세션·구성 식별 | 세션 nonce는 실행을, 센서 명세·지형 식별자·라이브러리 리비전은 구성을 구별합니다. 새 실행에 다시 연결할 때는 현재 토픽·권한이 필요합니다. |
| 초기화·원점 이동 | 초기화는 측정 시간축을 바꿉니다. 좌표 원점 평행이동은 물리 속도를 유지합니다. 연구 로그에서 둘을 구별해야 합니다. |
| 참값·관측·추정 | Gazebo 자세는 기준, 카메라·GNSS·DVL은 관측, FCU·SLAM 자세는 추정입니다. 토픽 출처를 구분하고 추정기가 참값으로 직접 받은 신호를 독립 평가 기준으로 삼지 마세요. |
렌더링과 측정의 경계
Browser 장면은 Three.js로 지형과 기체 상태를 그립니다. 이를 선택해도 카메라·GPU LiDAR 생성은 Gazebo에 남습니다. Ogre2는 엔진 화면과 렌더링 기반 센서를 그립니다. 따라서 충돌 형상이 같아도 시각 LOD, 센서 가시성 마스크, 렌즈 위치, 수면 재질과 클리핑에 따라 관측이 달라질 수 있습니다.
소나 광선 형상, RGB 색상과 깊이는 별도 출력입니다. RGB 전용 장식은 음향 형상에서 제외할 수 있습니다. 화면의 점군은 단일 광선·깊이 관측일 수 있으며 누적·자세 보정에는 실제 실행 중인 매핑 과정이 필요합니다. 음향 처리 기술 목록와 센서 구현과 파라미터에서 출력의 의미를 구분합니다.
영상·센서 전달 경로
- Gazebo → 관측값과 렌더링
물리 상태·센서 메시지·카메라 픽셀을 엔진 호스트에서 생성합니다. 브라우저 장면은 받은 상태를 별도로 그립니다.
- 앱 → 연결 권한 → 시뮬레이터 게이트웨이
웹사이트가 계정·세션과 접속 주소를 준비합니다. 공개 데모 데이터는 별도 시뮬레이터 주소로 직접 전달됩니다. 개인 영상·RViz도 호스트가 직접 연결 기능을 제공하면 세션 범위의 임시 권한을 사용합니다.
- 뷰어 → 버퍼·수신 시각 → 표시
영상은 재생 버퍼를, 메시지는 토픽별 시각과 수신 상태를 사용합니다. 연결 중·오래됨을 구분하고 현재 센서 시각과 물리 배율을 확인합니다.
| 화면·인터페이스 | 형식과 동작 |
|---|---|
| 공개 LIVE·홍콩 데모의 Gazebo 장면 | 공유 H.264 HLS 영상. 짧은 영상 조각을 직접 미디어 서버에서 받고 재생 버퍼를 사용합니다. |
| 홍콩 데모 RGB 센서 | 공유 H.264 HLS. 선택 후 연결 중 상태를 표시하며 버퍼가 준비되면 재생합니다. |
| 개인 장면·카메라 패널 | Gazebo JPEG 프레임 요청. 지원 호스트에서는 임시 권한으로 직접 수신하며 로컬 앱은 로컬 서비스를 사용합니다. |
| ROS 압축 카메라 | JPEG CompressedImage · 표준 연결은 시뮬레이션 시간 기준 최대 1 Hz. 동영상 HLS와 별개입니다. |
| RViz Web·외부 ROS 뷰어 | ROS 메시지 WebSocket. RViz Web은 읽기 전용이며 설치형 작업공간에서 제어를 적용합니다. |
Vercel은 웹 화면과 짧은 연결 설정 요청을 제공할 수 있지만, 공개 데모의 지속적인 영상·토픽 전달은 Vercel 함수로 중계하지 않습니다. 개인 작업공간의 직접 연결 여부는 호스트가 알리는 기능에 따릅니다. 연결 주소에 포함된 임시 권한은 공유하지 마세요. 영상 버퍼 지연과 센서 측정 시각은 다르므로 화면만으로 실시간 제어 지연을 판단하지 마세요.
공개 LIVE는 읽기 전용 방송이며, 요청이 있는 장면마다 인코더 프로세스 하나를 시청자가 함께 사용합니다. 시청 요청은 5초 동안 유효하며 다음 요청으로 갱신됩니다. 요청이 끊긴 장면은 인코더를 종료합니다. 시청하지 않는 장면 카메라는 Gazebo 구독도 해제합니다. 도착 사진은 별도로 필요한 동안만 촬영할 수 있습니다. 물리 계산, 항해와 기체 센서는 계속 동작합니다.
| 영상 | 공유 영상의 목표 설정 |
|---|---|
| 장면, 낮은 화질 | 15 FPS, 최대 640 × 360, 0.6 Mbit/s |
| 장면, 높은 화질 | 15 FPS, 최대 960 × 540, 1.2 Mbit/s |
| 선택한 기체 카메라 | 5 FPS, 너비 최대 640픽셀, 0.4 Mbit/s |
| 시청하지 않는 장면 | 마지막 요청으로부터 5초 후 인코더 종료 |
요청이 있는 장면은 같은 촬영 프레임으로 두 화질의 영상을 만듭니다. 재생기는 사용 가능한 대역폭에 따라 화질을 선택합니다. 느린 연결에서는 낮은 화질로 전환하면서 15 FPS를 유지할 수 있습니다. 기체 카메라와 조작 가능한 공개 데모는 별도의 영상 설정을 사용합니다.
로그인 페이지에서 누구나 LIVE 항해를 시청할 수 있습니다. 지도와 차량 데이터를 포함한 항해 화면의 일부가 보이면 선택한 장면의 연결이 유지됩니다. 항해 화면을 전체 화면으로 열었다가 로그인 화면으로 돌아와도 같은 장면이 이어집니다. 재생을 일시 정지하거나 탭을 숨기거나 닫을 때, 또는 라이브 데모나 웹 작업공간으로 이동할 때 로그인 페이지의 스트림이 중지됩니다. 열려 있고 화면에 보이는 센서 카메라는 별도로 연결을 갱신합니다. 영상과 실시간 메타데이터는 서버에서 직접 수신합니다. LIVE에는 시청 인원 제한이 없습니다. 조작 가능한 데모의 동시 시청 인원은 2명입니다.
첫 영상 버퍼를 준비하는 동안 브라우저는 선택한 장면의 캐시된 JPEG 한 장을 서버에서 직접 받습니다. 운항 상태, 목적지, 실시간 배율과 속도 패널은 위쪽에 계속 보이며, 그 아래 장면 중앙에 연결 안내와 움직이는 표시줄이 나타납니다. 첫 요청은 전체 항해 정보를 기다리지 않고 이미 촬영된 이미지를 읽습니다. 응답의 네이티브 월드 식별자(nonce)를 이후 항해 정보와 대조합니다. 연결 표시줄 아래에는 약 5초의 예상 시간을 안내합니다. 방송 연결이 끊기거나 네트워크가 복구되면 자동으로 다시 연결합니다. 월드나 시점을 바꾸면 이전 미리보기를 버리고, 탭이나 장면이 보이지 않으면 요청을 중단합니다. 실제 영상 재생이 시작되면 미리보기를 지웁니다. 이후 재생이 끊기면 마지막 영상 프레임을 유지하면서 재연결 안내와 표시줄을 표시합니다.
장면 구독은 최신 네이티브 상태가 수신될 때까지 대기합니다. 지형을 준비하는 동안에는 큰 장면 카메라를 깨우지 않고 준비 작업을 진행할 수 있습니다.
장면의 두 화질은 모든 시청자를 위해 각각 한 번씩 인코딩하지만, 네트워크 전송량은 시청자 수에 비례합니다. 40명이 장면과 카메라를 함께 보면 장면 화질에 따라 목표 영상 비트레이트의 합은 40–64 Mbit/s이며 전송 부가 데이터가 더해집니다. 실제 수용 인원은 서버의 업로드 대역폭과 렌더링 성능에 따라 달라집니다. 시청자 수만으로 목표 프레임 속도를 낮추지는 않습니다.
LIVE는 HLS 영상의 최신 지점보다 3초 뒤에서 재생을 시작합니다. 재생이 끊기면 목표 간격을 12초까지 늘릴 수 있습니다. 새로 요청한 LIVE 영상은 2초 길이의 영상 조각 2개와 촬영 시각 보정이 준비되면 재생 준비가 완료되었다고 알립니다. 약 4초의 영상 준비와 카메라·인코더 시작 시간이 필요합니다. 조작 가능한 공개 데모도 3초 목표로 시작합니다. 장면 계기와 카메라 패널은 영상의 표시 시각을 따릅니다. 실제 촬영부터 표시까지의 지연에는 인코딩과 영상 조각의 준비 시간도 포함됩니다.
카메라 취득 주기는 시뮬레이션 시간을 기준으로 합니다. 물리 실시간 배율이 낮거나 취득이 멈추면 실제 시간 기준의 서로 다른 프레임 수가 줄어들 수 있습니다. 영상 메타데이터의 source_fps, source_frames, max_source_gap_seconds는 입력 프레임 전달을 기준으로 계산합니다. HLS 디코더가 표시하는 15 FPS에는 반복 프레임이 포함될 수 있으므로 실제 카메라가 초당 15장을 취득했다는 뜻은 아닙니다.
읽을 때 알아둘 점
지형 준비 완료·세션 실행·카메라 영상 수신은 각각 별도 상태입니다. 백그라운드 영상 갱신은 실행 중 충돌 지형을 바꾸지 않습니다. 충돌은 수치 고도, 위성·모래·수면·지도 겹치기는 시각 계층입니다. 실시간 배율은 시뮬레이션 시간과 실제 경과 시간의 비율입니다.
관련 문서와 구현
구성 요소와 라이브러리 · 지형 생성 과정과 알고리즘 · 경로 계획과 제어 알고리즘 · 커스텀 월드
POSIM 엔진·라이브러리 안내. WWW-POSIM은 세션 수명 주기·전달·뷰어 실행을, Terrain·Routing·Control은 해당 알고리즘을 담당합니다.
소나 미리보기
물리 기반 소나 미리보기에서 물체 세 개를 사용한 기록 실험과 거리·방위각 비교 영상을 읽는 방법을 확인하세요.