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

alg/delivery_v1.1/coupler_panel_release/README.md

@@ -0,0 +1,61 @@
+# coupler-panel-validation
+
+车钩面板 CAD-STP 到点云测量验证系统。
+
+从 CAD STP 文件出发，构造 GT、合成模拟点云、跑完整测量流水线，
+对比 GT，输出实验报告与可视化。
+
+## 一句话用法
+
+```python
+from coupler_panel import compute_coupler_measurement, load_point_cloud
+
+points = load_point_cloud("scan.ply")            # (N, 3) ndarray, 单位 mm
+result = compute_coupler_measurement(points)
+print(result.theta_right_deg, result.theta_ref_deg)
+print(result.dx_y_max_mm, result.dx_z_max_mm)
+```
+
+完整文档见 [docs/USAGE.md](docs/USAGE.md)。
+
+## 安装
+
+```bash
+# 仅核心计算（numpy/scipy）
+pip install -e .
+
+# 加上点云 IO + 去噪 + 配准
+pip install -e ".[cloud]"
+
+# 加上 STP 解析
+pip install -e ".[cad]"
+
+# 加上可视化
+pip install -e ".[viz]"
+
+# 全装
+pip install -e ".[all]"
+```
+
+## 命令行
+
+```bash
+# 1) 已有点云，直接测量
+coupler-measure --input-cloud scan.ply --out-dir runs/demo
+
+# 2) 从 CAD STP 生成模拟点云并测量
+coupler-measure --stp panel.stp --out-dir runs/from_cad
+
+# 3) 跑参数 sweep（采样×密度×噪声×变换矩阵）
+coupler-measure --sweep configs/experiments/full_sweep.yaml --out-dir runs/sweep
+```
+
+## 坐标系约定
+
+- x = 车体纵向
+- y = 车体宽度
+- z = 车体高度
+- 单位 mm
+- 拟合面板法向 `n = (n_x, n_y, n_z)` 强制 `n_x > 0`
+
+详见 USAGE.md 第 5 节。