组件与库
WWW-POSIM 将开源仿真与算法库和私有应用代码结合,提供网页工作区、桌面应用及服务 API。
WWW-POSIM 的组成
开源组件
- POSIM引擎、海洋模型与传感器
- POSIM-Terrain地理地形、网格与影像
- POSIM-Routing导航与已检查的路径规划
- POSIM-Control推进与运动策略
- POSIM-SLAM基于传感器的估计与建图
私有应用组件
- 工作区与分发界面、场景视图与视频
- 账号与会话登录、权限、时长与队列
- 世界与已保存资源准备任务、载具库与存储
- 航行协调行程、恢复点与恢复协调
- 桌面集成启动器、运行环境准备与打包
POSIM
POSIMPOSIM-Terrain
POSIM-TerrainPOSIM-Routing
POSIM-RoutingPOSIM-Control
POSIM-ControlPOSIM-SLAM
POSIM-SLAMWWW-POSIM
WWW-POSIM — 私有仓库,需要访问权限
应用把各库连接到账号、持久化工作区和用户界面。可用传感器及估计模式取决于已安装的引擎和提供程序。
按组件查阅文档
| 组件 | 使用方法 | 技术参考 |
|---|---|---|
| 地形 | 生成目标区域的地形 | 地形生成流程与算法 |
| 规划与控制 | LIVE 全球航行、控制桌面版工作区 | 路径规划与控制算法 |
| 引擎与应用 | 熟悉工作区、自定义世界 | 仿真、渲染与传感器架构 |
地形库生成数值地形、影像和网格。WWW-POSIM 管理常驻地形块、细节层级、碰撞就绪状态和会话缓存。库已公开,不代表其可运行的传感器或 SLAM 估计器已经安装在当前主机。
面向海洋机器人研究的技术目录包括 海洋动力学与渲染、传感器模型与参数、地形生成流程与算法、路径规划与控制算法、仿真、渲染与传感器架构、基于物理模型的声呐预览 和 GNSS 与导航。每章分别说明模型、配置、输出及解释结果时的限制。
开源库
| 库 | 功能 |
|---|---|
| POSIM | 基于 Gazebo 的仿真引擎、海洋环境、载具模型和传感器 |
| POSIM-Terrain | Python 地理采样、陆海数据源选择、网格/SDF 导出与纹理 |
| POSIM-Routing | Python 全局、沿岸和局部路径规划器,依赖 POSIM-Terrain |
| POSIM-Control | Python 运动策略与 C++ Gazebo 领航/跟随推进插件 |
| POSIM-SLAM | 独立的视觉、声学和惯性估计库;应用功能需要匹配的传感器及提供程序 |
POSIM-Terrain
组合可用的高程和水深数据,生成陆地与海底几何。数值场用于地形网格和路线碰撞检查,Sentinel-2 影像用于陆地纹理。
- 输入:纬度、经度、区域尺寸和网格采样。
- 输出:高程数值、网格、SDF、纹理和数据源清单。
- 独立使用:生成区域或加载城市地形文件包。
安装、卫星纹理准备和导出命令见 POSIM-Terrain README。
POSIM-Routing
规划港口行程及通往各到达区域的路线。OSM 陆地多边形用于引导港口间连接,沿岸与局部规划器会检查所表示的地形。港口目录坐标和水上到达目标是不同的输入。
- 输入:出发地、目的地、通行门和数值地形。
- 输出:全局路线、沿岸通道和局部航点。
- 独立使用:导出海上航线,或在生成地形上规划路径。
命令与 API 见 POSIM-Routing README。全局路线本身不能证明水深满足要求。
POSIM-Control
为 Gazebo 载具模型施加推进力。领航载具跟踪指定航点,跟随载具跟踪实测的领航位姿。Python 策略根据观测运动限制速度,并评估稳定性、进展和恢复。
- 输入:已检查航点、请求速度和实测状态。
- 输出:推进指令、控制器状态和运动策略决策。
- 独立使用:调用 Python 策略,或编译领航/跟随原生插件。
模型要求、插件编译和控制话题见 POSIM-Control README。原生插件需要配置好的 POSIM 环境及 Gazebo 开发包。
各库包含英文与韩文说明、源码结构、安装命令和测试。WWW-POSIM 以 Git 子模块固定引擎和库的版本。运行适配器导入这些实现,打包时也包含选定的源代码。
git submodule update --init --recursive
协作流程与城市示例
POSIM-Terrain 生成地形,POSIM-Routing 规划并检查路径,POSIM-Control 跟踪已批准航点,Gazebo 计算物理运动。WWW-POSIM 观测结果,协调后续地形、路线和控制更新。账号、会话所有权、视频分发、航行恢复点和 AIS 显示由应用负责。
网页版和桌面版使用相同的固定版本。模型、传感器和引擎设置见 POSIM 库指南。
POSIM-Terrain 示例包含纽约、釜山和东京,每个区域均包含陆地和海洋:
- 区域:20 × 20 km。
- 数值网格:257 × 257 个顶点,间距 78.125 m。
- 数据源:GEBCO 2026、Copernicus GLO-30 及可用的区域水深数据。
- 文件:网格、SDF、数值数组、Sentinel-2 陆地纹理和数据源清单。
- 每个城市提供 Gazebo 画面及重新生成所需的 README。
缩小输出网格间距不会提高源数据的测量精度。参见 地形生成流程与算法。
Mac 原生引擎包含本地修改的 Gazebo Sim Sensors 组件,采用 Apache-2.0 许可。修改后的源码、构建流程、补丁、声明和许可证保存在引擎内的 www-posim/sources/gz-sim-sensors-stop。POSIM GNSS 传感器另附 MIT 许可证和声明。