Files

48 lines
2.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 环境配置
主场景回放与杯身中段搜索使用 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 需另外提供。修改路径不会改变模型物理参数或控制保护。