训练算法

新建训练算法

1. 准备数据。
   1. 准备用途为“训练/评测”的镜像和版本，详情可参考镜像仓库。
   2. 准备训练算法文件，文件详情可参考算法文件说明。

2. 在左侧菜单栏中选择“训练服务 > 算法管理”。
3. 单击“新建训练算法”，填写算法的名称和描述信息，其他参数参考如下。
   • 如果类型选择“仅镜像（包含算法文件）”，参数填写完毕后，勾选服务声明，单击“创建”即可创建算法。
   • 如果类型选择“镜像 + 外置算法文件”，参数填写完毕后执行4。

   表1 新建训练算法

   参数	说明
   类型	训练算法的类型。 镜像 + 外置算法文件：训练算法文件与镜像独立存在，创建训练算法时需选择镜像，并上传准备好的训练算法文件，训练任务启动时会把文件下载到容器中，并把算法根目录作为工作目录。 仅镜像（包含算法文件）：训练算法文件包含在镜像中，需提前将训练算法文件放入选择的镜像中。
   镜像	选择用途为“训练/评测”的镜像和版本，作为训练任务的容器镜像。
   共享级别	算法的共享级别。 个人：当前操作用户，创建者和租户管理员可用。 团队：当前工作空间下被授权的用户可以使用该算法创建训练任务，评测任务。
   样本类型	使用的样本类型。 图片 3D点云
   启动指令	训练算法的启动指令。 对于“镜像 + 外置算法文件”类型的算法，容器默认的工作目录为算法文件的根目录。 示例：如果算法文件中有一个名为main.py的训练入口文件，启动指令可以是python -u main.py，指令中仅需指定文件的相对路径即可。 对于“仅镜像（包含算法文件）”类型的算法，默认工作目录与镜像中定义的保持一致。 启动指令中指定的文件可使用完整的绝对路径，如python /home/ma-user/main.py， 也可以使用相对于镜像工作目录的相对路径。
   参数列表	可以自定义boot文件的启动参数，需要在算法中定义。单击“新增参数”，填写key和value。
   参数命令	参数命令为运行启动脚本的shell命令，由配置的“启动指令”和参数列表中参数及参数值自动生成。
   环境变量	通过注入环境变量至容器中，用户可以快速获取业务相关常量。允许添加的环境变量个数不超过20个。单击“新增参数”，填写key和value。

4. 单击“下一步”，完成算法的初始化过程。
5. 选择训练算法文件。

   将本地算法文件夹拖入框中，或单击此处选择本地文件夹，算法管理会将该文件下的所有子文件上传。

6. 单击“上传”，等待算法创建成功。
   

   • 上传中刷新或关闭浏览器会导致文件上传中断，请谨慎操作！
   • 算法状态处于“创建中”时，如因页面刷新，浏览器关闭，网络异常等问题导致上传流程中断的，2分钟后算法状态将被置为“上传中断”，此时仍然可以选择同一个本地文件夹进行断点续传；若“上传中断”状态持续超过2小时，则系统会判定上传任务超时，算法状态将被置为“创建失败”。

训练算法相关操作

在“算法管理”列表，可对训练算法进行以下操作。

算法的各个状态和所支持的操作如下。

文件上传相关的状态过渡如下。

图1 训练算法文件上传状态机

在线编辑算法

平台提供算法编辑器，单击列表中的“在线编辑”，或单击算法详情页右上角的“算法编辑”，进入该算法的在线编辑页面。界面左侧显示的是该算法包内的所有算法文件，以目录树的形式展示，支持编程语言的渲染，支持MarkDown文件的实时双屏预览。

• 上传文件：单击顶部工具栏中的，用户可以追加上传本地文件（夹）到算法文件根目录，选中文件夹并单击可以追加上传本地文件（夹）到该文件夹。
• 新增文件夹：选中文件夹并单击，用户将新建一个该文件夹的子文件夹。选中工程文件并单击，将会新建一个新的文件夹，与用户已有的文件夹同级。
• 新增文件：单击，或鼠标放置在文件夹目录上，单击“新增文件”，用户可以新增文件。
• 修改文件：单击，用户可对文件名称进行修改。
• 删除文件：单击，用户可删除文件。
  

  • 文件名称不能为空且只能包含字母、中文字符、数字、感叹号、连字符、下划线、句点、星号、单引号和括号，且不能以两个句点开头。
  • 删除后不可恢复，请谨慎操作。
• 配置界面：单击，按照喜好配置界面基本属性，查看快捷键说明。
• 删除当前算法文件：单击“删除”，删除当前页面的算法文件。删除后不可恢复，请谨慎操作。
• 保存算法文件：单击“保存”，保存当前算法。算法更新完毕请及时保存。