WWW-POSIM v0.6.16仿真器文档
文档菜单
WWW-POSIM / 仿真器文档

地形生成流程与算法

数值高程和水深决定地形形状。OpenStreetMap 提供陆地掩膜,Sentinel-2 提供陆地颜色。几何、海岸线与影像各司其职。

处理流程

  1. 1. 目标区域 → 米制网格

    以 WGS 84 中心点建立局部方位等距投影(AEQD)。采样 N × N 个点,x 向东、y 向北、z 向上。网格间距 = 宽度 / (N − 1)。

  2. 2. 高程与水深

    以 GEBCO 为基础插值,陆地补充 GLO-30。逐个水域顶点选择有效的区域水深:优先使用获授权的 Cesium 数值数据,再按原始网格间距选择其他来源。

  3. 3. OSM 陆地多边形

    读取 OSM 衍生的 Shapefile,检查 EPSG:4326,裁剪为 0.05° 图集单元,合并多边形并保存 land.json。海岸线不从卫星图像颜色推断。

  4. 4. 经验证的卫星图集

    通过 STAC 查询近期 Sentinel-2 L2A 影像。检查 RGB 和场景分类,仅接受局部无效像元占比不超过 5% 的影像,其中包括云和云影。记录获取时间与哈希值。

  5. 5. 将海岸线应用于数值地形

    Shapely 判断顶点是否位于陆地多边形内。陆地使用有限的 GLO-30 高程,水域使用有数据支持的水深。沿岸修正要求附近存在实测水深。不完整的候选数据被拒绝,并记录替代来源。

  6. 6. 碰撞与显示网格

    对采样网格进行三角剖分,生成碰撞几何;另生成完整和简化的显示网格,保留边界及沿岸过渡。用 UV 坐标铺设陆地影像,在海底重复铺设沙地纹理。动态水面单独渲染。

  7. 7. 验证、保存并就绪

    导出 SDF、网格、数组和来源信息,再运行 gz sdf -k。含陆地的自动生成区域等待影像验证通过。完整资源进入缓存,失败则显示错误。取消会终止任务并清理未完成的数据。

  8. 8. 移动、LOD 与覆盖范围

    按需加载世界根据载具所在瓦片选择显示细节。提前准备后续瓦片、验证碰撞几何并替换显示网格。完整碰撞网格保持不变,返回时复用已保存的几何。

LOD:保留载具附近的细节

细节层次(LOD)用于简化远处的显示几何。按需加载世界依据载具所在瓦片调整 LOD,与相机缩放无关。陆地与海底都适用。

五乘五瓦片范围:中央九块的显示步长为一,外围为四。所有碰撞网格保留完整采样。
个人工作区的覆盖范围。LIVE 使用更大的外围范围,两者都保留中央 3×3 瓦片的完整显示细节。
范围 方法
近处 3×3 瓦片,显示步长 1,使用每个数值顶点。
远处 步长 4,内部每轴每四点选一点;保留所有边界点及海岸、浅水过渡单元。再用 Delaunay 三角剖分连接,因此不是均匀的 33×33 网格,三角形数量也不一定恰好减少为十六分之一。
纹理 远处陆地和浅水纹理的宽、高分别降至四分之一,最小 32 像素。所有瓦片共享重复铺设的海底纹理。
移动 进入新瓦片时,中央区域随载具移动。接近的瓦片增加细节,远离但仍驻留的瓦片降低细节。
物理与路线 完整数值数据和碰撞网格不变。共享边界采样避免不同细节层次之间出现缝隙。

依赖渲染的传感器会观测所选显示网格。保留完整碰撞网格并不保证两种 LOD 的远处图像完全相同。检查目标时,应将其保持在高细节区域内,并查看实际传感器输出。

替换期间,旧显示对象会保留到新对象被确认。如果确认超时,但近期原生位姿仍能确认旧对象存在,就保留原细节层次,30 秒后重试。失败的候选对象会先删除,并确认已消失,再进行下一次尝试。清理失败仍按错误处理。

新瓦片的碰撞几何只创建一次。显示确认最多尝试三次。只有通过显示、水深和接触检查,瓦片才会被接纳;覆盖不足时载具继续等待。

地形模式

模式 网格与显示策略
固定自定义区域 1×1 km,513×513 个采样点,约 1.95 m 间距。没有随载具移动的 LOD。
预生成 KMOU、纽约、香港 中央均为 513×513 点:KMOU 为 1×1 km,另外两处为 2×2 km。周边 6×6 km 使用独立实测网格、完整碰撞几何和固定简化显示。KMOU 还有中央过渡环带。接近这些外围区域时不会自动恢复更高显示细节。
个人按需加载世界 1 km 瓦片,129×129 点,间距 7.8125 m。要求覆盖 5×5,中央 3×3 步长为 1,外圈为 4。
LIVE 要求覆盖 7×7,中央高细节区域同样是 3×3。近期使用或预加载的瓦片可能使实际驻留范围更大。

LOD 自动调整,没有手动滑块。准备与使用方法见生成目标区域的地形和LIVE 全球航行。

地理空间技术

技术 输入、方法与输出
局部投影 PyProj 将 WGS 84 转换为以目标区域为中心的 AEQD,始终以经度为第一轴。浮动原点保持当前坐标一致。输出米制 x/y 及记录的基准,与经纬度和 FCU 原点不同。
栅格采样 SciPy 将 GEBCO 子区域和陆地高程插值至目标网格。轴与 NoData 由元数据决定。输出间距、原始分辨率和测量精度是不同概念。
区域数据选择 获授权的 Cesium 数值数据优先。其他来源按原始网格间距排序,逐个有效水域顶点采用,并保留顶点级来源 ID。仅有影像访问权限不代表能获得数值水深。
沿岸数据支撑 对粗分辨率数据误判为陆地的水域单元,使用附近实测水深、LinearNDInterpolator 及 cKDTree 检查进行重建。最近邻回退限于 1.5 km,KHOA 要求 225 m 以内。不凭空填入固定水深。
陆地掩膜 Shapely 合并 OSM 多边形,进行点面关系及有限高程检查。颜色不决定可航行性。
影像 STAC 选择、场景分类、Rasterio 重投影及独立质量验证。保存获取时间和来源信息。香港预生成区域使用注明来源的航空照片。
几何 三角化碰撞网格,陆地、浅水与海底采用独立材质。LOD 保留边界和海岸。输出 SDF、网格和纹理,分别控制物理与显示负荷。

下载与缓存完整性

沿岸单元在复用前检查更新时间和校验和。缓存完整时无需准备全球海岸线归档;缺失或无效的单元触发更新。

GEBCO 子集使用 SQLite 索引。文件大小或修改时间变化时更新条目,并根据 URL、原始文件 SHA-256 和坐标轴重新验证候选。索引不可用时改为扫描并验证缓存。

区域下载先写入临时文件。若有 Content-Length,收到的字节数必须一致。KHOA NetCDF 必须准确包含 Lat、Lon、MSL,数组非空且末尾元素可读取。通过验证后才写入持久缓存。被拒绝的已有文件会保留用于诊断。

地形物理接触检查

WWW-POSIM 使用朝下的 RGBD 相机和临时测试球体检查每个已加载的地形块。相机测量渲染地形的深度。Gazebo 将球体落到碰撞网格上,并根据新的位姿测量确认接触后,才将该地形块认定为可用区域。

文件与可复现性

文件 用途
projected.npz 及元数据 带坐标基准的 x/y/高程数组,用于与航迹和测量值比较。
manifest.json 及来源信息 边界、采样、来源选择、哈希,以及兼容的引擎与库标识。缓存仅适用于对应组合。
SDF 与碰撞网格 实际接触面及世界组成,截图无法替代。
显示网格、纹理、LOD 复现渲染和视觉传感器,与碰撞精度分开评估。

WWW-POSIM 围绕 POSIM-Terrain 管理生成、预加载、驻留和替换。继续移动前必须确认碰撞几何。资源就绪、物理瓦片加载完成、当前图像可见是不同状态。

所选 POSIM-Terrain 版本由 terrain.py、terrain_sources.py、bathymetry.py、coastal_detail.py、floating_origin.py 和 seabed_visual.py 实现相关处理。来源见 manifest.json 与 source-providers.json。

预生成地形与影像

地形 中心:纬度、经度 影像
KMOU waterfront 35.077175, 129.085815 Sentinel-2
纽约港 40.70044, −74.004885 NYC OTI,2024 年
香港港 22.2899, 114.168169 Lands Department,2018 年 10 月/2019 年 1 月

各中央区域都有 513×513 个采样点;2 km 范围对应约 3.91 m 间距。周边 6×6 km 由 3×3 块 2 km 瓦片组成,采用实测高程、水深和简化显示。KMOU 另有过渡环带。WAM-V 演示使用同一香港地形。

纽约和香港的中央纹理为 4096×4096,约 49 cm/像素。原始影像分辨率分别为 6 英寸和 20 cm。更清晰的图像不会提高水深精度。自动生成使用 Sentinel-2。

纽约影像遵循 NYC OTI 的 CC BY 4.0。香港影像来自香港特别行政区政府地政总署/CSDI 门户,图幅 T11-SW-B,于 2023 年发布。影像经过裁剪、重投影和重采样,来源说明随下载提供。

含陆地的自动世界会等待影像验证。获取失败时,请恢复访问后重试。已保存但没有影像的区域需要重新生成。纯水域无需陆地图像也可完成。Browser 与 Gazebo 共用陆地颜色,不改变碰撞几何。练习使用各自的平面场地。

就绪、取消与重试

下载显示文件名、已接收量与总量、百分比和速度。总量未知时显示已接收量与速度。停止会终止任务和下载,已完整获取的源文件仍可复用。

下载后的预生成区域保持可用。“就绪”描述的是资源状态;启动后还应确认近期位置与传感器数据。缺失文件或引擎不兼容时,按提示下载或重新生成。选择已保存区域并启动对应世界,才能看到它。

在应用中使用停止,网页准备阶段使用取消。等待清理结束后再重试或切换世界。准备任务、服务器名额和运行中的世界分别管理。若看不到海岸,请缩小世界视图,打开地图并检查海底及地图叠加层。

数据来源与显示效果

来源 作用
Cesium World Bathymetry 配置了获许可的数值访问后优先使用。
Copernicus Marine 详细的区域沿岸水深。
EMODnet 区域水深,主要覆盖欧洲。
KHOA 可选的韩国水深数据。
GEBCO 全球高程与水深的基础及回退来源。
Copernicus GLO-30 沿岸陆地高程。
OpenStreetMap 陆地与水域边界。
Sentinel-2 RGB 陆地颜色,标称分辨率 10 m。

覆盖范围和访问条件见 Cesium、Copernicus Marine、EMODnet 和 GEBCO。界面会标明实际使用的数据源。

经验证的海岸线和晴空影像用于细化地形。陆地采用 GLO-30,水域采用有测量支撑的水深。修正后的高程共同用于渲染、碰撞、传感器和路线。水深未知区域不参与路线规划;无法有效细化时继续使用可用的数值来源。

影像可独立于沿岸细化应用。启动时验证可用图像,完整缓存存放在 data/providers。按需扩展时会在后台重试缺失图像,验证后显示,不改变数值地形或碰撞几何。

按需世界从 1×1 km 开始,准备邻近瓦片直至满足覆盖要求。近期瓦片会保留,实体依次添加或移除,缺失瓦片继续重试。进入没有经验证碰撞几何或传感器覆盖的区域前,会暂停控制指令。边界共享采样,返回时重新加载保存的几何。固定区域仍为 513×513 点。LIVE 沿岸距离见LIVE 全球航行。

海底沙地与线条

沙地初始开启,线条初始关闭。可在场景 → 场景渲染 → 水下外观中修改,对 Gazebo 和彩色相机生效。

沙地使用 Rob Tuytel 的 Aerial Beach 01,许可为 CC0。2K 颜色、法线与粗糙度贴图每 30 m 重复。这是可离线使用的通用沙地外观;几何和水深由数值高程决定。

源数据分辨率、网格间距、LOD 和图像分辨率不同。更细的网格无法补出缺失测量,狭窄的沿岸地形仍可能无法分辨。

生成目标区域的地形 · 路径规划与控制算法 · 仿真、渲染与传感器架构

生成海底材质图集

下载并解压生成器与材质ZIP。也可单独下载Python脚本。需要Python 3.10或更高版本、NumPy和Pillow。在解压后的目录运行以下命令。

python -m pip install numpy pillow
python generate_seabed_materials.py --materials materials --output output --bounds -3000 -3000 3000 3000 --seed 321 --region-m 240 --detail-m 4 --size 1024 --green-zones materials/kmou-green-zones.json

生成器在世界坐标中混合八种材质:红色植被、密集红色与绿色植被、蓝色海底,以及混合、白色和黑色岩石。使用相同seed可使独立生成的相邻区域保持连续分布。这些是合成颜色纹理,不会增加植物高度、岩石几何、碰撞体或实测水深。

示例以1024 × 1024像素覆盖6 × 6 km,约为5.86 m/像素。这是总览分辨率,无法分辨细小植被和石块。bounds使用向东、向北的局部米制坐标,而非经纬度。图像顶行对应最大的北向坐标。

新输出目录包含albedo.png和记录范围、设置及哈希的manifest.json。已有目录会被拒绝。--tile-m可划分区域,此时--size表示每块瓦片的像素尺寸。全部瓦片默认上限为67,108,864像素。超出时缩小范围或降低分辨率,或检查内存和存储空间后明确设置--max-total-pixels。失败输出会留下INCOMPLETE.txt。

指定--green-zones materials/kmou-green-zones.json后,新增的深海绿色材质集中在KMOU三艘沉船的占地范围周围。JSON为每个区域定义局部x/y、core_m、fade_m和strength。未指定时,独立生成器不会推断沉船位置。--region-m 240形成较大的主导区域,在边界混合相邻材质,避免细碎彩色拼贴。复现时请同时保留生成器版本、输入哈希和seed。

绿色为主的周边是研究RGB识别困难场景的视觉设计,并不证明声纳性能。物体几何和声纳设置是独立因素,需要比较实际相机与声纳观测。

生成器输出预览,展示生成的颜色图集,并非地形界面截图或原生传感器图像。
生成器输出预览,展示生成的颜色图集,并非地形界面截图或原生传感器图像。
搜索文档