Files
SkillFactory/docs/contact_cycle_runtime.md
T

4.5 KiB
Raw Blame History

运行与CPU回归:Go2 FL参考+残差

当前实测基线为0.4.2解析S1,公开生命周期与命令见API。本文件仅保留实现边界和测试入口,不重复历次运行过程。

固定物理与动作合同

  • 浮动根Go2 FL单腿,3kg合成负载/传感载体;有效系统约5.388kg,W指系统重量,不只负载重量。有界XY/转动辅助,竖直guide必须为0;使用仿真真值,不是无辅助平衡。
  • 物理/失败检查500Hz,控制100Hz;名义9秒周期:承重3s、卸载1s、抬腿0.6s、摆动1.4s、落地0.8s、重新承重2.2s。
  • 默认位移[0.025,0.02,0]m,净空0.05m+0.01m拱高。当前功能版本根XY30mm仅诊断,历史严格P1/RootXY仍按30mm判失败。
  • 46D float32有限值观察,不能加载旧32D策略。索引0–31为原传感/命令;32–34根位置误差,35–37根速度误差;38接触Fn、39足端gap;40–42下一步归一化参考;43–45上一步夹紧请求残差。
  • 原IK/载荷补偿参考只在reset或控制边界推进,不因读取观察推进。三维请求夹到±1,对应每关节±0.05rad,再投影至关节范围;投影不能扩大实际残差。
  • 分别记录reference_used/next、residual_request、effective_residual与实际目标;PPO概率针对采样latent,不针对合成关节目标。解析是零残差,u256是冻结确定性残差加同一解析参考。
  • 接触获取200ms内达到≥0.5W持续10ms且gap≤0.5mm;离地on/off为1/0.5mm、dwell10ms。原有限性、关节/力矩/速度、辅助及失控保护保持。
  • SI单位;对外四元数xyzw,与后端显式转换。力/力矩坐标系和作用点明确,唯一COM外力合成入口,不重复叠加r×F或把辅助力当接触力。
  • 无周期reset、pose写入、重锚、轨迹拼接/抽稀。失败保留首个来源及部分轨迹;timeout用reset前终端观察bootstrap,真实失败为0。

实现入口

用途 仓库路径
公开Python/CLI scripts/go2_fl_skill.py,scripts/examples/go2_fl_skill_v4.py
命令/配对/邮箱/绑定 source/SkillFactory/SkillFactory/legs/contact_cycle_sim/skill_*v4.py
环境、逐步安全/记录/GUI/性能 source/SkillFactory/SkillFactory/tasks/manager_based/contact_cycle_sim/
配置 configs/contact_cycle/;资产规格configs/legs/
冻结只读加载/回放 legs/contact_cycle_sim/replay.py、scripts/replay_cycle_sim_residual.py
只读功能审计 scripts/audit_cycle_functional_flow.py、audit_contact_cycle_functional.py
监督/归属/监控 scripts/skill_launch_v4.py及继承的functional/rootxy监督工具;监控合同

旧32D训练、46D训练、RootXY入口均保留为实现/冻结输入,但不作为当前任务自动执行。u64不可替代原u256。

CPU测试

在仓库根执行,无GPU/Kit/训练:

CUDA_VISIBLE_DEVICES='' PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 \
 /home/cen/miniconda3/envs/linker_sim_isaac/bin/python scripts/test_cpu.py

# 单项定位;不改变默认测试集/断言
CUDA_VISIBLE_DEVICES='' PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 \
 /home/cen/miniconda3/envs/linker_sim_isaac/bin/python scripts/test_cpu.py \
 tests/test_contact_cycle_live_cadence_v042.py

/usr/bin/python3.12 scripts/go2_fl_skill.py validate
CUDA_VISIBLE_DEVICES='' /home/cen/miniconda3/envs/linker_sim_isaac/bin/python \
 scripts/go2_fl_skill.py validate --verify-frozen

test_cpu.py仅在测试进程映射SkillFactory包以跳过顶层Kit任务注册,运行保留的tests/;不可用于运行绑定。默认关闭外部pytest插件和物理集成opt-in;被skip的PhysX测试不是物理通过。旧发布/旧32D分支测试见归档,冻结manifest/运行绑定所需测试仍在原路径。

当前CPU环境为Python3.11/Torch2.7;真实运行是固定/home/cen/IsaacLab、/home/cen/isaacsim-6.0.1及RTX5080,不混为同一依赖资格。部分测试只读本机冻结快照或安装源,缺失/skip不能证明新机器已具备资格。pyproject.toml将默认收集范围限制为tests/,避免扫描logs/、sealed包或暂存目录;直接运行pytest仍须具备相应包/依赖。

不得在根目录uv sync或修改外部IsaacLab/Unitree资源来凑测试通过。CPU测试不调用Kit;真实新运行另按执行边界登记、绑定、监督与清理。通用supervise_sim.py不能替代当前认证入口。