62 lines
1.4 KiB
Markdown
62 lines
1.4 KiB
Markdown
# 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 节。
|