48 lines
2.7 KiB
Markdown
48 lines
2.7 KiB
Markdown
# 环境配置
|
||
|
||
主场景回放与杯身中段搜索使用 Python 3.12 + venv:
|
||
|
||
~~~bash
|
||
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 需另外提供。修改路径不会改变模型物理参数或控制保护。
|