Aislo/B06_Section/B06_Section_Engine_Tilt.py

"""구조물 자리 기울기 — 물넘이포장 · 맹암거 측점의 노면(287-4 · 288-1).

그 자리 횡단 설계 = 측구 없음 · 노면 = 한 경사로 지대 낮은 쪽(`compute_cross_design(tilted=…,
tilt_pct=…)`). 경사 = 물넘이 경사각도(%) · 맹암거 = 표준 횡단경사(암거 경사는 형상 하단 · 371-3).
  · 물넘이포장 = 관 지점 정본(pipe_points) 범위(기준 ± 월류 폭/2).
  · 맹암거 = 구조물 정본(structures.json) A군 점형 · 기준 측점 한 곳 — 횡단 dict 에
    `underdrain`(높이 · 경사)을 얹어 횡단도가 돌 무늬 형상을 그림(TS 짝
    `common_util_structure_underdrain.ts`).
판정 폭 = 포장 범위와 같은 0.02 m(`paved_at`).
짝(349-0n): `tilt_ranges` · `tilt_args` ↔ `B06_Section/logic/B06_Section_Cross_Enforce.ts`
(거울 시험 `test_349_0n_cross_enforce_mirror.py`).
남는 까닭(511-B B-6) — 얹기 = GET 형상 Node `facility.attach` · 이 짝 = Node 못 부를
때(`_attach_python`) · 파이썬 횡단 설계 폴백 기울기.
"""

from __future__ import annotations

import logging
from pathlib import Path
from typing import Any

from B05_Profile.B05_Profile_Structures_Repository import load_structures
from B06_Section.B06_Section_Engine_Culvert_Sets import load_culvert_sets
from common_util.common_util_structure_catalog import catalog_row
from common_util.common_util_structure_station import EDGE_TOLERANCE_M

logger = logging.getLogger(__name__)

_EDGE_TOLERANCE_M = EDGE_TOLERANCE_M

TiltRange = tuple[float, float, float | None]


def _number(value: Any) -> float | None:
    try:
        parsed = float(value)
    except (TypeError, ValueError):
        return None
    return parsed if parsed == parsed else None


def load_underdrains(project_root: Path) -> list[dict[str, Any]]:
    """구조물 정본의 맹암거 — `{structure_id, chainage_m, height_m, slope_pct}` ·
    실패하면 빈 목록."""
    try:
        structures = load_structures(str(project_root))[1]
    except Exception:  # noqa: BLE001 — 정본을 못 읽어도 설계 계산은 이어 간다
        logger.exception("B06 맹암거를 읽지 못했습니다 (없음으로 본다)")
        return []
    return underdrains_from(structures)


def underdrains_from(structures: list[Any]) -> list[dict[str, Any]]:
    """구조물 목록의 맹암거 제원(TS `underdrainSpecsFrom` 짝 · 형상 얹기 한 벌 323-4)."""
    found: list[dict[str, Any]] = []
    for structure in structures:
        if (catalog_row(structure.type_id) or {}).get("shape") != "underdrain":
            continue
        options = structure.options or {}
        height = _number(options.get("culvert_height_m"))
        slope = _number(options.get("culvert_slope_pct"))
        found.append(
            {
                "structure_id": structure.structure_id,
                "chainage_m": float(structure.anchor_m()),
                "height_m": height if height and height > 0 else None,
                "slope_pct": slope if slope and slope > 0 else None,
            }
        )
    return found


def tilt_ranges(project_root: Path | None) -> list[TiltRange]:
    """측구 없이 노면을 지대 낮은 쪽 한 경사로 기울이는 자리 — (시작, 끝, 경사 %)."""
    if project_root is None:
        return []
    out: list[TiltRange] = []
    for at, spec in load_culvert_sets(project_root).items():
        if spec.get("type") == "ford_pavement":
            half = float(spec.get("span_m") or 0.0) / 2.0
            out.append((at - half, at + half, spec.get("slope_pct")))
    for drain in load_underdrains(project_root):
        # 노면 = 표준 경사 · 암거 경사는 맹암거 하단 경계만(371-3 · TS `facilityRanges` 짝)
        out.append((drain["chainage_m"], drain["chainage_m"], None))
    return out


def tilt_args(chainage_m: float, ranges: list[TiltRange]) -> dict[str, Any]:
    """그 측점의 구조물 자리 기울기 — `compute_cross_design(**...)` 로 넘김 ·
    저장분 짝 `stored_tilt`."""
    tol = _EDGE_TOLERANCE_M
    hit = next((r for r in ranges if r[0] - tol <= chainage_m <= r[1] + tol), None)
    pct = hit[2] if hit else None
    return {"tilted": hit is not None, "tilt_pct": float(pct) if pct is not None else None}


def attach_underdrain_specs(
    cross_sections: list[dict[str, Any]], drains: list[dict[str, Any]]
) -> int:
    """기준 측점에 맹암거 제원을 얹는다(TS `attachUnderdrainSpecs` 짝). 얹은 개수를 돌려준다."""
    attached = 0
    for section in cross_sections:
        chainage = _number(section.get("chainage_m"))
        if chainage is None:
            continue
        hit = next(
            (d for d in drains if abs(d["chainage_m"] - chainage) <= _EDGE_TOLERANCE_M), None
        )
        if hit:
            section["underdrain"] = dict(hit)
            attached += 1
    return attached