README.md 2.9 KB
Newer Older
chenzk's avatar
v1.0.1  
chenzk committed
1
2
# 算法名简写
英文简写
chenzk's avatar
v1.0  
chenzk committed
3
4
5
## 论文
`此处填写实现本项目的算法论文名称`
- 此处填写算法论文的在线pdf地址
liuhy's avatar
liuhy committed
6
## 模型结构
chenzk's avatar
v1.0  
chenzk committed
7
此处一句话简要介绍模型结构
liuhy's avatar
liuhy committed
8

chenzk's avatar
v1.0  
chenzk committed
9
10
11
![img](./doc/xxx.png)
## 算法原理
此处一句话简要介绍算法原理
liuhy's avatar
liuhy committed
12

chenzk's avatar
v1.0  
chenzk committed
13
14
![img](./doc/xxx.png)
## 环境配置
chenzk's avatar
v1.0.1  
chenzk committed
15
16
### Docker(方法一)
此处提供[光源](https://www.sourcefind.cn/#/service-details)拉取docker镜像的地址与使用步骤
chenzk's avatar
v1.0  
chenzk committed
17
```
chenzk's avatar
v1.0.1  
chenzk committed
18
19
docker pull xxx
docker run xxx
chenzk's avatar
v1.0  
chenzk committed
20
```
chenzk's avatar
v1.0.1  
chenzk committed
21
22
### Dockerfile(方法二)
此处提供dockerfile的使用方法
chenzk's avatar
v1.0  
chenzk committed
23
24
```
docker build --no-cache -t xxx:latest .
chenzk's avatar
v1.0.1  
chenzk committed
25
docker run xxx
chenzk's avatar
v1.0  
chenzk committed
26
```
chenzk's avatar
v1.0.1  
chenzk committed
27
28
### Anaconda(方法三)
此处提供本地配置、编译的详细步骤,例如:
liuhy's avatar
liuhy committed
29

chenzk's avatar
v1.0  
chenzk committed
30
31
32
33
34
35
36
关于本项目DCU显卡所需的特殊深度学习库可从[光合](https://developer.hpccube.com/tool/)开发者社区下载安装。
```
DTK驱动:dtk23.04
python:python3.8
paddle:2.4.2
```
`Tips:以上dtk驱动、python、paddle等DCU相关工具版本需要严格一一对应`
liuhy's avatar
liuhy committed
37

chenzk's avatar
v1.0  
chenzk committed
38
39
40
41
42
43
44
其它非深度学习库参照requirements.txt安装:
```
pip install -r requirements.txt
```
## 数据集
`此处填写公开数据集名称`
- 此处填写公开数据集下载地址
liuhy's avatar
liuhy committed
45

chenzk's avatar
v1.0  
chenzk committed
46
47
48
49
此处提供数据预处理脚本的使用方法
```
python xxx.py
```
chenzk's avatar
v1.0.1  
chenzk committed
50
项目中已提供用于试验训练的迷你数据集,训练数据目录结构如下,用于正常训练的完整数据集请按此目录结构进行制备:
chenzk's avatar
v1.0  
chenzk committed
51
52
53
54
55
56
57
58
59
60
61
62
```
 ── dataset
    │   ├── label_1
    │             ├── xxx.png
    │             ├── xxx.png
    │             └── ...
    │   └── label_2
    │             ├── xxx.png
    │             ├── xxx.png
    │             └── ...
```
## 训练
chenzk's avatar
v1.0.1  
chenzk committed
63
一般情况下,ModelZoo上的项目提供单机训练的启动方法即可,单机多卡、单机单卡至少提供其一训练方法。
chenzk's avatar
v1.0  
chenzk committed
64
65
### 单机多卡
```
chenzk's avatar
v1.0.1  
chenzk committed
66
sh xxx.sh # 或python xxx.py
chenzk's avatar
v1.0  
chenzk committed
67
```
liuhy's avatar
liuhy committed
68

chenzk's avatar
v1.0.1  
chenzk committed
69
### 单机单卡
chenzk's avatar
v1.0  
chenzk committed
70
```
chenzk's avatar
v1.0.1  
chenzk committed
71
sh xxx.sh 或python xxx.py
chenzk's avatar
v1.0  
chenzk committed
72
73
74
```
## 推理
```
chenzk's avatar
v1.0.1  
chenzk committed
75
sh xxx.sh 或python xxx.py
chenzk's avatar
v1.0  
chenzk committed
76
77
78
```
## result
此处填算法效果测试图
liuhy's avatar
liuhy committed
79

chenzk's avatar
v1.0  
chenzk committed
80
![img](./doc/xxx.png)
liuhy's avatar
liuhy committed
81

chenzk's avatar
v1.0.1  
chenzk committed
82
### 精度
liuhy's avatar
liuhy committed
83
84
测试数据:[test data](链接),使用的加速卡:xxx。

chenzk's avatar
v1.0  
chenzk committed
85
根据测试结果情况填写表格:
liuhy's avatar
liuhy committed
86
87
88
89
| xxx | xxx | xxx | xxx | xxx |
| :------: | :------: | :------: | :------: |:------: |
| xxx | xxx | xxx | xxx | xxx  |
| xxx | xx | xxx | xxx | xxx |
chenzk's avatar
v1.0  
chenzk committed
90
91
92
93
94
## 应用场景
### 算法类别
参考此分类方法(上传时请去除参考图片):
![img](./doc/classes.png)
`此处填算法类别`
chenzk's avatar
v1.0.1  
chenzk committed
95
96
97
### 热点应用行业
应用行业的填写需要做大量调研,从而为使用者提供专业、全面的推荐,除特殊算法,通常推荐数量>=3。

chenzk's avatar
v1.0  
chenzk committed
98
99
100
`此处填应用行业`
## 预训练权重
`(若为github原预训练权重此标题可去除。)`
101
## 源码仓库及问题反馈
chenzk's avatar
v1.0  
chenzk committed
102
103
- 此处填本项目gitlab地址
## 参考资料
chenzk's avatar
v1.0.1  
chenzk committed
104
- 此处填源github地址(方便使用者查看原github issue)
chenzk's avatar
v1.0  
chenzk committed
105
106
- 此处填参考项目或教程网址
- ......