massive-cloud/alg/delivery_v1.1/coupler_panel_release/README.md

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