ModelZooStd.md 2.79 KB
Newer Older
liuhy's avatar
liuhy committed
1
# 仓库目录结构
chenzk's avatar
v1.0  
chenzk committed
2
3
* 除预训练模型外其他文件总大小尽量不要超过50M
```
liuhy's avatar
liuhy committed
4
    Project
chenzk's avatar
v1.0  
chenzk committed
5
6
7
8
9
10
11
12
    ├── dataset
    │   ├── label_1
    │             ├── xxx.png
    │             ├── xxx.png
    │             └── ...
    │   └── label_2
    │             ├── xxx.png
    │             ├── xxx.png
chenych's avatar
chenych committed
13
    │             └── ...
liuhy's avatar
liuhy committed
14
    ├── model
chenych's avatar
chenych committed
15
    │   ├── xxx.pth #预训练模型
liuhy's avatar
liuhy committed
16
17
    │   ├── xxx.onnx #对应的onnx模型
    │   └── xxx.mxr #对应的migraphx离线推理模型
chenzk's avatar
v1.0  
chenzk committed
18
19
20
21
    ├── doc
    │   ├── icon.png
    │   ├── xxx.png
    │   └── xxx.png
liuhy's avatar
liuhy committed
22
23
24
25
26
27
28
29
30
31
    ├── README.md
    ├── requirement.txt
    ├── model.properties
    ├── code_file1.py
    ├── code_file2.py
    ├── code_file3.py
    ├── dirs
    │   ├── code_file4.py
    │   ├── code_file5.py
    └── └── code_file6.py
chenzk's avatar
v1.0  
chenzk committed
32
```
chenzk's avatar
chenzk committed
33

chenych's avatar
chenych committed
34
* icon.png:模型的图标文件,上传者需放至项目根目录供前端读取,所需算法类别图标可到 [飞书->云文档->云盘->icon](https://r0ddbu55vzx.feishu.cn/drive/folder/AgoUfBk5IlYTV1dBz2YcGSYUnDf) 查找,放入仓库后的图标文件,需要将名称从`类别名称`修改为`icon`,如`OCR.png`修改为`icon.png`。当前没有所需算法类别图标则提交设计申请即可。
chenzk's avatar
chenzk committed
35
36
![icon](./icon.png)

chenych's avatar
chenych committed
37
* README.md:参照下图,`十二大标题`为必选项,二级标题以下的标题或内容根据自己的项目灵活增删。
chenzk's avatar
v1.0  
chenzk committed
38
![img](./doc/readme.png)
chenzk's avatar
chenzk committed
39

chenzk's avatar
v1.0  
chenzk committed
40
* requirement.txt:模型依赖统一写到此文件,与深度学习相关的库请注释,以免安装为nv库。
chenzk's avatar
chenzk committed
41
42
43
```
说明:数据基本由公司网盘储存并提供url下载或直接读取,数据信息介绍由超算互联网商城提供,内部无数据时提供官网下载地址。
```
chenzk's avatar
chenzk committed
44

chenzk's avatar
chenzk committed
45
* 需要提供迷你数据集以供使用者快速上手项目。
chenzk's avatar
chenzk committed
46

chenzk's avatar
v1.0  
chenzk committed
47
48
49
50
* model.properties:`五大属性`固定模板如下:
```
    # 模型唯一标识
    modelCode=Project ID
51
    # 模型名称
chenzk's avatar
v1.0  
chenzk committed
52
    modelName=模型名称(同项目名称:模型名_深度学习框架)
53
    # 模型描述
liuhy's avatar
liuhy committed
54
    modelDescription=简要描述此模型(尽量50字以内)
55
    # 应用场景
chenych's avatar
chenych committed
56
    appScenario=推理,训练,OCR(首先描述推理、训练信息,然后描述算法类别信息,标签用英文逗号隔开。)
57
    # 框架类型
chenzk's avatar
v1.0  
chenzk committed
58
    frameType=paddle(说明使用的算法框架, 多个标签用英文逗号隔开。)
chenych's avatar
chenych committed
59
60
    # 加速卡类型
    accelerateType=BW1000,K100AI(设备为项目中所运行模型测试所用的加速卡,以帮助用户在光源可快速进行目标选型。)
chenzk's avatar
v1.0  
chenzk committed
61
```
chenzk's avatar
chenzk committed
62

chenzk's avatar
v1.0.5  
chenzk committed
63
* 增加LICENSE(必要),源github无LICENSE则在LICENSE里填:None LICENSE Currently;CONTRIBUTORS.md根据源github有无提供(非必要)。