# CM95 → NavSea PBF 映射设计报告 v1 日期：2026-09-03 状态：`PBF-02 / IMPLEMENTATION_DRAFT` 测试 AOI：`z10/914/385` ## 1. 本轮输入 CM95 MySQL AOI 审计： ```text AOI Cells : 7 AOI Spatial Features : 3605 Object class/geom groups : 80 Attribute groups : 177 Feature samples : 600 ``` 现有 NavSea/NEWPEC 对照 PBF： ```text z10 tiles : 1 z11 tiles : 4 z12 tiles : 16 total : 21 observed source-layers : 37 ``` 实际 extent： ```text z10 : 4096 z11 : 4096 z12 : 1048576 ``` 因此 CM95 generator 不应把“所有 zoom 固定 extent=4096”当成既有生产事实。首版 generator 必须把 extent 作为显式策略，并在输出审计中记录实际值。 ## 2. CM95 AOI 主要对象 当前 AOI 具备完整的安全对象闭环： ```text WRECKS POINT : 480 DEPCNT LINE : 451 DEPARE AREA : 414 SBDARE POINT : 287 SLCONS LINE : 209 UWTROC POINT : 176 COALNE LINE : 171 LNDARE AREA : 159 SLCONS AREA : 119 LIGHTS POINT : 96 OBSTRN AREA : 70 ITDARE AREA : 69 ``` 同时存在 Beacon/Buoy、Bridge、overhead cable、submarine cable、pilot boarding、anchorage 等对象，可覆盖第一阶段 hard-gate。 ## 3. 现有 NavSea PBF 实际契约 当前 21 张参考 PBF 中最主要的 source-layer： ```text onshore_structure_line 12940 baseline_outline 2129 baseline_area 1146 bathymetry_line 1128 anchor_caution_hazard_point 897 depth_contour 821 hole_area 563 land_area 321 seabed_text_point 273 baseline_line 234 anchor_caution_hazard_area 172 anchor_caution_hazard_outline 172 onshore_structure_area 137 place_label_land 136 onshore_structure_point 124 ``` 当前 unified style 实际消费 37 个 NavSea source-layer。 参考 PBF 与 style 之间存在少量“PBF 有但当前 style 不消费”的历史层： ```text depth_contour_overview route_area route_outline ``` 因此 CM95 v1 不因为参考 PBF 中存在 `route_area` 就自动输出它。 例如 `FAIRWY` 首版保留在工程版，避免违反“只改 tile URL 即可使用当前 style”的目标。 ## 4. 第一版映射覆盖 `cm95_to_navsea_v1.yaml` 已覆盖本 AOI 全部 80 个 `object_class + geometry_type` 组合。 映射状态（按组合数）： ```text MAPPED 33 ENGINEERING_ONLY 12 MAPPED_CONDITIONAL 11 REVIEW_STYLE_GAP 11 COMPOSITE 5 REVIEW_CONDITIONAL 4 ENGINEERING_COMPONENT 1 UNMAPPED_REVIEW 1 DERIVED_LABEL_ONLY 1 MAPPED_DERIVED_POINTS 1 ``` 可以直接进入映射/合成实现的 Feature 数： ```text 3239 / 3605 = 89.8% ``` 其余对象没有静默丢弃，全部明确进入： ```text REVIEW_CONDITIONAL REVIEW_STYLE_GAP ENGINEERING_ONLY ENGINEERING_COMPONENT UNMAPPED_REVIEW ``` 正式 delivery 不会因为未映射而“假装成功”。 ## 5. Hard-gate 映射 ### DEPARE ```text DEPARE AREA → baseline_area → DRVAL1 / DRVAL2 → canonical depth range → chart_fill_style=depth_zone_* ``` 原 polygon 不重建。 ### DEPCNT ```text DEPCNT LINE → depth_contour VALDCO → least_depth_m VALDCO → chart_label_text ``` ### WRECKS ```text WRECKS POINT → navigation_hazard_point VALSOU present → wreck_surveyed otherwise → wreck_submerged_dangerous ``` Area wreck 保持 area，不降级为 point，并额外派生 boundary 到 `navigation_hazard_outline`。 ### UWTROC ```text UWTROC POINT → navigation_hazard_point WATLEV submerged → rock_submerged WATLEV awash/drying → rock_awash VALSOU → least_depth_m ``` 必须保留水上/水下语义。 ### OBSTRN Point 与 Area 分开： ```text POINT → navigation_hazard_point AREA → navigation_hazard_area + derived outline ``` ### FSHHAV ```text FSHHAV POINT → anchor_caution_hazard_point → reef_fish ``` ### BRIDGE / CBLOHD / TELPHC / PIPOHD 净空/架空安全对象使用现有： ```text bridge_structure clearance_limit_line clearance_limit_point ``` 存在 `VERCLR` 时才写净空数值；没有值时不伪造。 ## 6. 助航对象必须合成，而不是简单逐对象输出 本轮最重要的新结论是： CM93 中： ```text LIGHTS BCNLAT BCNSPP BOYSPP RTPBCN TOWERS _extgn ``` 可能是同一个现实助航标的多个对象组件。 AOI 样本已经观察到共享： ```text cell_id + attributes._cm93_relation20_raw ``` 并且共享 relation20 的样本坐标完全一致。 样本证据包括： - cell `693` relation20 `2273` → `BCNLAT, LIGHTS`；坐标组数 `1` - cell `693` relation20 `2272` → `BCNLAT, LIGHTS`；坐标组数 `1` - cell `693` relation20 `2254` → `BCNLAT, LIGHTS`；坐标组数 `1` - cell `693` relation20 `2266` → `LIGHTS, _extgn`；坐标组数 `1` - cell `693` relation20 `2270` → `LIGHTS, _extgn`；坐标组数 `1` - cell `693` relation20 `2276` → `LIGHTS, _extgn`；坐标组数 `1` - cell `693` relation20 `2239` → `LIGHTS, TOWERS`；坐标组数 `1` - cell `693` relation20 `2241` → `LIGHTS, TOWERS`；坐标组数 `1` 因此 CM95 PBF Adapter 第一版采用： ```text primary composition key = cell_id + _cm93_relation20_raw ``` 而不是仅凭经纬度 proximity 合并。 规则： 1. relation20 相同且坐标一致 → 合成一个 `navigation_marks` Feature； 2. LIGHTS 的灯色、灯质、周期、高度、射程、扇区等属性并入基体； 3. Beacon/Buoy/Tower 提供主体 symbol 语义； 4. `_extgn` 只作为组件/trace，不单独 delivery； 5. relation20 缺失时才允许进入 fallback； 6. fallback 必须被审计标记，不能静默按邻近点合并。 在真正写 generator 前，需要用全 AOI 数据验证 relation20，而不是只依赖 600 条采样记录。 本包已经提供： ```text tools/cm95_nav_aid_relation_audit_v1.py ``` ## 7. Light 字段 本 AOI 实际出现的 CM93/S-57 `COLOUR` 值： ```text 1 → white 3 → red 4 → green 6 → yellow ``` 首版只对当前实际出现值建立冻结映射；其它值先进入 mapping gap，不猜值。 `LIGHTS` 输出至少包括： ```text light_color_code chart_label_text chart_label_subtext chart_text_style chart_text_color light_sector_mode chart_icon_image ``` 灯略记由： ```text LITCHR SIGGRP SIGPER COLOUR HEIGHT VALNMR ``` 组合生成。 ## 8. Sounding 当前 AOI 有 `SOUNDG` Feature，并由 `chart_sounding_point` 保存多个真实 sounding points。 因为当前 style 没有独立 `sounding_point` source-layer，v1 采用： ```text chart_sounding_point → derived point label → seabed_text_point ``` 这是额外 render artifact，不修改/替换数据库里的原 sounding。 ## 9. Stable identity 禁止把： ```text chart_feature.id ``` 当成长期 PBF identity。 v1 冻结 source identity： ```text cm95: dataset_id + source_relative_path + source_record_index + geometry_role ``` 下一阶段 generator 会在此基础上建立稳定 FID manifest，再接现有 NavSea numeric feature-id 体系。 ## 10. 当前尚未正式进入 delivery 的内容 主要包括： ```text _texto 文本归属 land/sea/facility 尚需关联判断 BUISGL POINT 当前 style 表达不明确 行政边界类 当前 style 不需要 FAIRWY 参考 PBF 有 route_area，但当前 unified style 不消费 若干一般陆上点对象 不属于 hard-gate，后续补 symbol 映射 ``` 这些对象全部保留在工程 trace / `cm95_unmapped`，没有删除。 ## 11. 下一步门禁 先执行 relation20 全 AOI 审计。 通过条件： ```text LIGHTS relation20 可覆盖主要灯标 relation group 不出现明显坐标冲突 跨 Cell 不发生错误合并 无法合并的 LIGHTS 数量明确 ``` 通过后进入： ```text PBF-03 CM95 MySQL → z10/914/385 单 tile generator ``` 第一版 generator 将只实现当前已经冻结的映射，并同时输出： ```text delivery PBF engineering PBF / trace cm95_unmapped report FID audit sprite closure audit object preservation audit ```