| 依赖项 | 版本要求 | 说明 |
|---|---|---|
| Python | >= 3.10 | 推荐 3.11 |
| torch / torch_npu | 2.1.0+ | NPU 上需安装 torch_npu |
| pi3 | 官方源码包 | 随 libs 目录分发(inference.py 自动注入 sys.path) |
| omegaconf / huggingface_hub / safetensors | 最新版 | 模型加载依赖 |
| opencv-python-headless / pillow / numpy | 最新版 | 图像处理与可视化 |
| plyfile | 最新版 | 点云导出(可选) |
| 昇腾驱动 | CANN 8.0.RC2+ | 推荐最新版 |
安装命令:
pip install --target /mnt/workspace/Pi3/libs -i https://pypi.tuna.tsinghua.edu.cn/simple opencv-python-headless pillow numpy plyfile huggingface_hub safetensors omegaconf
# 官方代码包已随仓库预置到 libs/pi3# 检查 NPU 设备
npu-smi info
# 权重已就位
ls /home/developer/models/Pi3/ # config.json model.safetensors README.mdPYTHONPATH=/mnt/workspace/Pi3/libs python3 inference.py --model_path /home/developer/models/Pi3| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| --model_path | str | /home/developer/models/Pi3 | 本地权重目录 |
| --device | str | 自动(npu > cuda > cpu) | 推理设备 |
| --num_frames | int | 3 | 示例输入帧数 |
| --image_size | int | 224 | 示例输入分辨率(14 的倍数) |
| --output | str | assets/model_result.png | 结果图保存路径 |
输入:
python3 inference.py --model_path /home/developer/models/Pi3输出:
[INFO] device = npu
[INFO] 模型加载完成 load_time=xx.xs
[INFO] 输入张量: (1, 3, 3, 224, 224) dtype=torch.float32
[INFO] 推理完成 耗时/elapsed=xx.xs (frames=3, size=224, device=npu)
[INFO] 全局点云形状: (3, 224, 224, 3), 置信度图形状: (3, 224, 224), 相机位姿形状: (3, 4, 4)
[RESULT] status=ok device=npu 耗时/elapsed=xx.xs输入:
python3 inference.py --model_path /home/developer/models/Pi3 --num_frames 2 --image_size 154输出:
[INFO] 输入张量: (1, 2, 3, 154, 154) dtype=torch.float32
[INFO] 推理完成 耗时/elapsed=xx.xs ...
[RESULT] status=ok device=npu 耗时/elapsed=xx.xs


pi3 以纯 Python 源码包形式随 /mnt/workspace/Pi3/libs 分发,inference.py 开头自动注入 sys.path;PyTorchModelHubMixin.from_pretrained(本地路径),权重仅从本地 --model_path 加载,推理全程离线;