구성 요소와 라이브러리
WWW-POSIM은 오픈소스 시뮬레이션·알고리즘 라이브러리에 비공개 앱 코드를 더해 웹 작업공간, 설치형 앱과 서비스 엔드포인트를 제공합니다.
WWW-POSIM을 구성하는 요소
오픈소스 구성 요소
- POSIM시뮬레이션 엔진·해양 모델·센서
- POSIM-Terrain지리 좌표 기반 지형·메시·영상
- POSIM-Routing항법과 지형을 검사하는 경로 계획
- POSIM-Control추진 제어와 운동 정책
- POSIM-SLAM센서 기반 상태 추정·지도 작성 라이브러리
비공개 앱 구성 요소
- 작업공간과 화면 전달브라우저 UI·장면 보기·영상 스트리밍
- 계정과 세션로그인·권한·사용량 제한·대기열
- 월드와 저장 자산준비 작업·차량 라이브러리·저장소
- 항해 운영방문 일정 상태·체크포인트·복구 조정
- 설치형 앱 통합실행 창·실행 환경 준비·패키징
POSIM
POSIMPOSIM-Terrain
POSIM-TerrainPOSIM-Routing
POSIM-RoutingPOSIM-Control
POSIM-ControlPOSIM-SLAM
POSIM-SLAMWWW-POSIM
WWW-POSIM — 접근 권한이 필요한 비공개 저장소
비공개 구성 요소는 WWW-POSIM 앱 저장소에 속합니다. 공개 라이브러리를 사용자 계정, 저장된 작업공간과 앱 인터페이스에 연결합니다. 사용할 수 있는 센서와 추정 모드는 설치된 실행 환경과 처리 모듈에 따라 달라집니다.
구성 요소별 문서
| 구성 요소 | 사용 안내 | 기술문서 |
|---|---|---|
| 지형 | 원하는 지역의 지형 만들기 | 지형 생성 과정과 알고리즘 |
| 경로 계획·제어 | LIVE 세계 항해, 설치형 작업공간에서 제어 | 경로 계획과 제어 알고리즘 |
| 엔진·앱 | 작업공간 익히기, 커스텀 월드 | 시뮬레이션·렌더링·센서 구조 |
지형 라이브러리는 수치 지형·영상·메시를 만듭니다. 실행 중 타일 적재, 지형 LOD: 차량 가까이는 자세하게, 충돌 준비 상태와 세션별 캐시는 WWW-POSIM이 조정합니다. 공개 라이브러리가 있다는 것과 현재 호스트에 실행 가능한 센서·SLAM 공급자가 설치되어 있다는 것은 구분해야 합니다.
기술문서는 해양 로봇 연구를 위한 기술 목록입니다. 해양 동역학과 렌더링, 센서 구현과 파라미터, 지형 생성 과정과 알고리즘, 경로 계획과 제어 알고리즘, 시뮬레이션·렌더링·센서 구조, 물리 기반 소나 미리보기, GNSS와 항법에서 모델, 설정, 출력과 해석 범위를 구분합니다.
공개 라이브러리
| 라이브러리 | 사용과 구조 |
|---|---|
| POSIM | Gazebo 기반 시뮬레이션 엔진·해양 환경·차량 모델·센서 |
| POSIM-Terrain | Python 지리 표본 추출·육지/해저 자료 선택·메시/SDF 출력·시각 텍스처 |
| POSIM-Routing | Python 전역·해안·로컬 경로 계획기, POSIM-Terrain 사용 |
| POSIM-Control | Python 운동 정책과 C++ Gazebo 선행/추종 추진 플러그인 |
| POSIM-SLAM | 독립적인 시각·음향·관성 상태 추정 라이브러리; 앱 기능에는 해당 센서와 처리 모듈 필요 |
POSIM-Terrain
POSIM-Terrain은 지리 좌표로 육지와 해저 형상을 만듭니다. 사용 가능한 고도·수심 자료를 결합합니다. 수치 지형은 메시와 경로 충돌 검사에 사용하고, Sentinel-2 영상은 육지 텍스처에 사용합니다.
- 입력: 위도·경도·지역 크기·격자 표본 수
- 출력: 수치 고도·메시·SDF·텍스처·자료 출처 기록
- 직접 사용: 지역 지형 생성 또는 도시 지형 묶음 불러오기
설치, 위성 텍스처 준비와 출력 명령은 지형 라이브러리 README를 참고하세요.
POSIM-Routing
POSIM-Routing은 항구 방문 순서와 각 항구의 도착 수역까지 이어지는 항로를 계획합니다. 항구 연결에는 OSM 육지 경계를 사용합니다. 해안·로컬 계획기는 수치 지형을 검사해 경로를 선택합니다. 항구 목록의 위치와 실제 도착 수역은 별도 입력입니다.
- 입력: 출발지·목적지·필수 통과점·수치 지형
- 출력: 전역 항로·해안 통로·로컬 경유점
- 직접 사용: 해상 항로 출력 또는 생성한 지형에서 경로 계획
항로 명령과 계획기 API는 경로 라이브러리 README를 참고하세요. 전역 항로만으로 수심을 확인할 수는 없습니다.
POSIM-Control
POSIM-Control은 Gazebo 차량 모델에 추진력을 가합니다. 선행 차량은 지정된 경유점을 따라가고, 추종 차량은 선행 차량의 실측 위치를 따라갑니다. Python 정책은 실측 운동으로 속도 제한을 정하고 안정성, 항해 진행 상태와 복구 필요 여부를 판단합니다.
- 입력: 검사한 경유점·요청 속도·차량 실측 상태
- 출력: 추진 명령·제어기 상태·운동 정책 판단
- 직접 사용: Python 정책 사용 또는 네이티브 선행/추종 플러그인 빌드
모델 요구 사항, 플러그인 빌드와 제어 토픽은 제어 라이브러리 README를 참고하세요. 네이티브 플러그인은 POSIM 실행 환경의 Gazebo 개발 패키지가 필요합니다.
각 라이브러리에 한국어·영어 사용법, 소스 구조, 설치 명령과 시험이 있습니다. WWW-POSIM은 엔진과 라이브러리의 Git 서브모듈 커밋을 지정합니다. 실행 어댑터가 해당 구현을 가져오며 패키지에도 지정된 소스 패키지를 포함합니다.
git submodule update --init --recursive
웹사이트와 작업공간 서비스가 라이브러리를 연결합니다. 세션 소유권·계정·영상 전달·항해 체크포인트·AIS 표시는 WWW-POSIM에 속합니다.
함께 동작하는 방식
POSIM-Terrain이 지형 데이터를 만듭니다. POSIM-Routing은 그 지형으로 경로를 계획하고 검사합니다. POSIM-Control은 승인된 경유점을 따라가도록 제어하고, Gazebo가 물리 운동을 계산합니다. WWW-POSIM은 실측 상태를 확인해 다음 지형·경로·제어 갱신을 조정합니다.
웹 작업공간과 설치형 앱은 같은 커밋의 구현을 사용합니다. POSIM 모델·센서·엔진 설정은 POSIM 라이브러리 안내를 참고하세요.
도시 지형 예제
POSIM-Terrain 예제에 뉴욕·부산·도쿄가 있습니다. 각 지역은 육지와 해저를 함께 포함합니다.
- 지역 크기: 20 × 20 km
- 수치 격자: 257 × 257 꼭짓점
- 격자 간격: 78.125 m
- 자료: GEBCO 2026·Copernicus GLO-30·이용 가능한 지역 수심 자료
묶음에는 메시·SDF·수치 배열·Sentinel-2 육지 텍스처·출처 기록이 있습니다. 도시별 Gazebo 3D 월드 캡처도 제공합니다. README에서 재생성 방법을 확인할 수 있습니다. 출력 격자 간격은 원자료의 측정 정확도를 높이지 않습니다. 자료의 가정은 지형 생성 과정과 알고리즘을 참고하세요.
Mac 네이티브 엔진은 Apache-2.0 라이선스의 Gazebo Sim Sensors 구성 요소에 로컬 패치를 적용합니다. 수정 소스, 빌드 설정, 패치, 고지와 라이선스는 엔진 내부 www-posim/sources/gz-sim-sensors-stop에 보관합니다. POSIM GNSS 센서는 별도의 MIT 라이선스와 고지를 포함합니다.