Files

2.7 KiB
Raw Permalink Blame History

环境配置

主场景回放与杯身中段搜索使用 Python 3.12 + venv:

python3.12 -m venv .venv
.venv/bin/python -m pip install -r requirements-sim.txt
.venv/bin/python scripts/prepare_snapshot.py

Ubuntu 系统组件:python3.12-venv、libgl1、libegl1、libglfw3。图形回放需要桌面显示;无头模型检查使用 MUJOCO_GL=egl。

可选工具

用途 安装
网格检查、几何构建 .venv/bin/python -m pip install -r requirements-geometry.txt
D405 采集 .venv/bin/python -m pip install -r requirements-camera.txt
旧 mink 抓取演示 .venv/bin/python -m pip install -r requirements-demo.txt
STEP 转网格 .venv/bin/python -m pip install -r requirements-cad.txt
历史控制器/手部工具 .venv/bin/python -m pip install -r requirements-controller.txt

旧演示依赖已固定版本;CAD 依赖按上游解析,尚未完成各可选环境的全新安装验证;历史硬件工具不属于默认仿真流程,不应为环境检查而运行。

HUG 推理使用其自身兼容 venv、源码与 hug_full.safetensors;MANO 按提供方条件取得。重定向可单独创建 Python 3.12 的 .retarget 环境,安装 requirements-retarget.txt,并准备 retarget_l20_v2.py 及其配置。回放现有候选无需这些工具。

可选资源配置

在运行相关入口前 export 对应变量;Python 工具的相对配置以仓库根目录为基准。config/local.env.example 提供示例。

变量 默认位置/用途
HUG_ROOT external/hug;HUG 源码
HUG_PYTHON HUG_ROOT/.venv/bin/python
HUG_CHECKPOINT HUG_ROOT/checkpoints/hug_full.safetensors
RETARGET_PYTHON .retarget/bin/python
RETARGETING_ROOT external/retargeting,需含 l20/retarget_l20_v2.py 和 config/l20
LINKERHAND_SDK_ROOT external/linkerhand-python-sdk;仅历史映射工具使用
P7_SCENE_XML external/p7_bimanual/model.xml;旧场景构建器使用,旁边需有 meta.json,可由 wasm-bimanual-grasp 的 P7 场景提供
G20_LEFT_TABLE assets/L20/LEFT/g20_left_G20.json;当前设备标定,不可直接套用其他设备
CALIBRATED_LEFT_URDF external/calibrated_left/linkerhand_g20_left.urdf;离线标定诊断专用,需相邻网格,缺失时不替换成未标定模型
REFERENCE_LEFT_URDF external/reference/l20_left_with_tips.urdf;独立坐标对比基准
HAND_ADAPTER_STEP external/hand_adapter.STEP;重新测量法兰时使用
A7_SDK_LIBRARY external/a7_sdk/liblbot_api_cpp.so.1.0.5;可选厂家库
A7_BRIDGE_SETUP 现场 ROS 桥的 setup.bash;仅相关历史硬件工具使用

外部源码、权重、参考标定模型和 SDK 需另外提供。修改路径不会改变模型物理参数或控制保护。