Update README.md

f29b6c9d · zhanggezhong · 641938fd · f29b6c9d
Commit f29b6c9d authored Jun 03, 2025 by zhanggezhong
Show whitespace changes
Inline Side-by-side

Showing with 70 additions and 28 deletions

README.md README.md +70 -28

No files found.
--- a/README.md
+++ b/README.md
 # <div align="center"><strong>MMDetection3D</strong></div>
 ## 简介
 MMDetection3D 是一个基于 PyTorch 的目标检测开源工具箱, 下一代面向3D检测的平台. 它是 OpenMMlab 项目的一部分，这个项目由香港中文大学多媒体实验室和商汤科技联合发起.
+
 ## 安装
-  源码编译安装，该方式需要安装torch及fastpt工具包；注意使用fastpt包进行源码编译安装时，要严格匹配fastpt、torch、dtk之间的版本号，例如基于dtk2504编译，则fastpt、torch都必须是dtk2504的包，其中fastpt与torch对应的版本号关系为
-|   | fastpt版本 | torch版本    | DTK版本 | 
-| - | -------- | ------- | ------------ | 
-| 1 | 2.0.1+das.dtk2504   | v2.4.1 |  dtk2504| 
-| 1 | 2.1.0+das.dtk2504   | v2.5.1 |  dtk2504| 
-| 1 | 2.0.1+das.dtk25041   | v2.4.1 |  dtk25041| 
-| 1 | 2.1.0+das.dtk25041   | v2.5.1 |  dtk25041| 
-
-### 编译流程
-  ```
-  pip3 install -r requirements.txt
-  pip3 install fastpt-2.0.1+das.dtk2504-py3-none-any.whl #以torch2.4.1，dtk2504为例
-  git clone https://developer.sourcefind.cn/codes/OpenDAS/mmdetection3d.git
-  cd mmdetection3d
-  git checkout v1.4.0-fastpt #切换到相应分支
-  source  /usr/local/bin/fastpt -c
-  python3 setup.py bdist_wheel
-  ```
-## 验证安装
+组件支持组合
+
+   | PyTorch版本 | fastpt版本  |mmdet3d版本      | DTK版本                  | Python版本       | 推荐编译方式 |
+   | ----------- | ----------- | ----------- | ------------------------ | -----------------| ------------ |
+   | 2.5.1       | 2.1.0       |1.4.0        | >= 25.04                 | 3.8、3.10、3.11  | fastpt不转码 |
+   | 2.4.1       | 2.0.1       |1.4.0        | >= 25.04                 | 3.8、3.10、3.11  | fastpt不转码 |
+   
+
+ pytorch版本大于2.4.1 && dtk版本大于25.04 推荐使用fastpt不转码编译。
+
+### 1、使用pip方式安装
+mmdet3d whl包下载目录：[光和开发者社区](https://download.sourcefind.cn:65024/4/main/fastmoe)，选择对应的pytorch版本和python版本下载对应mmdet3d的whl包
+```shell
+pip install torch* (下载torch的whl包)
+pip install fastpt* --no-deps (下载fastpt的whl包)
+source  /usr/local/bin/fastpt -E
+pip install fastmoe* (下载的mmdet3d的whl包)
 ```
-pip3 list | grep unicore
-python3
-import mmdet3d
-mmdet3d.__version__
-#返回版本号
+### 2、使用源码编译方式安装
+
+#### 编译环境准备
+提供基于fastpt不转码编译：
+
+1. 基于光源pytorch基础镜像环境：镜像下载地址：[光合开发者社区](https://sourcefind.cn/#/image/dcu/pytorch)，根据pytorch、python、dtk及系统下载对应的镜像版本。
+
+2. 基于现有python环境：安装pytorch，fastpt whl包下载目录：[光合开发者社区](https://sourcefind.cn/#/image/dcu/pytorch)，根据python、dtk版本,下载对应pytorch的whl包。安装命令如下：
+```shell
+pip install torch* (下载torch的whl包)
+pip install fastpt* --no-deps (下载fastpt的whl包, 安装顺序，先安装torch，后安装fastpt)
+pip install pytest
+pip install wheel
 ```
-## 测试
+
+#### 源码编译安装
+- 代码下载
+```shell
+git clone http://developer.sourcefind.cn/codes/OpenDAS/mmdetection3d.git # 根据编译需要切换分支
+```
+- 提供2种源码编译方式（进入mmdetection3d目录）：
+```
+1. 设置不转码编译环境变量
+source /usr/local/bin/fastpt -C
+
+2. 编译whl包并安装
+python3 setup.py -v bdist_wheel
+pip install dist/mmdet3d*
+
+3. 源码编译安装
+python3 setup.py install
 ```
-source  /usr/local/bin/fastpt -e
-cd testing
-pytest vs
+#### 注意事项
+ 若使用pip install下载安装过慢，可添加pypi清华源：-i https://pypi.tuna.tsinghua.edu.cn/simple/
+ ROCM_PATH为dtk的路径，默认为/opt/dtk
+ 在pytorch2.5.1环境下编译需要支持c++17语法，打开setup.py文件，把文件中的 -std=c++14 修改为 -std=c++17

+## 验证
+```shell
+python3
+Python 3.10.12 (main, Feb  4 2025, 14:57:36) [GCC 11.4.0] on linux
+Type "help", "copyright", "credits" or "license" for more information.
+>>> import mmdet3d
+>>> mmdet3d.__version__
+'1.4.0'
+>>>
 ```
+版本号与官方版本同步，查询该软件的版本号，例如1.4.0；
+
+## Known Issue
+- 无
+
+## 参考资料
+- [README_ORIGIN](README_ORIGIN.md)
+- [README_zh-CN](README_zh-CN.md)
+- [https://github.com/open-mmlab/mmdetection3d](https://github.com/open-mmlab/mmdetection3d)