仿真、渲染与传感器架构
WWW-POSIM协调工作区,POSIM和Gazebo计算物理与传感器,浏览器或查看器显示结果。
处理流程
- 1. 验证地形并准备会话
检查数据格式、引擎/库兼容性及所需资源。转换并验证初始位姿,准备会话专用世界和载具SDF,以nonce标识本次运行。
- 2. 启动Gazebo与控制器
加载质量、惯性、碰撞体、关节和环境系统,选择ArduPilot、ROS 2直接控制或自动航海通路。
- 3. 指令 → 物理积分
施加执行器力、浮力、水动力、波浪与接触。Gazebo推进仿真时间并计算位姿、速度;显示动画不会驱动物理。
- 4. 状态 → 传感器与ROS 2
生成已配置的传感器消息,通过桥接和服务提供状态。相机与GPU LiDAR仍依赖Gazebo及其图形环境。
- 5. 工作区与RViz
Browser绘制接收的状态和地形,Gazebo模式传输引擎渲染图像。RViz Web打开带会话连接和布局的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 | 依赖匹配输入、外参和提供程序的估计与建图。 | 传感器模型与参数 · POSIM-SLAM |
| WWW-POSIM | 账号、会话、世界组装、临时授权、瓦片生命周期、查看器和安装包分发。 | 组件与库 |
公共库提供可复用实现。能运行的配置还需要匹配的插件二进制、SDK、模型组合和消息连接。传感器选择项或一段SLAM演示录像,不能证明每个安装包中都已运行估计器。
时钟、坐标系与数据身份
| 约定 | 含义 |
|---|---|
| 仿真时间/实际时间 | 物理与采样使用仿真时间;准入、连接到期及部分看门狗使用实际时间。评估吞吐或延迟时记录两者。 |
地形map/机体FLU |
地理地形投影到本地米制坐标;机体轴为前/左/上,安装外参将传感器映射到该坐标系。 |
| 相机/飞控 | 相机光学轴为右/下/前。ArduPilot将ENU/FLU转换为NED/FRD,GNSS另有飞控地图原点。应保留变换,而不是仅重命名轴。 |
| 会话/配置 | nonce区分运行,传感器清单、地形身份和库修订版区分配置。新运行需使用当前话题和授权。 |
| 重置/浮动原点 | 重置改变测量时间线;原点平移改变坐标但保留物理速度。研究日志应能识别两种事件。 |
| 真值/观测/估计 | Gazebo位姿为参考;相机、GNSS、DVL为测量;飞控或SLAM位姿为估计。保留话题来源,不要用估计器直接消费的真值来评价同一估计器。 |
渲染与测量边界
Browser通过Three.js绘制场景。选择它不会把相机或GPU LiDAR生成移出Gazebo。Ogre2绘制引擎视图及依赖渲染的传感器。即使碰撞几何不变,视觉LOD、可见性掩码、镜头位置、水体材质和裁剪也可能改变观测。
声呐射线几何、RGB颜色和深度是独立输出。仅用于RGB的覆盖层可排除在声学几何之外。显示的点云可能只是一次射线/深度观测;累积与位姿校正需要明确运行的建图进程。参阅基于物理模型的声呐预览。
视频与传感器传输
- Gazebo → 测量与画面
引擎宿主机产生物理状态、传感器消息和相机像素;Browser独立渲染收到的状态。
- 应用 → 连接授权 → 网关
网站准备账号/会话访问和连接地址。公开数据直接来自独立仿真器源;宿主机声明支持直连时,私有图像与RViz使用范围受限的临时授权。
- 查看器 → 缓冲与数据年龄 → 显示
视频使用播放缓冲,消息保留话题时间戳和接收状态。区分连接中与过期,并检查传感器时间和物理RTF。
| 视图或接口 | 格式与行为 |
|---|---|
| LIVE与香港演示Gazebo场景 | 共享H.264 HLS,短分片直接来自媒体服务器,并使用播放缓冲。 |
| 香港演示RGB相机 | 共享H.264 HLS,初始缓冲就绪前显示连接中。 |
| 个人场景/相机 | Gazebo JPEG帧请求;支持的宿主机使用受限直连,安装版使用本地服务。 |
| ROS压缩相机 | JPEG CompressedImage,标准连接器最高1个仿真Hz,与HLS独立。 |
| RViz Web/外部查看器 | 通过WebSocket传输ROS消息。RViz Web为只读,各话题限制见使用 RViz 和 Foxglove 查看数据。 |
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 没有观众人数限制。交互演示另有两人的限制。
首个视频缓冲期间,浏览器从服务器直接读取该场景已有的缓存JPEG,并检查原生世界nonce。连接提示和动画条位于航海状态、目的地、RTF和速度信息下方。切换世界或视图会丢弃旧预览,隐藏场景则暂停请求。首次播放移除预览;后续卡顿保留最后解码帧并显示重连提示。
场景订阅等待新鲜原生遥测。准备地形无需唤醒全尺寸场景相机。编码虽共享,网络流量仍随观众增加:40名观众同时观看场景和相机时,目标合计40~64 Mbit/s,尚未计入传输开销。实际容量由上行带宽和渲染性能决定,人数本身不会降低目标帧率。
缓冲与真实帧率
LIVE初始目标落后HLS直播边缘3秒,卡顿时可增加至12秒。新视频流准备好2个2秒分片并校准采集时钟后标记就绪,约需4秒加上采集和编码器启动时间。交互演示也从3秒目标开始。仪表和摄像头遵循视频显示时钟;总延迟包含编码和分片准备时间。
仪表和相机面板跟随视频呈现时钟。采集到显示的延迟还包含编码与分片可用时间,缓冲目标本身不是总延迟测量值。
相机按仿真时间采集。物理RTF较低或采集停顿会减少每个实际秒中的不同画面。source_fps、source_frames和max_source_gap_seconds由源帧提交记录生成。解码器报告15 FPS时可能包含重复帧,不能证明每秒采集了15幅新图像。
解读与职责
地形准备完成、会话运行和相机数据新鲜是不同状态。后台影像刷新不会改写运行中的碰撞数据。网格高程决定接触,卫星、沙地、水体和地图属于视觉层。RTF比较仿真时间与实际时间。
WWW-POSIM负责会话、传输和查看器启动;Terrain、Routing、Control负责各自算法。POSIM引擎与库指南。
组件与库 · 地形生成流程与算法 · 路径规划与控制算法 · 自定义世界 · 基于物理模型的声呐预览