feat: finalize Kyushu S-52 0.4.12 release
This commit is contained in:
OpenAI Codex
270
docs/报告/CM95_S52_0.4.12_OpenCPN覆盖与危险物修复报告_v1.md
Normal file
270
docs/报告/CM95_S52_0.4.12_OpenCPN覆盖与危险物修复报告_v1.md
Normal file
@@ -0,0 +1,270 @@
|
||||
# CM95 S-52 0.4.12 OpenCPN 覆盖与危险物修复报告 v1
|
||||
|
||||
日期：2026-09-20
|
||||
|
||||
## 1. 结论
|
||||
|
||||
CM95 九州 S-52 0.4.12 已完成新的全量 PBF 生产、Source→PBF presentation conservation 审计、release finalize、release-scoped S-52 style 编译、runtime capability 审计以及实际浏览器回归。
|
||||
|
||||
正式 Release：
|
||||
|
||||
`cm95-d1-62a85bd40d3a-57e72826db1d`
|
||||
|
||||
Builder Contract：
|
||||
|
||||
`cm95pbf-builder/0.4.12-opencpn-cm93-coverage`
|
||||
|
||||
Production Pipeline：
|
||||
|
||||
`cm95pbf-production/2.3-opencpn-cm93-coverage`
|
||||
|
||||
Plan ID：
|
||||
|
||||
`57e72826db1d3e3e69f0b3b084bef4fb9469b5edc47dc0030fc2ec3e46adecf9`
|
||||
## 2. 本阶段修复
|
||||
|
||||
### 2.1 M_COVR 语义
|
||||
|
||||
Builder 的 coverage 选择改为与 OpenCPN CM93 quilt 语义一致：
|
||||
|
||||
- 只有显式 `M_COVR` / `chart_coverage` 几何可以定义有效 chart coverage；
|
||||
- 不再在 cell 缺少 M_COVR 时，把 `chart_cell bbox` 当成 coverage；
|
||||
- 避免空或不完整的高细节 cell 用整个索引 bbox 错误遮挡较粗尺度内容；
|
||||
- 独立 Source→PBF 守恒审计器同步采用同一 coverage 语义，避免 audit scope 与 Builder 分叉。
|
||||
|
||||
### 2.2 FSHHAV → FSHFAC
|
||||
|
||||
按 OpenCPN CM93 `CreateS57Obj()` 的类替换规则：
|
||||
|
||||
`FSHHAV → FSHFAC`
|
||||
|
||||
修正 Delivery mapping：
|
||||
|
||||
- FSHHAV AREA → `fixed_fishing_gear_area`
|
||||
- FSHHAV POINT → `s52_points`
|
||||
- 保留 S-52 `FSHHAV02` area pattern / dashed line；
|
||||
- 保留 S-52 `FSHHAV01` point symbol；
|
||||
- 不再把 FSHHAV 错误表达成 `fish_reef`。
|
||||
|
||||
全新 Release 扫描结果：
|
||||
|
||||
- `fixed_fishing_gear_area` 中 FSHFAC occurrence：769
|
||||
- `s52_points` 中 FSHFAC occurrence：4022
|
||||
- 新 FSHFAC layer 中 `fish_reef` occurrence：0
|
||||
|
||||
### 2.3 OBSTRN04 / WRECKS02 点危险物 Runtime
|
||||
|
||||
Web compare 增加 point runtime renderer，读取 PBF 中 mariner-neutral runtime facts，在当前 mariner defaults 下动态选择 S-52 symbol。
|
||||
|
||||
当前支持的 point symbol 包括：
|
||||
|
||||
- `ISODGR51`
|
||||
- `DANGER01 / DANGER51 / DANGER52`
|
||||
- `UWTROC03 / UWTROC04`
|
||||
- `OBSTRN01 / OBSTRN03 / OBSTRN11`
|
||||
- `WRECKS01 / WRECKS04 / WRECKS05`
|
||||
- `LNDARE01`
|
||||
|
||||
OpenCPN `OBSTRN04` 可引用但 chartsymbols 中不存在的 `DANGER53` 继续 fail-closed，不自行创造替代资源。
|
||||
|
||||
当前 OBSTRN/WRECKS runtime capability 定义为 `PREVIEW_ONLY`，因为 point symbol 已实现，但 AREA/LINE 最终 runtime portrayal 仍未完成。
|
||||
## 3. Production 结果
|
||||
|
||||
- planned jobs：5065
|
||||
- PASS：5065
|
||||
- FAILED：0
|
||||
- PBF files：5064
|
||||
- reports：5065
|
||||
- explicit empty tile：1
|
||||
- planned output features：476120
|
||||
- report output features：476120
|
||||
- decoded PBF features：476120
|
||||
- tile footprint contract：PASS
|
||||
- S-52 resource contract：PASS
|
||||
- resource defined：1107
|
||||
- resource active：977
|
||||
- S-52 runtime data contract：PASS
|
||||
- release failures：[]
|
||||
|
||||
Runtime CSP counts：
|
||||
|
||||
- DEPARE01：47516
|
||||
- DEPCNT02：46189
|
||||
- OBSTRN04：45633
|
||||
- SOUNDG02：146728
|
||||
- WRECKS02：909
|
||||
## 4. Multi-LIGHTS 与 Presentation Conservation
|
||||
|
||||
Release finalize 的 multi-light contract：
|
||||
|
||||
- required：true
|
||||
- status：PASS
|
||||
- report multi-light groups：357
|
||||
- PBF multi-light groups：357
|
||||
- report light presentation records：745
|
||||
- PBF light presentation records：745
|
||||
- failure count：0
|
||||
|
||||
0.4.12 最初 finalize 时因版本判断仍只匹配 `0.4.11-s52-multi-light-presentations` 字符串，曾把该 contract 错误标为 NOT_APPLICABLE。
|
||||
|
||||
已修正为使用 `_builder_contract_at_least(..., (0,4,11))`，重新 finalize 后 0.4.12 正确执行 multi-light 硬门槛并 PASS。
|
||||
|
||||
独立 Source→PBF presentation conservation：
|
||||
|
||||
- expected multi-light groups：187
|
||||
- actual multi-light groups：187
|
||||
- expected presentation records：390
|
||||
- actual presentation records：390
|
||||
- missing：0
|
||||
- unexpected：0
|
||||
- signature mismatch：0
|
||||
- tile occurrence presentation drift：0
|
||||
- tile occurrence scope mismatch：0
|
||||
- source resolution failure：0
|
||||
- PBF parse failure：0
|
||||
- failures：[]
|
||||
|
||||
Artifact：
|
||||
|
||||
`build/audits/cm95_s52_kyushu_v4_presentation_conservation.json`
|
||||
|
||||
Manifest 中该 contract 状态：PASS。
|
||||
## 5. Release-scoped S-52 Style
|
||||
|
||||
输出：
|
||||
|
||||
`build/s52_style_compiler_release_57e72826db1d/style.s52.json`
|
||||
|
||||
第一次编译正确发现新 source layer 尚未进入 compiler contract：
|
||||
|
||||
- `SOURCE_LAYER_CONTRACT_GAP: fixed_fishing_gear_area`
|
||||
- AP materialized coverage gap：769
|
||||
- LS materialized coverage gap：769
|
||||
|
||||
这证明 PBF 已有 FSHFAC area presentation facts，但完整 style 尚未消费该新 layer。
|
||||
|
||||
修复：
|
||||
|
||||
`config/s52/cm95_s52_style_compiler_v1.json`
|
||||
|
||||
加入：
|
||||
|
||||
`fixed_fishing_gear_area: fill / line / symbol / text`
|
||||
|
||||
重新编译结果：
|
||||
|
||||
- hard_gate_failures：[]
|
||||
- resource contract：PASS
|
||||
- compiled layers：140
|
||||
- PBF count：5064
|
||||
- feature count：476120
|
||||
- AP gap：0
|
||||
- LS gap：0
|
||||
- style bytes：1549579
|
||||
|
||||
因此 FSHFAC area 不再只是“PBF 有数据”，完整 S-52 style 也已实际消费 AP/LS presentation。
|
||||
## 6. Runtime Capability Audit
|
||||
|
||||
CA 单项：
|
||||
|
||||
- RUNTIME_CA feature count：1276
|
||||
- status：IMPLEMENTED
|
||||
- fidelity：S52_SCREEN_MM
|
||||
- audit：PASS
|
||||
|
||||
Artifact：
|
||||
|
||||
`build/audits/cm95_s52_kyushu_v4_runtime_ca_capability.json`
|
||||
|
||||
完整 Web target strict audit：
|
||||
|
||||
- RUNTIME_CA：IMPLEMENTED
|
||||
- RUNTIME_DEPARE：PREVIEW_ONLY
|
||||
- RUNTIME_DEPCNT：PREVIEW_ONLY
|
||||
- RUNTIME_SOUNDG：PREVIEW_ONLY
|
||||
- RUNTIME_OBSTRN：PREVIEW_ONLY
|
||||
- RUNTIME_WRECKS：PREVIEW_ONLY
|
||||
|
||||
因此 full runtime capability audit 仍为：
|
||||
|
||||
`FAIL — runtime_capability_not_implemented`
|
||||
|
||||
这是预期且正确的严格结果，不影响 Data Release PASS，也不得据此声称当前 Web compare 已实现完整 S-52 runtime parity。
|
||||
|
||||
Artifact：
|
||||
|
||||
`build/audits/cm95_s52_kyushu_v4_web_runtime_capability.json`
|
||||
## 7. 实际浏览器回归
|
||||
|
||||
### 7.1 OBSTRN / WRECKS
|
||||
|
||||
测试位置约：
|
||||
|
||||
`130.277626E, 33.692775N`
|
||||
|
||||
真实 Chrome + MapLibre：
|
||||
|
||||
- Production v4 / 0.4.12 页面已加载
|
||||
- `runtime-preview-hazard-symbols` layer 存在
|
||||
- cm95 source loaded
|
||||
- queryRenderedFeatures：38
|
||||
- 实际出现的 runtime symbols 包括：
|
||||
- DANGER51
|
||||
- UWTROC03
|
||||
- UWTROC04
|
||||
- `leftMap.isStyleLoaded() = true`
|
||||
|
||||
截图：
|
||||
|
||||
`/tmp/cm95_v4_hazard_runtime.png`
|
||||
|
||||
### 7.2 Multi-LIGHTS / CA
|
||||
|
||||
测试位置：
|
||||
|
||||
`130.78248061577605E, 34.09885081506925N`
|
||||
|
||||
实际 runtime 仍得到两条 sector：
|
||||
|
||||
- source record 3077：LITYW，66° → 106°
|
||||
- source record 3078：LITYW，116° → 320°
|
||||
|
||||
Canvas non-transparent pixels：4427。
|
||||
|
||||
因此 0.4.12 coverage / FSHFAC 修正没有破坏 0.4.11 已通过的 multi-LIGHTS / CA 闭环。
|
||||
## 8. 18888
|
||||
|
||||
比较服务器已经切换到：
|
||||
|
||||
`cm95-d1-62a85bd40d3a-57e72826db1d`
|
||||
|
||||
Release-scoped style：
|
||||
|
||||
`build/s52_style_compiler_release_57e72826db1d/style.s52.json`
|
||||
|
||||
页面标识：
|
||||
|
||||
`Production v4 / 0.4.12`
|
||||
|
||||
当前 `/health`：
|
||||
|
||||
- release_status：PASS
|
||||
- pbf_file_count：5064
|
||||
- decoded_pbf_features：476120
|
||||
- s52_runtime_contract：PASS
|
||||
- s52_light_presentation_contract：PASS
|
||||
- s52_presentation_conservation_contract：PASS
|
||||
|
||||
Style / sprite 资源均返回 HTTP 200。
|
||||
|
||||
## 9. 剩余边界
|
||||
|
||||
0.4.12 Data Release 已可正式使用。
|
||||
|
||||
仍未完成的是完整 runtime portrayal，而不是 PBF 数据 release：
|
||||
|
||||
- DEPARE / DEPCNT：仍为默认 mariner settings preview
|
||||
- SOUNDG：仍未实现完整 S-52 glyph composition
|
||||
- OBSTRN / WRECKS：当前只完成 Point symbol runtime，AREA/LINE pending
|
||||
|
||||
因此下一阶段如继续追求与 OpenCPN 的完整视觉一致性，应优先完成上述 runtime CSP，而不是再次重建当前 0.4.12 PBF。
|
||||
Reference in New Issue
Block a user