Files
Robot_Arm/tests/test_harness_collision.py
T
cbb 531a293688 refactor(viewer): 单文件查看器拆成 webapp/ 多文件,走本地 http;Worker 换成真文件
前端不再是"一个 16MB HTML + 一个 2955 行模板"。现在:
  webapp/index.html      343 行 DOM 骨架,零内联数据
  webapp/styles/*.css    811 行 CSS 按段切成 8 个文件
  webapp/js/app.js       原内联主脚本逐字搬出(仍是普通脚本,S5 才改 ESM)
  webapp/js/ik-solver.js / ik-glue.js / vendor/three.min.js(原 web/ 三个文件)
  webapp/workers/ik.worker.js  真 Worker 文件
  webapp/generated/00_data.js  生成物(网格/工程图/行程/碰撞/螺钉)
  dist/机器人手臂3D查看器.html  分发用单文件,由 build_viewer 内联上面这些文件产出

入口:python -m arm.viewer.serve 后开 http://127.0.0.1:8123/
(serve 带 no-store,改完刷新即新构建,不再需要 Ctrl+F5;显式 MIME,
 .js 被 Windows 注册表判成 text/plain 会让模块静默不执行)

删掉 src/viewer_tpl.html 与 web/ 目录(旧产物移入 backups/pre_split_20261015/)。
工程图不再维护第二份 sheets.jsdata —— 直接读 draw_sheet 写出的 4 个真 SVG。

实测中修掉的问题:
- serve 的 / 原先"内部映射"到 webapp/index.html,导致文档基址是 /、相对路径的
  8 个 CSS 与 4 个 JS 全部 404(整页无样式无脚本)。改成 302 跳转。
- file:// 下 new Worker('workers/…') 构造阶段不抛错、错误以异步 onerror 到达,
  所以"构造失败才试 Blob 兜底"永远不会触发;改为按协议选路。两条路径都已实测
  backend=worker(http 走文件、file:// 走 Blob)。
- Worker 握手 3s 在 headless 并发下会误判"没起来"(截图里红徽标即此),放宽到 10s,
  并把后端状态暴露成 window.__IK_BACKEND / __IK_BACKEND_LOG 供测试直读。
- 截图竞态:4 并发 × 每页 14MB 数据时,虚拟时间预算会在页面加载完成前到期,
  拍到半初始化画面(且能"稳定地坏",旧基线里 m9_motion 就是这么混进来的)。
  并发降到 2、预算 40s、serve 加 HTTP/1.1+大缓冲+字节缓存,并用"同一构建两轮"
  重新界定稳定性:99 张逐字节一致、6 张属噪声改走像素容差(mean<=0.02、单像素<=32)。
- 关卡自身两处假通过已修:node 输出被 GBK 解码炸掉时不再算 PASS;
  线束干涉测试读不到通道源码时会 exit 2,而不是"零通道=零穿透=通过"。

关卡结果:python -m arm.build_model 退出码 0;10 项数据哈希与基线一致;
IK exact 段逐字节一致;99 张截图逐字节一致 + 6 张在噪声阈内;线束干涉测试 1800 点 0 穿透。
2026-10-15 04:31:31 +08:00

122 lines
5.7 KiB
Python

# -*- coding: utf-8 -*-
"""
Automated 3D Wire Harness Collision Verification Suite:
Validates that every wire segment and flexible bridge in the robot arm
passes strictly through dedicated hollow channels and enlarged 22x22mm pass-through holes
with ZERO solid penetrations (BRepClass3d_SolidClassifier against OCC STEP solids).
"""
import sys, io, os, re
sys.stdout.reconfigure(encoding='utf-8')
import numpy as np
import cadquery as cq
from OCP.BRepClass3d import BRepClass3d_SolidClassifier
from OCP.gp import gp_Pnt
from OCP.TopAbs import TopAbs_IN
def catmull_rom_sample(pts, num_samples_per_seg=25):
pts = np.array(pts, dtype=float)
if len(pts) == 2:
t = np.linspace(0, 1, num_samples_per_seg)
return [(1-s)*pts[0] + s*pts[1] for s in t]
sampled = []
p = np.vstack([pts[0], pts, pts[-1]])
for i in range(1, len(p) - 2):
p0, p1, p2, p3 = p[i-1], p[i], p[i+1], p[i+2]
for t in np.linspace(0, 1, num_samples_per_seg, endpoint=(i == len(p)-3)):
t2, t3 = t*t, t*t*t
val = 0.5 * ((2*p1) + (-p0 + p2)*t + (2*p0 - 5*p1 + 4*p2 - p3)*t2 + (-p0 + 3*p1 - 3*p2 + p3)*t3)
sampled.append(val)
return sampled
def load_solids():
clfs = {}
for f in os.listdir('out/parts_step'):
if f.endswith('.step'):
tag = f.split('.')[0]
print(f"Loading {tag}...", flush=True)
shape = cq.importers.importStep(os.path.join('out/parts_step', f)).val()
clfs[tag] = BRepClass3d_SolidClassifier(shape.wrapped)
return clfs
def main():
clfs = load_solids()
print("=" * 80)
print("【线束三维物理干涉检测】全通道、外侧走线与电机全固态零碰撞验证")
print("=" * 80)
# 线束通道的锚点坐标写在查看器源码里(现在是模板,拆分后是 webapp/js/harness.js)。
# 扫候选文件而不是写死一个路径,前端拆分时这条检查不用跟着改;一个都找不到就直接失败,
# 绝不能"没匹配到 = 没有通道 = 零干涉"地假通过。
from arm.paths import REPO
cands = [REPO + "/webapp/js/harness.js", REPO + "/webapp/js/app.js"]
found = [c for c in cands if os.path.exists(c)]
if not found:
print("找不到线束源码,检查项无法执行:", cands, flush=True)
sys.exit(2)
with open(found[0], 'r', encoding='utf-8') as f:
tpl = f.read()
tube_matches = re.findall(r'makeHarnTube\(\[\s*([\s\S]*?)\s*\]\s*,\s*[\d\.]+\s*,\s*\w+\s*,\s*\'([^\']+)\'', tpl)
# 读到 0 个通道会被下面当成"零穿透"而 PASS —— 那是假通过,必须先炸。
if not tube_matches:
print("找不到任何线束通道定义,源码结构变了:", cands)
sys.exit(2)
total_hits = 0
checked_count = 0
for raw_pts, name in tube_matches:
pt_list = []
for m in re.finditer(r'\[\s*([-\d\.]+)\s*,\s*([-\d\.]+)\s*,\s*([-\d\.]+)\s*\]', raw_pts):
pt_list.append([float(m.group(1)), float(m.group(2)), float(m.group(3))])
sampled = catmull_rom_sample(pt_list, num_samples_per_seg=25)
hits = []
for p in sampled:
pt = gp_Pnt(float(p[0]), float(p[1]), float(p[2]))
for part, clf in clfs.items():
clf.Perform(pt, 1e-3)
if clf.State() == TopAbs_IN:
hits.append((part, p))
checked_count += len(sampled)
if hits:
total_hits += len(hits)
print(f" ❌ FAIL: {name} (发现 {len(hits)} 处实体穿透! 首击穿部件: {hits[0][0]} 坐标: {hits[0][1]})", flush=True)
else:
print(f" ✓ PASS: {name} ({len(sampled)} 采样点零干涉)", flush=True)
# Test dynamic bridges at zero pose
bridge_specs = [
('Bridge 1 (J1 Ω-Loop 柔性缓冲段)', [[5.5, 86.1, 610.0], [9.13, 79.4, 611.9], [12.75, 76.78, 613.5], [16.38, 79.85, 614.4], [20.0, 87.0, 615.0]]),
('Bridge 2 (J2 U-Loop 柔性缓冲段)', [[-17.5, 102.5, 485.0], [-25.0, 102.5, 475.0], [-30.0, 102.5, 465.0], [-25.0, 102.5, 455.0], [-17.5, 102.5, 445.0]]),
('Bridge 3 (J3 螺旋柔性过渡段)', [[-17.5, 102.5, 400.0], [-24.0, 96.0, 390.0], [-27.0, 93.0, 380.0], [-23.0, 96.0, 370.0], [-17.5, 102.5, 360.0]]),
('Bridge 4 (J4 肘部U-Loop柔性缓冲段)', [[-17.5, 102.5, 305.0], [-24.0, 102.5, 290.0], [-30.0, 102.5, 280.0], [-24.0, 102.5, 270.0], [-17.5, 102.5, 255.0]]),
('Bridge 5 (J5 腕部U-Loop柔性缓冲段)', [[-17.5, 102.5, 205.0], [-22.0, 102.5, 195.0], [-26.0, 102.5, 190.0], [-22.0, 102.5, 182.0], [-17.5, 102.5, 175.0]]),
]
for name, pts in bridge_specs:
sampled = catmull_rom_sample(pts, num_samples_per_seg=25)
hits = []
for p in sampled:
pt = gp_Pnt(float(p[0]), float(p[1]), float(p[2]))
for part, clf in clfs.items():
clf.Perform(pt, 1e-3)
if clf.State() == TopAbs_IN:
hits.append((part, p))
checked_count += len(sampled)
if hits:
total_hits += len(hits)
print(f" ❌ FAIL: {name} (发现 {len(hits)} 处实体穿透!)", flush=True)
else:
print(f" ✓ PASS: {name} ({len(sampled)} 采样点零干涉)", flush=True)
print("=" * 80, flush=True)
print(f"【最终结论】共评估 {checked_count} 个空间采样点,固体穿透总数: {total_hits}", flush=True)
if total_hits == 0:
print("🎉 恭喜!线束系统已实现 100% 结构腔体内规范走线与零碰撞干涉!", flush=True)
print("=" * 80, flush=True)
sys.stdout.flush()
# 同上:OCC 析构会段错误,所以用 os._exit 带走正确退出码
os._exit(0 if total_hits == 0 else 1)
if __name__ == '__main__':
main()