coupler-panel-validation
车钩面板 CAD-STP 到点云测量验证系统。
从 CAD STP 文件出发，构造 GT、合成模拟点云、跑完整测量流水线， 对比 GT，输出实验报告与可视化。
一句话用法
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。
安装
# 仅核心计算（numpy/scipy）
pip install -e .
# 加上点云 IO + 去噪 + 配准
pip install -e ".[cloud]"
# 加上 STP 解析
pip install -e ".[cad]"
# 加上可视化
pip install -e ".[viz]"
# 全装
pip install -e ".[all]"
命令行
# 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 节。