Initial import of NavSea pbf project
This commit is contained in:
997
navsea_render_audit.py
Normal file
997
navsea_render_audit.py
Normal file
@@ -0,0 +1,997 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
NavSea render audit for original vs engineering tiles/styles.
|
||||
|
||||
This script compares one original style/tile set against one engineering style/tile set.
|
||||
|
||||
Audit goal:
|
||||
- use legacy fid as the primary object identity
|
||||
- fall back to geometry + stable legacy properties when fid is missing
|
||||
- evaluate each style layer against decoded tile features
|
||||
- extract per-object render observations (icon/text/line/fill)
|
||||
- compare original and engineering render observations at tile-instance scope
|
||||
- emit Markdown and JSON audit reports for review
|
||||
- persist the latest audit result into MySQL for fid-level trace-back
|
||||
|
||||
Important scope note:
|
||||
- render comparison is performed per tile feature instance
|
||||
- identity is "fid first", but zoom/tile instance is preserved because rendering is zoom-sensitive
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
import hashlib
|
||||
import json
|
||||
from collections import Counter, defaultdict
|
||||
from dataclasses import dataclass
|
||||
from pathlib import Path
|
||||
from typing import Any
|
||||
|
||||
import mapbox_vector_tile
|
||||
import pymysql
|
||||
|
||||
|
||||
DEFAULT_ORIGINAL_STYLE_PATH = Path("/mnt/sda1/www/newpec/style.patched.local.json")
|
||||
DEFAULT_ENGINEERING_STYLE_PATH = Path("/mnt/sda1/www/newpec/navsea-engineering.json")
|
||||
DEFAULT_ORIGINAL_TILE_ROOT = Path(
|
||||
"/home/wwwroot/newpec/exported_auto/"
|
||||
"tile.mapple-on.jp__newpec-mvt-20260106__z___x___y_.pbf/tiles"
|
||||
)
|
||||
DEFAULT_ENGINEERING_TILE_ROOT = Path("/home/wwwroot/pbf-engineering-karatsu-10nm")
|
||||
DEFAULT_REPORT_MD_PATH = Path("/root/weather/NavSea_Original_vs_Engineering_Render_Audit_Karatsu_10nm.md")
|
||||
DEFAULT_REPORT_JSON_PATH = Path("/root/weather/NavSea_Original_vs_Engineering_Render_Audit_Karatsu_10nm.json")
|
||||
DEFAULT_AUDIT_NAME = "navsea_original_vs_engineering_karatsu_10nm"
|
||||
DB_BATCH_SIZE = 1000
|
||||
MAX_EXAMPLES = 30
|
||||
|
||||
ORIGINAL_STYLE_PATH = DEFAULT_ORIGINAL_STYLE_PATH
|
||||
ENGINEERING_STYLE_PATH = DEFAULT_ENGINEERING_STYLE_PATH
|
||||
ORIGINAL_TILE_ROOT = DEFAULT_ORIGINAL_TILE_ROOT
|
||||
ENGINEERING_TILE_ROOT = DEFAULT_ENGINEERING_TILE_ROOT
|
||||
REPORT_MD_PATH = DEFAULT_REPORT_MD_PATH
|
||||
REPORT_JSON_PATH = DEFAULT_REPORT_JSON_PATH
|
||||
AUDIT_NAME = DEFAULT_AUDIT_NAME
|
||||
|
||||
DERIVED_PROPERTY_PREFIXES = (
|
||||
"canonical_",
|
||||
"semantic_",
|
||||
"detection_",
|
||||
"render_",
|
||||
"chart_",
|
||||
"light_",
|
||||
"hazard_",
|
||||
"area_",
|
||||
"source_layer_",
|
||||
)
|
||||
DERIVED_PROPERTY_KEYS = {
|
||||
"fid_algo_id",
|
||||
"fid_key_id",
|
||||
"fid_navsea_int",
|
||||
"fid_legacy_raw",
|
||||
"normalization_bundle_id",
|
||||
"source_layer_rule_id",
|
||||
"trace_status",
|
||||
"feature_id",
|
||||
"depth_value_m",
|
||||
"clearance_height_m",
|
||||
"least_depth_m",
|
||||
"bearing_deg",
|
||||
}
|
||||
STABLE_FALLBACK_KEYS = (
|
||||
"分類番号",
|
||||
"形状分類番号",
|
||||
"表示用番号",
|
||||
"灯色",
|
||||
"灯略記",
|
||||
"明弧/分孤",
|
||||
"表示位置",
|
||||
"名称",
|
||||
"名称補助",
|
||||
"日本語地名",
|
||||
"英文字地名",
|
||||
"水深値(m)",
|
||||
"高さ(m)",
|
||||
"高さ/深度(m)",
|
||||
"角度",
|
||||
)
|
||||
EXPRESSION_OPS = {
|
||||
"get",
|
||||
"match",
|
||||
"coalesce",
|
||||
"concat",
|
||||
"number",
|
||||
"literal",
|
||||
"rgba",
|
||||
"case",
|
||||
"has",
|
||||
"any",
|
||||
"all",
|
||||
"==",
|
||||
"!=",
|
||||
">=",
|
||||
"<=",
|
||||
">",
|
||||
"<",
|
||||
"/",
|
||||
"*",
|
||||
"interpolate",
|
||||
"step",
|
||||
"zoom",
|
||||
}
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class DbConfig:
|
||||
host: str = "localhost"
|
||||
port: int = 3306
|
||||
user: str = "root"
|
||||
password: str = "2chi9ks2"
|
||||
database: str = "pbf_analysis"
|
||||
unix_socket: str | None = "/tmp/mysql.sock"
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class AuditFeature:
|
||||
dataset: str
|
||||
tile_z: int
|
||||
tile_x: int
|
||||
tile_y: int
|
||||
layer_name: str
|
||||
geom_type: str
|
||||
object_id: str
|
||||
fid_legacy: str | None
|
||||
properties: dict[str, Any]
|
||||
|
||||
|
||||
@dataclass(frozen=True)
|
||||
class RenderObservation:
|
||||
component_type: str
|
||||
style_layer_id: str
|
||||
signature: str
|
||||
payload: dict[str, Any]
|
||||
|
||||
|
||||
def canonical_json(value: Any) -> str:
|
||||
return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"))
|
||||
|
||||
|
||||
def hash_text(text: str) -> str:
|
||||
return hashlib.sha1(text.encode("utf-8")).hexdigest()[:16]
|
||||
|
||||
|
||||
def text_or_none(value: Any) -> str | None:
|
||||
if value is None:
|
||||
return None
|
||||
text = str(value).strip()
|
||||
return text or None
|
||||
|
||||
|
||||
def numeric_or_text(value: Any) -> float | str | None:
|
||||
if value is None:
|
||||
return None
|
||||
if isinstance(value, (int, float)):
|
||||
return float(value)
|
||||
text = text_or_none(value)
|
||||
if text is None:
|
||||
return None
|
||||
try:
|
||||
return float(text)
|
||||
except ValueError:
|
||||
return text
|
||||
|
||||
|
||||
def normalize_color(value: Any) -> str | None:
|
||||
if value is None:
|
||||
return None
|
||||
if isinstance(value, str):
|
||||
return value
|
||||
if isinstance(value, list):
|
||||
return canonical_json(value)
|
||||
return str(value)
|
||||
|
||||
|
||||
def compare_numbers(lhs: Any, rhs: Any, op: str) -> bool:
|
||||
lhs_num = numeric_or_text(lhs)
|
||||
rhs_num = numeric_or_text(rhs)
|
||||
if isinstance(lhs_num, float) and isinstance(rhs_num, float):
|
||||
if op == ">=":
|
||||
return lhs_num >= rhs_num
|
||||
if op == "<=":
|
||||
return lhs_num <= rhs_num
|
||||
if op == ">":
|
||||
return lhs_num > rhs_num
|
||||
if op == "<":
|
||||
return lhs_num < rhs_num
|
||||
lhs_text = "" if lhs is None else str(lhs)
|
||||
rhs_text = "" if rhs is None else str(rhs)
|
||||
if op == ">=":
|
||||
return lhs_text >= rhs_text
|
||||
if op == "<=":
|
||||
return lhs_text <= rhs_text
|
||||
if op == ">":
|
||||
return lhs_text > rhs_text
|
||||
return lhs_text < rhs_text
|
||||
|
||||
|
||||
def evaluate_expression(expr: Any, feature: AuditFeature, zoom: int) -> Any:
|
||||
if not isinstance(expr, list):
|
||||
return expr
|
||||
if not expr:
|
||||
return expr
|
||||
head = expr[0]
|
||||
if not isinstance(head, str) or head not in EXPRESSION_OPS:
|
||||
return [evaluate_expression(item, feature, zoom) for item in expr]
|
||||
|
||||
if head == "get":
|
||||
key = expr[1]
|
||||
return feature.properties.get(key)
|
||||
if head == "literal":
|
||||
return expr[1]
|
||||
if head == "coalesce":
|
||||
for item in expr[1:]:
|
||||
value = evaluate_expression(item, feature, zoom)
|
||||
if value not in (None, ""):
|
||||
return value
|
||||
return None
|
||||
if head == "concat":
|
||||
return "".join("" if (value := evaluate_expression(item, feature, zoom)) is None else str(value) for item in expr[1:])
|
||||
if head == "number":
|
||||
value = evaluate_expression(expr[1], feature, zoom)
|
||||
parsed = numeric_or_text(value)
|
||||
if isinstance(parsed, float):
|
||||
return parsed
|
||||
fallback = evaluate_expression(expr[2], feature, zoom) if len(expr) > 2 else None
|
||||
return fallback
|
||||
if head == "rgba":
|
||||
values = [evaluate_expression(item, feature, zoom) for item in expr[1:5]]
|
||||
return f"rgba({values[0]},{values[1]},{values[2]},{values[3]})"
|
||||
if head == "has":
|
||||
key = expr[1]
|
||||
return key in feature.properties and feature.properties.get(key) not in (None, "")
|
||||
if head == "zoom":
|
||||
return zoom
|
||||
if head in {"==", "!="}:
|
||||
lhs = evaluate_expression(expr[1], feature, zoom)
|
||||
rhs = evaluate_expression(expr[2], feature, zoom)
|
||||
result = lhs == rhs
|
||||
return result if head == "==" else not result
|
||||
if head in {">=", "<=", ">", "<"}:
|
||||
lhs = evaluate_expression(expr[1], feature, zoom)
|
||||
rhs = evaluate_expression(expr[2], feature, zoom)
|
||||
return compare_numbers(lhs, rhs, head)
|
||||
if head == "any":
|
||||
return any(bool(evaluate_expression(item, feature, zoom)) for item in expr[1:])
|
||||
if head == "all":
|
||||
return all(bool(evaluate_expression(item, feature, zoom)) for item in expr[1:])
|
||||
if head == "case":
|
||||
clauses = expr[1:]
|
||||
for idx in range(0, len(clauses) - 1, 2):
|
||||
if bool(evaluate_expression(clauses[idx], feature, zoom)):
|
||||
return evaluate_expression(clauses[idx + 1], feature, zoom)
|
||||
return evaluate_expression(clauses[-1], feature, zoom) if clauses else None
|
||||
if head == "match":
|
||||
value = evaluate_expression(expr[1], feature, zoom)
|
||||
arms = expr[2:]
|
||||
fallback = arms[-1] if arms else None
|
||||
for idx in range(0, len(arms) - 1, 2):
|
||||
label = arms[idx]
|
||||
result = arms[idx + 1]
|
||||
if isinstance(label, list):
|
||||
if value in [evaluate_expression(item, feature, zoom) for item in label]:
|
||||
return evaluate_expression(result, feature, zoom)
|
||||
else:
|
||||
if value == evaluate_expression(label, feature, zoom):
|
||||
return evaluate_expression(result, feature, zoom)
|
||||
return evaluate_expression(fallback, feature, zoom)
|
||||
if head == "/":
|
||||
lhs = evaluate_expression(expr[1], feature, zoom)
|
||||
rhs = evaluate_expression(expr[2], feature, zoom)
|
||||
lhs_num = numeric_or_text(lhs)
|
||||
rhs_num = numeric_or_text(rhs)
|
||||
if isinstance(lhs_num, float) and isinstance(rhs_num, float) and rhs_num != 0:
|
||||
return lhs_num / rhs_num
|
||||
return None
|
||||
if head == "*":
|
||||
lhs = evaluate_expression(expr[1], feature, zoom)
|
||||
rhs = evaluate_expression(expr[2], feature, zoom)
|
||||
lhs_num = numeric_or_text(lhs)
|
||||
rhs_num = numeric_or_text(rhs)
|
||||
if isinstance(lhs_num, float) and isinstance(rhs_num, float):
|
||||
return lhs_num * rhs_num
|
||||
return None
|
||||
if head == "step":
|
||||
input_value = evaluate_expression(expr[1], feature, zoom)
|
||||
input_num = numeric_or_text(input_value)
|
||||
if not isinstance(input_num, float):
|
||||
return evaluate_expression(expr[2], feature, zoom)
|
||||
result = evaluate_expression(expr[2], feature, zoom)
|
||||
stops = expr[3:]
|
||||
for idx in range(0, len(stops), 2):
|
||||
stop = evaluate_expression(stops[idx], feature, zoom)
|
||||
stop_num = numeric_or_text(stop)
|
||||
if not isinstance(stop_num, float):
|
||||
continue
|
||||
if idx + 1 >= len(stops):
|
||||
break
|
||||
if input_num >= stop_num:
|
||||
result = evaluate_expression(stops[idx + 1], feature, zoom)
|
||||
else:
|
||||
break
|
||||
return result
|
||||
if head == "interpolate":
|
||||
input_value = evaluate_expression(expr[2], feature, zoom)
|
||||
input_num = numeric_or_text(input_value)
|
||||
if not isinstance(input_num, float):
|
||||
return None
|
||||
stops = expr[3:]
|
||||
prev_stop = None
|
||||
prev_value = None
|
||||
for idx in range(0, len(stops), 2):
|
||||
stop_num = numeric_or_text(evaluate_expression(stops[idx], feature, zoom))
|
||||
stop_value = evaluate_expression(stops[idx + 1], feature, zoom) if idx + 1 < len(stops) else None
|
||||
if not isinstance(stop_num, float):
|
||||
continue
|
||||
if input_num == stop_num:
|
||||
return stop_value
|
||||
if input_num < stop_num:
|
||||
return prev_value if prev_value is not None else stop_value
|
||||
prev_stop = stop_num
|
||||
prev_value = stop_value
|
||||
return prev_value
|
||||
return None
|
||||
|
||||
|
||||
def layer_visible(layer: dict[str, Any], zoom: int) -> bool:
|
||||
if zoom < int(layer.get("minzoom", 0)):
|
||||
return False
|
||||
maxzoom = layer.get("maxzoom")
|
||||
if maxzoom is not None and zoom >= int(maxzoom):
|
||||
return False
|
||||
layout = layer.get("layout") or {}
|
||||
if layout.get("visibility") == "none":
|
||||
return False
|
||||
return True
|
||||
|
||||
|
||||
def layer_matches_feature(layer: dict[str, Any], feature: AuditFeature) -> bool:
|
||||
if layer.get("source-layer") != feature.layer_name:
|
||||
return False
|
||||
if not layer_visible(layer, feature.tile_z):
|
||||
return False
|
||||
filter_expr = layer.get("filter")
|
||||
if filter_expr is None:
|
||||
return True
|
||||
return bool(evaluate_expression(filter_expr, feature, feature.tile_z))
|
||||
|
||||
|
||||
def evaluate_style_value(layer: dict[str, Any], section: str, key: str, feature: AuditFeature) -> Any:
|
||||
payload = layer.get(section) or {}
|
||||
if key not in payload:
|
||||
return None
|
||||
return evaluate_expression(payload[key], feature, feature.tile_z)
|
||||
|
||||
|
||||
def build_signature(component_type: str, payload: dict[str, Any]) -> str:
|
||||
normalized = {
|
||||
k: payload[k]
|
||||
for k in sorted(payload)
|
||||
if k != "layer_id" and payload[k] not in (None, "", [], {})
|
||||
}
|
||||
return f"{component_type}:{canonical_json(normalized)}"
|
||||
|
||||
|
||||
def collect_layer_observations(layer: dict[str, Any], feature: AuditFeature) -> list[RenderObservation]:
|
||||
observations: list[RenderObservation] = []
|
||||
layer_id = str(layer["id"])
|
||||
layer_type = str(layer.get("type", ""))
|
||||
|
||||
if layer_type == "symbol":
|
||||
icon_image = evaluate_style_value(layer, "layout", "icon-image", feature)
|
||||
text_value = evaluate_style_value(layer, "layout", "text-field", feature)
|
||||
text_color = evaluate_style_value(layer, "paint", "text-color", feature)
|
||||
text_anchor = evaluate_style_value(layer, "layout", "text-anchor", feature)
|
||||
text_size = evaluate_style_value(layer, "layout", "text-size", feature)
|
||||
icon_size = evaluate_style_value(layer, "layout", "icon-size", feature)
|
||||
if icon_image not in (None, ""):
|
||||
payload = {
|
||||
"layer_id": layer_id,
|
||||
"icon_image": icon_image,
|
||||
"icon_size": icon_size,
|
||||
}
|
||||
observations.append(
|
||||
RenderObservation(
|
||||
component_type="icon",
|
||||
style_layer_id=layer_id,
|
||||
signature=build_signature("icon", payload),
|
||||
payload=payload,
|
||||
)
|
||||
)
|
||||
if text_value not in (None, ""):
|
||||
payload = {
|
||||
"layer_id": layer_id,
|
||||
"text_value": str(text_value),
|
||||
"text_color": normalize_color(text_color),
|
||||
"text_anchor": text_anchor,
|
||||
"text_size": text_size,
|
||||
}
|
||||
observations.append(
|
||||
RenderObservation(
|
||||
component_type="text",
|
||||
style_layer_id=layer_id,
|
||||
signature=build_signature("text", payload),
|
||||
payload=payload,
|
||||
)
|
||||
)
|
||||
return observations
|
||||
|
||||
if layer_type == "line":
|
||||
payload = {
|
||||
"layer_id": layer_id,
|
||||
"line_color": normalize_color(evaluate_style_value(layer, "paint", "line-color", feature)),
|
||||
"line_width": evaluate_style_value(layer, "paint", "line-width", feature),
|
||||
"line_dasharray": evaluate_style_value(layer, "paint", "line-dasharray", feature),
|
||||
"line_pattern": evaluate_style_value(layer, "paint", "line-pattern", feature),
|
||||
}
|
||||
observations.append(
|
||||
RenderObservation(
|
||||
component_type="line",
|
||||
style_layer_id=layer_id,
|
||||
signature=build_signature("line", payload),
|
||||
payload=payload,
|
||||
)
|
||||
)
|
||||
return observations
|
||||
|
||||
if layer_type == "fill":
|
||||
payload = {
|
||||
"layer_id": layer_id,
|
||||
"fill_color": normalize_color(evaluate_style_value(layer, "paint", "fill-color", feature)),
|
||||
"fill_pattern": evaluate_style_value(layer, "paint", "fill-pattern", feature),
|
||||
"fill_outline_color": normalize_color(evaluate_style_value(layer, "paint", "fill-outline-color", feature)),
|
||||
"fill_opacity": evaluate_style_value(layer, "paint", "fill-opacity", feature),
|
||||
}
|
||||
observations.append(
|
||||
RenderObservation(
|
||||
component_type="fill",
|
||||
style_layer_id=layer_id,
|
||||
signature=build_signature("fill", payload),
|
||||
payload=payload,
|
||||
)
|
||||
)
|
||||
return observations
|
||||
|
||||
return observations
|
||||
|
||||
|
||||
def collect_render_observations(style: dict[str, Any], feature: AuditFeature) -> list[RenderObservation]:
|
||||
observations: list[RenderObservation] = []
|
||||
for layer in style.get("layers", []):
|
||||
if "source-layer" not in layer:
|
||||
continue
|
||||
if not layer_matches_feature(layer, feature):
|
||||
continue
|
||||
observations.extend(collect_layer_observations(layer, feature))
|
||||
return observations
|
||||
|
||||
|
||||
def load_style(path: Path) -> dict[str, Any]:
|
||||
return json.loads(path.read_text(encoding="utf-8"))
|
||||
|
||||
|
||||
def iter_tile_paths(root: Path) -> list[Path]:
|
||||
return sorted(root.glob("*/*/*.pbf"))
|
||||
|
||||
|
||||
def stable_fallback_properties(properties: dict[str, Any]) -> dict[str, Any]:
|
||||
return {
|
||||
key: properties[key]
|
||||
for key in STABLE_FALLBACK_KEYS
|
||||
if key in properties and properties[key] not in (None, "")
|
||||
}
|
||||
|
||||
|
||||
def geometry_hash(geometry: dict[str, Any]) -> str:
|
||||
return hash_text(canonical_json(geometry))
|
||||
|
||||
|
||||
def extract_legacy_fid(properties: dict[str, Any]) -> str | None:
|
||||
legacy = properties.get("fid_legacy_raw")
|
||||
if legacy not in (None, ""):
|
||||
return str(legacy)
|
||||
fid = properties.get("fid")
|
||||
if fid not in (None, ""):
|
||||
return str(fid)
|
||||
return None
|
||||
|
||||
|
||||
def object_identity(layer_name: str, geometry: dict[str, Any], properties: dict[str, Any]) -> tuple[str, str | None]:
|
||||
geom_type = str(geometry.get("type", ""))
|
||||
legacy_source_layer = text_or_none(properties.get("source_layer_jp")) or layer_name
|
||||
legacy_fid = extract_legacy_fid(properties)
|
||||
if legacy_fid:
|
||||
return f"fid:{legacy_fid}|src:{legacy_source_layer}|geom:{geom_type}", legacy_fid
|
||||
fallback_payload = {
|
||||
"source_layer": legacy_source_layer,
|
||||
"geom_type": geom_type,
|
||||
"geometry_hash": geometry_hash(geometry),
|
||||
"stable_props": stable_fallback_properties(properties),
|
||||
}
|
||||
return f"fallback:{hash_text(canonical_json(fallback_payload))}", None
|
||||
|
||||
|
||||
def feature_instance_id(feature: AuditFeature) -> str:
|
||||
return (
|
||||
f"{feature.object_id}|z:{feature.tile_z}|x:{feature.tile_x}|"
|
||||
f"y:{feature.tile_y}|layer:{feature.layer_name}"
|
||||
)
|
||||
|
||||
|
||||
def decode_tile_instances(dataset: str, tile_root: Path, style: dict[str, Any], tile_path: Path) -> dict[str, dict[str, Any]]:
|
||||
instances: dict[str, dict[str, Any]] = {}
|
||||
rel = tile_path.relative_to(tile_root)
|
||||
z = int(rel.parts[0])
|
||||
x = int(rel.parts[1])
|
||||
y = int(tile_path.stem)
|
||||
decoded = mapbox_vector_tile.decode(tile_path.read_bytes())
|
||||
for layer_name, payload in decoded.items():
|
||||
for feature in payload.get("features", []):
|
||||
geometry = feature.get("geometry") or {}
|
||||
properties = dict(feature.get("properties") or {})
|
||||
object_id, legacy_fid = object_identity(layer_name, geometry, properties)
|
||||
audit_feature = AuditFeature(
|
||||
dataset=dataset,
|
||||
tile_z=z,
|
||||
tile_x=x,
|
||||
tile_y=y,
|
||||
layer_name=layer_name,
|
||||
geom_type=str(geometry.get("type", "")),
|
||||
object_id=object_id,
|
||||
fid_legacy=legacy_fid,
|
||||
properties=properties,
|
||||
)
|
||||
instance_id = feature_instance_id(audit_feature)
|
||||
instances[instance_id] = {
|
||||
"feature": audit_feature,
|
||||
"observations": collect_render_observations(style, audit_feature),
|
||||
}
|
||||
return instances
|
||||
|
||||
|
||||
def summarize_observations(observations: list[RenderObservation]) -> dict[str, list[str]]:
|
||||
grouped: dict[str, set[str]] = defaultdict(set)
|
||||
for observation in observations:
|
||||
grouped[observation.component_type].add(observation.signature)
|
||||
return {key: sorted(values) for key, values in grouped.items()}
|
||||
|
||||
|
||||
def normalize_component_map(component_map: dict[str, list[str]]) -> dict[str, tuple[str, ...]]:
|
||||
return {key: tuple(values) for key, values in sorted(component_map.items())}
|
||||
|
||||
|
||||
def compare_instance(
|
||||
original: dict[str, Any] | None,
|
||||
engineering: dict[str, Any] | None,
|
||||
) -> dict[str, Any]:
|
||||
if original is None:
|
||||
eng_feature = engineering["feature"]
|
||||
return {
|
||||
"status": "extra_in_engineering",
|
||||
"object_instance_id": feature_instance_id(eng_feature),
|
||||
"object_id": eng_feature.object_id,
|
||||
"fid_legacy": eng_feature.fid_legacy,
|
||||
"tile": f"{eng_feature.tile_z}/{eng_feature.tile_x}/{eng_feature.tile_y}",
|
||||
"tile_z": eng_feature.tile_z,
|
||||
"tile_x": eng_feature.tile_x,
|
||||
"tile_y": eng_feature.tile_y,
|
||||
"source_layer": eng_feature.layer_name,
|
||||
"canonical_object_type": text_or_none(eng_feature.properties.get("canonical_object_type")),
|
||||
"original_components": {},
|
||||
"engineering_components": normalize_component_map(
|
||||
summarize_observations(engineering["observations"])
|
||||
),
|
||||
}
|
||||
if engineering is None:
|
||||
orig_feature = original["feature"]
|
||||
return {
|
||||
"status": "missing_in_engineering",
|
||||
"object_instance_id": feature_instance_id(orig_feature),
|
||||
"object_id": orig_feature.object_id,
|
||||
"fid_legacy": orig_feature.fid_legacy,
|
||||
"tile": f"{orig_feature.tile_z}/{orig_feature.tile_x}/{orig_feature.tile_y}",
|
||||
"tile_z": orig_feature.tile_z,
|
||||
"tile_x": orig_feature.tile_x,
|
||||
"tile_y": orig_feature.tile_y,
|
||||
"source_layer": orig_feature.layer_name,
|
||||
"canonical_object_type": None,
|
||||
"original_components": normalize_component_map(
|
||||
summarize_observations(original["observations"])
|
||||
),
|
||||
"engineering_components": {},
|
||||
}
|
||||
|
||||
orig_feature = original["feature"]
|
||||
eng_feature = engineering["feature"]
|
||||
original_components = normalize_component_map(summarize_observations(original["observations"]))
|
||||
engineering_components = normalize_component_map(summarize_observations(engineering["observations"]))
|
||||
|
||||
if original_components == engineering_components:
|
||||
status = "exact_match"
|
||||
elif not original_components and engineering_components:
|
||||
status = "extra_in_engineering"
|
||||
elif original_components and not engineering_components:
|
||||
status = "missing_in_engineering"
|
||||
else:
|
||||
status = "mismatch"
|
||||
|
||||
return {
|
||||
"status": status,
|
||||
"object_instance_id": feature_instance_id(orig_feature),
|
||||
"object_id": orig_feature.object_id,
|
||||
"fid_legacy": orig_feature.fid_legacy or eng_feature.fid_legacy,
|
||||
"tile": f"{orig_feature.tile_z}/{orig_feature.tile_x}/{orig_feature.tile_y}",
|
||||
"tile_z": orig_feature.tile_z,
|
||||
"tile_x": orig_feature.tile_x,
|
||||
"tile_y": orig_feature.tile_y,
|
||||
"source_layer": text_or_none(eng_feature.properties.get("source_layer_jp")) or orig_feature.layer_name,
|
||||
"canonical_object_type": text_or_none(eng_feature.properties.get("canonical_object_type")),
|
||||
"original_components": original_components,
|
||||
"engineering_components": engineering_components,
|
||||
}
|
||||
|
||||
|
||||
def format_component_map(component_map: dict[str, tuple[str, ...]] | dict[str, list[str]]) -> str:
|
||||
if not component_map:
|
||||
return "none"
|
||||
parts = []
|
||||
for key in sorted(component_map):
|
||||
values = component_map[key]
|
||||
parts.append(f"{key}={list(values)}")
|
||||
return "; ".join(parts)
|
||||
|
||||
|
||||
def write_reports(
|
||||
*,
|
||||
original_count: int,
|
||||
engineering_count: int,
|
||||
result_count: int,
|
||||
status_counter: Counter[str],
|
||||
source_layer_counter: Counter[tuple[str, str]],
|
||||
mismatch_examples: list[dict[str, Any]],
|
||||
) -> None:
|
||||
payload = {
|
||||
"original_feature_instances": original_count,
|
||||
"engineering_feature_instances": engineering_count,
|
||||
"result_count": result_count,
|
||||
"status_counts": dict(status_counter),
|
||||
"source_layer_issue_counts": [
|
||||
{"status": status, "source_layer": source_layer, "count": count}
|
||||
for (status, source_layer), count in source_layer_counter.most_common(30)
|
||||
],
|
||||
"mismatch_examples": mismatch_examples,
|
||||
}
|
||||
REPORT_JSON_PATH.write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8")
|
||||
|
||||
lines = [
|
||||
"# NavSea 原始版 vs 工程版渲染审计报告",
|
||||
"",
|
||||
"## 范围",
|
||||
"",
|
||||
f"- 原始样式: `{ORIGINAL_STYLE_PATH}`",
|
||||
f"- 工程样式: `{ENGINEERING_STYLE_PATH}`",
|
||||
f"- 原始瓦片根目录: `{ORIGINAL_TILE_ROOT}`",
|
||||
f"- 工程瓦片根目录: `{ENGINEERING_TILE_ROOT}`",
|
||||
f"- 原始 feature 实例数: `{original_count}`",
|
||||
f"- 工程 feature 实例数: `{engineering_count}`",
|
||||
f"- 审计结果数: `{result_count}`",
|
||||
"",
|
||||
"## 匹配口径",
|
||||
"",
|
||||
"- 主键优先使用 legacy `fid`。",
|
||||
"- 没有 `fid` 的对象,回退到 `geometry + 稳定旧属性`。",
|
||||
"- 审计粒度保留 tile 实例,因为渲染具有 zoom 敏感性。",
|
||||
"",
|
||||
"## 结果统计",
|
||||
"",
|
||||
]
|
||||
for status, count in status_counter.most_common():
|
||||
lines.append(f"- `{status}`: `{count}`")
|
||||
|
||||
lines.extend([
|
||||
"",
|
||||
"## 主要问题层",
|
||||
"",
|
||||
])
|
||||
if not source_layer_counter:
|
||||
lines.append("- 没有发现差异。")
|
||||
else:
|
||||
for (status, source_layer), count in source_layer_counter.most_common(20):
|
||||
lines.append(f"- `{status}` | `{source_layer}` | `{count}`")
|
||||
|
||||
lines.extend([
|
||||
"",
|
||||
"## 差异样例",
|
||||
"",
|
||||
])
|
||||
if not mismatch_examples:
|
||||
lines.append("- 没有差异样例。")
|
||||
else:
|
||||
for item in mismatch_examples:
|
||||
lines.append(
|
||||
f"- `{item['status']}` | tile=`{item['tile']}` | source_layer=`{item['source_layer']}` | "
|
||||
f"fid=`{item['fid_legacy']}` | object=`{item['canonical_object_type'] or 'n/a'}`"
|
||||
)
|
||||
lines.append(f" original: {format_component_map(item['original_components'])}")
|
||||
lines.append(f" engineering: {format_component_map(item['engineering_components'])}")
|
||||
|
||||
REPORT_MD_PATH.write_text("\n".join(lines) + "\n", encoding="utf-8")
|
||||
|
||||
|
||||
def db_connect() -> pymysql.Connection:
|
||||
cfg = DbConfig()
|
||||
kwargs: dict[str, Any] = {
|
||||
"host": cfg.host,
|
||||
"port": cfg.port,
|
||||
"user": cfg.user,
|
||||
"password": cfg.password,
|
||||
"database": cfg.database,
|
||||
"charset": "utf8mb4",
|
||||
"autocommit": False,
|
||||
}
|
||||
if cfg.unix_socket:
|
||||
kwargs["unix_socket"] = cfg.unix_socket
|
||||
return pymysql.connect(**kwargs)
|
||||
|
||||
|
||||
def ensure_audit_tables(cur: pymysql.cursors.Cursor) -> None:
|
||||
cur.execute(
|
||||
"""
|
||||
CREATE TABLE IF NOT EXISTS navsea_render_audit_run (
|
||||
audit_name VARCHAR(128) NOT NULL,
|
||||
original_style_path VARCHAR(512) NOT NULL,
|
||||
engineering_style_path VARCHAR(512) NOT NULL,
|
||||
original_tile_root VARCHAR(512) NOT NULL,
|
||||
engineering_tile_root VARCHAR(512) NOT NULL,
|
||||
original_feature_instances INT NOT NULL,
|
||||
engineering_feature_instances INT NOT NULL,
|
||||
result_count INT NOT NULL,
|
||||
status_counts_json LONGTEXT NOT NULL,
|
||||
source_layer_issue_counts_json LONGTEXT NOT NULL,
|
||||
report_md_path VARCHAR(512) NOT NULL,
|
||||
report_json_path VARCHAR(512) NOT NULL,
|
||||
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
PRIMARY KEY (audit_name)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
|
||||
"""
|
||||
)
|
||||
cur.execute(
|
||||
"""
|
||||
CREATE TABLE IF NOT EXISTS navsea_render_audit_result (
|
||||
audit_name VARCHAR(64) NOT NULL,
|
||||
object_instance_key VARCHAR(64) NOT NULL,
|
||||
object_instance_id TEXT NOT NULL,
|
||||
object_id VARCHAR(255) NOT NULL,
|
||||
fid_legacy VARCHAR(64) DEFAULT NULL,
|
||||
tile_z INT NOT NULL,
|
||||
tile_x INT NOT NULL,
|
||||
tile_y INT NOT NULL,
|
||||
source_layer VARCHAR(100) DEFAULT NULL,
|
||||
canonical_object_type VARCHAR(191) DEFAULT NULL,
|
||||
status VARCHAR(32) NOT NULL,
|
||||
original_components_json LONGTEXT NOT NULL,
|
||||
engineering_components_json LONGTEXT NOT NULL,
|
||||
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
PRIMARY KEY (audit_name, object_instance_key),
|
||||
KEY idx_render_audit_fid (fid_legacy),
|
||||
KEY idx_render_audit_status (status),
|
||||
KEY idx_render_audit_layer (source_layer)
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
|
||||
"""
|
||||
)
|
||||
|
||||
|
||||
def insert_result_batch(cur: pymysql.cursors.Cursor, rows: list[tuple[Any, ...]]) -> None:
|
||||
if not rows:
|
||||
return
|
||||
cur.executemany(
|
||||
"""
|
||||
INSERT INTO navsea_render_audit_result (
|
||||
audit_name,
|
||||
object_instance_key,
|
||||
object_instance_id,
|
||||
object_id,
|
||||
fid_legacy,
|
||||
tile_z,
|
||||
tile_x,
|
||||
tile_y,
|
||||
source_layer,
|
||||
canonical_object_type,
|
||||
status,
|
||||
original_components_json,
|
||||
engineering_components_json
|
||||
) VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s)
|
||||
""",
|
||||
rows,
|
||||
)
|
||||
|
||||
|
||||
def persist_audit_run(
|
||||
cur: pymysql.cursors.Cursor,
|
||||
*,
|
||||
original_count: int,
|
||||
engineering_count: int,
|
||||
result_count: int,
|
||||
status_counter: Counter[str],
|
||||
source_layer_counter: Counter[tuple[str, str]],
|
||||
) -> None:
|
||||
source_layer_issue_counts = [
|
||||
{"status": status, "source_layer": source_layer, "count": count}
|
||||
for (status, source_layer), count in source_layer_counter.most_common(100)
|
||||
]
|
||||
cur.execute(
|
||||
"""
|
||||
INSERT INTO navsea_render_audit_run (
|
||||
audit_name,
|
||||
original_style_path,
|
||||
engineering_style_path,
|
||||
original_tile_root,
|
||||
engineering_tile_root,
|
||||
original_feature_instances,
|
||||
engineering_feature_instances,
|
||||
result_count,
|
||||
status_counts_json,
|
||||
source_layer_issue_counts_json,
|
||||
report_md_path,
|
||||
report_json_path
|
||||
) VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s)
|
||||
""",
|
||||
(
|
||||
AUDIT_NAME,
|
||||
str(ORIGINAL_STYLE_PATH),
|
||||
str(ENGINEERING_STYLE_PATH),
|
||||
str(ORIGINAL_TILE_ROOT),
|
||||
str(ENGINEERING_TILE_ROOT),
|
||||
original_count,
|
||||
engineering_count,
|
||||
result_count,
|
||||
json.dumps(dict(status_counter), ensure_ascii=False),
|
||||
json.dumps(source_layer_issue_counts, ensure_ascii=False),
|
||||
str(REPORT_MD_PATH),
|
||||
str(REPORT_JSON_PATH),
|
||||
),
|
||||
)
|
||||
|
||||
|
||||
def parse_args() -> argparse.Namespace:
|
||||
parser = argparse.ArgumentParser(description="Audit original vs engineering render outputs.")
|
||||
parser.add_argument("--audit-name", default=DEFAULT_AUDIT_NAME)
|
||||
parser.add_argument("--original-style", type=Path, default=DEFAULT_ORIGINAL_STYLE_PATH)
|
||||
parser.add_argument("--engineering-style", type=Path, default=DEFAULT_ENGINEERING_STYLE_PATH)
|
||||
parser.add_argument("--original-tile-root", type=Path, default=DEFAULT_ORIGINAL_TILE_ROOT)
|
||||
parser.add_argument("--engineering-tile-root", type=Path, default=DEFAULT_ENGINEERING_TILE_ROOT)
|
||||
parser.add_argument("--report-md", type=Path, default=DEFAULT_REPORT_MD_PATH)
|
||||
parser.add_argument("--report-json", type=Path, default=DEFAULT_REPORT_JSON_PATH)
|
||||
return parser.parse_args()
|
||||
|
||||
|
||||
def main() -> None:
|
||||
global AUDIT_NAME
|
||||
global ORIGINAL_STYLE_PATH
|
||||
global ENGINEERING_STYLE_PATH
|
||||
global ORIGINAL_TILE_ROOT
|
||||
global ENGINEERING_TILE_ROOT
|
||||
global REPORT_MD_PATH
|
||||
global REPORT_JSON_PATH
|
||||
|
||||
args = parse_args()
|
||||
AUDIT_NAME = args.audit_name
|
||||
ORIGINAL_STYLE_PATH = args.original_style
|
||||
ENGINEERING_STYLE_PATH = args.engineering_style
|
||||
ORIGINAL_TILE_ROOT = args.original_tile_root
|
||||
ENGINEERING_TILE_ROOT = args.engineering_tile_root
|
||||
REPORT_MD_PATH = args.report_md
|
||||
REPORT_JSON_PATH = args.report_json
|
||||
|
||||
original_style = load_style(ORIGINAL_STYLE_PATH)
|
||||
engineering_style = load_style(ENGINEERING_STYLE_PATH)
|
||||
engineering_tiles = iter_tile_paths(ENGINEERING_TILE_ROOT)
|
||||
|
||||
original_count = 0
|
||||
engineering_count = 0
|
||||
result_count = 0
|
||||
status_counter: Counter[str] = Counter()
|
||||
source_layer_counter: Counter[tuple[str, str]] = Counter()
|
||||
mismatch_examples: list[dict[str, Any]] = []
|
||||
|
||||
with db_connect() as conn:
|
||||
with conn.cursor() as cur:
|
||||
ensure_audit_tables(cur)
|
||||
cur.execute("DELETE FROM navsea_render_audit_result")
|
||||
cur.execute("DELETE FROM navsea_render_audit_run")
|
||||
conn.commit()
|
||||
|
||||
rows: list[tuple[Any, ...]] = []
|
||||
for engineering_tile in engineering_tiles:
|
||||
rel = engineering_tile.relative_to(ENGINEERING_TILE_ROOT)
|
||||
original_tile = ORIGINAL_TILE_ROOT / rel
|
||||
if not original_tile.exists():
|
||||
continue
|
||||
|
||||
original_instances = decode_tile_instances("original", ORIGINAL_TILE_ROOT, original_style, original_tile)
|
||||
engineering_instances = decode_tile_instances(
|
||||
"engineering", ENGINEERING_TILE_ROOT, engineering_style, engineering_tile
|
||||
)
|
||||
original_count += len(original_instances)
|
||||
engineering_count += len(engineering_instances)
|
||||
|
||||
all_instance_ids = sorted(set(original_instances) | set(engineering_instances))
|
||||
for instance_id in all_instance_ids:
|
||||
item = compare_instance(original_instances.get(instance_id), engineering_instances.get(instance_id))
|
||||
result_count += 1
|
||||
status_counter[item["status"]] += 1
|
||||
if item["status"] != "exact_match":
|
||||
source_layer_counter[(item["status"], item["source_layer"] or "unknown")] += 1
|
||||
if len(mismatch_examples) < MAX_EXAMPLES:
|
||||
mismatch_examples.append(item)
|
||||
|
||||
rows.append(
|
||||
(
|
||||
AUDIT_NAME,
|
||||
hash_text(item["object_instance_id"]),
|
||||
item["object_instance_id"],
|
||||
item["object_id"],
|
||||
item["fid_legacy"],
|
||||
item["tile_z"],
|
||||
item["tile_x"],
|
||||
item["tile_y"],
|
||||
item["source_layer"],
|
||||
item["canonical_object_type"],
|
||||
item["status"],
|
||||
json.dumps(item["original_components"], ensure_ascii=False),
|
||||
json.dumps(item["engineering_components"], ensure_ascii=False),
|
||||
)
|
||||
)
|
||||
if len(rows) >= DB_BATCH_SIZE:
|
||||
insert_result_batch(cur, rows)
|
||||
conn.commit()
|
||||
rows.clear()
|
||||
|
||||
insert_result_batch(cur, rows)
|
||||
persist_audit_run(
|
||||
cur,
|
||||
original_count=original_count,
|
||||
engineering_count=engineering_count,
|
||||
result_count=result_count,
|
||||
status_counter=status_counter,
|
||||
source_layer_counter=source_layer_counter,
|
||||
)
|
||||
conn.commit()
|
||||
|
||||
write_reports(
|
||||
original_count=original_count,
|
||||
engineering_count=engineering_count,
|
||||
result_count=result_count,
|
||||
status_counter=status_counter,
|
||||
source_layer_counter=source_layer_counter,
|
||||
mismatch_examples=mismatch_examples,
|
||||
)
|
||||
print(
|
||||
json.dumps(
|
||||
{
|
||||
"original_feature_instances": original_count,
|
||||
"engineering_feature_instances": engineering_count,
|
||||
"results": result_count,
|
||||
"report_md": str(REPORT_MD_PATH),
|
||||
"report_json": str(REPORT_JSON_PATH),
|
||||
"audit_name": AUDIT_NAME,
|
||||
"db_run_table": "navsea_render_audit_run",
|
||||
"db_result_table": "navsea_render_audit_result",
|
||||
},
|
||||
ensure_ascii=False,
|
||||
indent=2,
|
||||
)
|
||||
)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in New Issue
Block a user