【社区求助秘籍】助你通关DP!
亲爱的DeepModeling社区用户大家好,你们是否遇到过:
想要使用DeepModeling社区项目,不知道如何上手?
代码跑崩溃了,看着满屏的报错不知道该怎么办?
对于DeePMD-kit等社区项目的细节,想要提问不知道该去哪里求助?
好不容易找到一个地方提问,但问题又如同石沉大海,得不到有效的答案?
如果你遇到上面任何一种情况,读这篇文章就对了!“DeepModeling社区求助秘籍”,帮助你在开源社区更好地寻求帮助!
本文主要从3个方面帮助大家:
【教程资料汇总】帮助你快速找到需要的资料
【Github求助指南】教你如何在Github上面获得开发者直接帮助
【微信群求助指南】教你如何加入社区微信群,并正确寻求帮助
01
【教程资料汇总】文档和教程是康庄大道
随着DeepModeling社区的不断壮大,社区相关的教程与文档已经越来越完善。我们希望这些教程和文档会成为你解决问题的主要工具。有能力带着问题阅读文档、并解决困惑,对初学者是一个挑战,但是相信我,这份挑战是值得的。
社区官网 / Github / 文档和教程
官网地址:www.deepmodeling.org
Github地址:https://github.com/deepmodeling
现在社区最主要的几个项目都可以从这个地址点击进入,欢迎大家经常来看看:
随着DeepModeling社区快速发展,社区各项目的文档也在逐步完善。社区整体文档的地址是:https://docs.deepmodeling.org 。接下来让我们以DeePMD-kit为例,一睹项目文档的风采吧!
近期,我们也建立了一个教程网站 https://tutorials.deepmodeling.org 并持续更新,以帮助DP初学者更容易地上手。
TIPS ·
对于初学者,我们建议你先从教程开始学习;对于比较熟练的使用者,我们推荐你可以直接阅读相关项目的文档。
社区公众号 / B站
对于中文用户,我们社区还会维护微信公众号和B站账号两个平台,中文版的教程会持续更新在这两个平台上。大家也一定要关注一下。
微信公众号的教程,可以打开深度势能公众号,点击“教学专栏”。(新版教程还在开发中,因此目前保存了旧版教程。待新版教程开发完成,会全部替换。)
同时为了进一步降低学习DP系列方法的难度,我们还在Bilibili视频网站上建立了频道,其中会推出一系列通俗易懂、干货满满的课程,欢迎大家的关注!
▲B站账号DeepModeling二维码
下面是DeepModeling社区常用的地址汇总, 快听课代表的找个小本本记下来!
社区资料汇总
社区官网:https://deepmodeling.org
社区代码:https://github.com/deepmodeling
社区文档:https://docs.deepmodeling.org/
社区教程:https://tutorials.deepmodeling.org/
微信公众号:搜索“深度势能”
B站账号:https://space.bilibili.com/626179751
02
【Github求助指南】与开发者直接对话
仔细查阅了文档和教程,但是依然无法解决你的问题的时候,别犹豫,是该去社区提问的时候了!
我们优先鼓励你到DeepModeling社区的Discussions版来提问。这个讨论版有我们最核心的开发者在维护,你的问题很有可能得到最专业的回答。希望大家牢记,有问题上Github!
请从DeepModeling的Github首页找到对应的项目,然后点击Discussions进入讨论版。以DeePMD-kit为例,它的地址是https://github.com/deepmodeling/deepmd-kit/discussions 。
在提问之前,有几个建议希望你能参考:
善用搜索:在提问前,请优先使用Discussions版和文档的搜索功能,看看你的问题有没有被解决。
使用英语:社区中有很多来自海外、且母语非汉语的用户,大家换位思考一下假如自己读到全部是用阿拉伯语写的文档时是不是也挺崩溃的。同时,提升英语能力对于查阅资料、学术文章写作有很大帮助。因此Discussions版统一要求使用英语。
提供足够的信息便于定位问题:请尽可能清楚、完整地提供机器、软件、版本、运行命令、错误日志、复现方式、想要实现的功能等参考信息等,如有需要可以上传附件。这非常重要,一个描述模糊的问题只会得到低效率的反复追问和低质量的回答。
发错误日志时不要截图:截图的信息无法搜索。
错误示例
正确示例
此外,如果你认为该问题是软件的bug,欢迎你在Github的Issues版块和开发者反馈。
TIPS ·
请牢记:有问题上Github,Github上有最专业的回答!请尽可能清楚、完整地描述你的问题。
03
【微信群求助指南】加入DP用户交流答疑群
社区还为大家组织了一系列的微信群,比如DP用户交流答疑群(即将创建5群)、ABACUS用户群等等。这里有来自全国各地的高手云集于此、热火朝天地讨论和交流DeepModeling社区的各种方法和工具。如果你希望加入相关微信群,请扫描文末的“deeppotential"社区助手二维码并附加说明。
关于DP的使用问题,都可以在群里提问。不过强烈建议你用好微信搜索的功能,你的很多问题可能在微信群里大家都提到过。在提问前不妨使用群的聊天记录搜索的功能:
此外,我们仍然有几点说明希望与你分享:
DeepModeling社区是由那些希望通过计算建模突破科学边界、解决困难问题的人们凝结而成的,我们共同追求通力协作、惠及大众;追求知识与工具的自由交流与分享;追求尊重并欣赏相互的成就、和而不同。正在回答你问题的老师或同学可能也正忙于自己繁重的本职工作,也请你理解这里并没有谁有义务一定得做任何事情,我们希望在相关微信群和Github社区的交流富有善意和尊重,奔向智慧与真理。
虽然多数情况下微信群内的志愿者会帮助回答问题,但微信群交流的实时和便捷性的背后也涵盖了新加入群的成员和其他群的成员无法查看历史记录、回答难以有效沉淀等问题,因此我们仍强烈推荐大家到Github进行交流。相比微信群内的问题,DP核心开发者会优先处理Github的Issues与Discussions中的问题。如果经过较长时间(三天以上)你的问题仍没有得到解决,你可以友善地提醒相关开发者,或者转发到微信群中吸引更多人的关注。
如果别人的问题你恰好知道答案,也请你在群里或者Discussion版不吝赐教。在此我们也对所有无私贡献的社区志愿者表示感激,任何的善意行为都是对DeepModeling社区共同定义科学计算未来的的目标作出的重要贡献。
04
想要跟着官方一起学习?
从2022年开始,DeepModeling社区还为大家准备了"哥伦布训练营"。关于哥伦布训练营的详细介绍,请看这篇推送👉【DP训练营招募令】加入哥伦布计划,发现计算模拟新大陆!
我们的目标是尽一切努力,让你高效地学会DP软件。有任何建议都欢迎联系我们!面向未来计算模拟的星辰大海,我们一起扬帆起航!
(如需转载图文请与公众号后台联系)-------------------------------推荐阅读
【教程】 DP核心开发者亲授:一节课学透DeePMD-kit原理
【教程·安装讲解】DeePMD-kit和DP-GEN安装教程视频
【DP训练营招募令】加入哥伦布计划,发现计算模拟新大陆!