feat: initial commit - massive-cloud point cloud processing system

alg/delivery_v1.1/coupler_panel_release/examples/integrate_minimal.py

@@ -0,0 +1,58 @@
+"""Minimal integration example for software developers.
+
+This script shows the *only* code path a production caller needs:
+
+    load a clean, registered point cloud → call the API → use the result
+
+Run::
+
+    python examples/integrate_minimal.py path/to/scan.ply
+"""
+
+from __future__ import annotations
+
+import logging
+import sys
+from pathlib import Path
+
+from coupler_panel import (
+    CouplerError,
+    compute_coupler_measurement,
+    load_point_cloud,
+)
+
+
+def main(input_path: Path) -> int:
+    logging.basicConfig(level=logging.INFO, format="%(levelname)s %(name)s: %(message)s")
+    log = logging.getLogger("integrate_minimal")
+
+    points = load_point_cloud(input_path)
+    log.info("loaded %d points from %s", points.shape[0], input_path)
+
+    try:
+        result = compute_coupler_measurement(
+            points,
+            progress=lambda s, f: log.info("[%5.1f%%] %s", f * 100, s),
+        )
+    except CouplerError as exc:
+        log.error("measurement failed: %s", exc)
+        return 2
+
+    print(f"theta_right_deg = {result.theta_right_deg:+.4f}")
+    print(f"theta_ref_deg   = {result.theta_ref_deg:+.4f}")
+    print(f"D_y_max_mm      = {result.D_y_max_mm:.3f}")
+    print(f"D_z_max_mm      = {result.D_z_max_mm:.3f}")
+    print(f"dx_y_max_mm     = {result.dx_y_max_mm:.3f}")
+    print(f"dx_z_max_mm     = {result.dx_z_max_mm:.3f}")
+    print(f"center_C        = {tuple(round(c, 3) for c in result.center_C)}")
+    print(f"normal          = {tuple(round(c, 6) for c in result.normal)}")
+    print(f"quality_flags   = {result.quality_flags}")
+
+    return 0
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        print(__doc__.strip())
+        sys.exit(1)
+    sys.exit(main(Path(sys.argv[1])))