欢迎参加 AI4S Cup 比赛！
本篇文章为您提供赛事基本指导，通过阅读本文您可以了解如何使用 Bohrium 创建参赛环境，如何创建并提交 Notebook，如何与队友展开协作等事项，内容较长，使用目录以及 Ctrl + F 快速找到您需要的内容吧～
比赛流程说明
AI4S Cup 系列比赛为代码赛机制，选手需要基于 Bohrium® Notebook 平台 ( https://nb.bohrium.dp.tech )，提交可运行并且成功生成预测结果文件的 Notebook 代码，比赛基本流程如下：
报名比赛
注册登录 Bohrium
本次参赛作品均以 Notebook 代码的形式提交，我们鼓励选手在比赛期间将与赛事相关的内容以 Notebook 形式上传至案例广场，点击链接可以进行 Bohrium 账号注册和登录并跳转到案例广场：https://nb.bohrium.dp.tech。
查看比赛信息
登录 Bohrium 页面后在主页点击“比赛”查看比赛列表，选择您感兴趣的赛题了解详细信息，我们会持续发布 AI for Science 领域的赛题，欢迎保持关注！
报名比赛
点击比赛页面的“我要报名”即可报名参加该赛题：
报名成功后您会收到比赛赠送的算力体验金，您可以在“个人中心”中查看到体验卡的余额：
报名成功后您可以随时在比赛页面中“我的比赛”，或者个人主页中找到参加的比赛，点击后在比赛页面提交您的参赛作品：
选择与他人组队
如果您想要组队，可以在比赛页面“我的比赛”中点击“我要组队”：
输入想要邀请用户的 Bohrium 账号（注册手机号或邮箱），如想组队的队员还未注册 Bohrium 请先完成注册。同时每个人只可加入一个队伍，一次可邀请多人，已添加的用户会显示“待邀请”标签，最后点击“确定”发送邀请信息，被邀请用户将收到邀请短信和邮件，如对方 7 日内未接受邀请则视为拒绝。
配置参赛环境
在 Bohrium 创建项目
在 Bohrium 注册后系统会为您创建一个默认项目，您可以重命名该项目名称方便管理，当然您也可以新创建一个项目来你或者团队的参赛预算，进入 Bohrium 工作台，
在“项目”模块点击右上角的“新建项目”，
为您的项目创建一个项目名称，点击确认即可。
配置环境
点击 Bohrium 工作台的“节点”，创建容器节点：
为您的节点命名，选择刚才创建好的比赛项目，您也可以使用任何想归属的项目。以下为示例：机型可以按照镜像中搜索选择 ai4s-cup:0.1 ，机型选择 c12_m46_1*NVIDA GPU B ：
点击“挂载数据集”，选择 competitions 挂载比赛提供的数据，也可以创建新数据集。点击查看本次比赛数据集详情
获取数据集
报名后，数据集将会自动分享给您，在您的“数据集”页面可以查看：https://bohrium.dp.tech/dataset/list
开机时可以选择挂载：
当然您也可以选择将数据集下载到本地：
点击了解如何在提交任务或管理节点中使用数据集，发布 Notebook 时分享数据集：https://bohrium-doc.dp.tech/docs/userguide/Dataset/
创建 Notebook
登陆 Bohrium 平台后在案例广场点击“写Notebook”进入编辑页面，编辑内容会自动保存。您可以在编辑页面设置推荐镜像，机型，并分享数据集。 发布时您可以点击添加署名作者，注意非协作者，请点击“分享”点击添加协作者并管理协作者权限，开始协作后队友可以共同编辑参赛 Notebook。如果想要更自由共享参赛文件可以在创建项目后，将队员加入比赛项目，在项目的 share 盘中进行协作。
保存 Notebook 后您可以在“我的主页”中“我的Notebook”找到自己的 Notebook，进入 Notebook 后可以点击“编辑”按钮继续编辑。
点击查看更多 Notebook 写作技巧：https://nb.bohrium.dp.tech/collection/update/7927749324
模型训练
参考示例Notebook： 使用unimol进行OLED量化属性预测
提交参赛作品
本次比赛的参赛作品以 Notebook 代码形式提交，由于失败提交也会占提交次数，因此请注意提交前确保运行时间小于 6 小时，且可在当前路径生成submission.csv文件。
在比赛页面点击“提交”，可选择上传本地文件或从数据盘导入您的参赛 Notebook，如果从数据盘导入需要从 Bohrium 工作台-文件-data 盘中创建 Notebook，更推荐您无论在哪里创建直接下载后本地上传。如何下载可参考FAQ第4条。
请注意提交时除了官方提供数据，一定要挂载您使用的数据集，否则提交后会因无法读取到数据导致运行失败。
上传完毕后点击“提交”即可在“我的比赛”页面查看到提交记录：
查看比赛结果
目前AI4S Cup的比赛类型为常规赛、学习赛。
常规赛
提交比赛结果后，可以在比赛主页“排行榜”查看您的排名和分数：
为了防止过拟合和鼓励参赛者们在比赛期间进行更多的探索和研究，设置了 AB 榜，排行榜 A 榜基于一部分测试数据计算，最终比赛结果 B 榜会基于剩余的测试数据，因此最终比赛结果可能会和 A 榜不同。
排行榜的依据：Score > 提交次数 > 提交时间， 相同 Score 下，提交次数越少的排名越靠前；相同 Score 和提交次数下，提交时间越早的排名越靠前。
比赛结束后我们将会在比赛页面和公众号渠道公布比赛获奖情况，敬请关注。
学习赛
学习赛是一类具有教学意义的长期开放的比赛，排行榜仅做展示，不进行顺位评奖。排行榜根据所有测试数据计算，不区分A榜和B榜。
FAQ
1.运行后 Score 的结果为负分，这是什么原因？
评测标准是加权R2，会出现极端情况导致预测的R2是负值，这种情况表明您的模型预测有极端值或者预测精度有问题，也有可能是id乱序了，需要检查您的预测文件。
2.当我提交的 Notebook 运行失败时，可能的原因是：
- 数据集路径问题，请检查数据集路径是否正确，请注意挂载数据集路径而非/data盘路径，/data 盘数据仅自己可见；
- 是否生成了submission.csv，生成该文件的路径需要是当前路径；
- submission.csv的格式是否是对的，可以查看具体的报错信息；
- 运行超时。
3.我在哪里查看我的参赛信息？
比赛信息会自动关联在您的个人主页，您也可以在比赛主页中“我的比赛”进行查看。
4.如何下载 Notebook?
您可以在 Bohrium 工作台点击“文件”进入 web shell 选中 Notebook 文件右键点击下载，也可以在案例广场“写Notebook”后，在编辑页面中点击分享旁的菜单按钮展开选项，点击下载。
5.我如何和我的队员协作？
创建 Notebook 后在编辑页面，点击“分享”添加您的队友成为协作者：
6.如果我想使用自己的训练的模型，使用其他的软件包，该如何操作？
可以将您的模型文件和软件包下载以后上传到数据集中，写入代码使用 Bohrium 运行：
在 Bohrium 工作台点击“数据集”:
为您待上传的数据文件定义易识别的名称并创建路径，并可以点击“可使用”管理数据集权限，点击创建后，系统将默认将当前内容创建为数据集的 v1 版本，创建成功后页面自动跳转至该数据集版本的详情页。
数据集详情页，可查看数据集基础信息及包含的各版本信息，获取各版本文件路径、查看及下载版本文件。 更多数据集使用指导：https://bohrium-doc.dp.tech/docs/userguide/Dataset/
7.可以使用自己的镜像吗？
仅支持使用比赛官方镜像，官方镜像包含了大部分可能用到的软件包，如果官方镜像不包含所需功能，您也可以通过pip install xxx，或者上传包文件进行在线安装，如果仍有其他包安装需求请联系我们。
8.在哪里可以找到更多学习资料？
在 Bohrium Notebook 案例广场有很多同学分享了他们学习探索的经验心得，可以在案例广场搜索查找您需要的学习内容。
9.可以通过哪些渠道关注比赛信息？
欢迎关注我们的公众号和比赛官网，我们将及时更新比赛信息。
10.关于代码开源？
代码开源主要指的是赛后参与评奖的代码（Notebook）需要开源，并不是要求提交了就开源；另外我们也鼓励选手在比赛过程中进行部分baseline代码的开源；
11.请问我们比赛允许在本地训练模型 然后在Bohrium Notebook里直接加载权重进行推理吗？
可以的，需要把权重，依赖的文件放到自建的数据集里，提交的时候选择对应的数据集带上去。也可包含其他.py文件，然后在Bohrium Notebook里import。
12.提交时找不到 Notebook，如何顺畅提交？
由于希望参赛选手提交确定的版本，我们更推荐下载参赛 Notebook 再提交的方式，如何下载可以参考 FAQ 中第 4 条，下载后点击比赛页面的“提交”后选择本地文件上传，注意不要忘了挂载您使用的数据集，并检查数据路径是否正确。
13.如何查看运行失败原因？
鼠标点击“运行失败”旁的小图标，会展示运行失败的 Traceback，后续我们将持续优化失败原因的展示。
14.Bohrium 的 Notebook 支持对外公开 ip:port 吗？
支持对外端口：50001-50005
获取IP：直接在 Notebook 中输入! curl --noproxy "*" ip.sb 运行便可通过ip查询的网站返回公网ip。
或者连接 Notebook 后，在 Bohrium 工作台会出现一台节点，点击节点连接使用控制面板上的IP。
15.免费c2_m4_cpu机型有运行时间限制吗？
免费资源没有时间限制，但 Notebook 闲置超过2小时会自动释放，避免释放的方法是让 Notebook 有单元格在运行，或者浏览器页签一直在前台。
16.比赛的官方数据集在提交的时候需要挂载吗？
不需要，比赛服务器会自动挂载。
17.交流方式
欢迎添加管理员联系方式加入比赛交流群：
