# 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 节。