On code sharing and model documentation of published individual and agent-based models
On code sharing and model documentation of published individual and agent-based models
复制标题
DOI：
10.1016/j.envsoft.2020.104873
复制
发表时间：
2020-12-01
影响因子：
4.9
通讯作者：
Lee, Allen
中科院分区：
文献类型：
--
作者：
Janssen, Marco A.;Pritchard, Calvin;Lee, Allen
能够复制研究成果是科学的标志。原则上，使用计算模型复制研究结果应该是可能的。在这篇手稿中，我们评估了7500篇关于基于个人和基于代理的模型的出版物的代码共享和模型文档实践。多年来，代码可用性一直在增加，2018年高达18%。模型文档不包括所有可以提高模型透明度的元素，如数学方程、流程图和伪代码。我们发现，公式和流程图的文章在其他模型论文中被引用得更多，这可能是因为模型文档更加透明。代码共享的实践随着时间的推移而缓慢改善，部分原因是更多公共存储库和存档的出现，以及期刊和赞助商对代码可用性的要求。然而，在计算建模成为可复制的科学之前，规范和习惯需要发生重大变化。
Being able to replicate research results is the hallmark of science. Replication of research findings using computational models should, in principle, be possible. In this manuscript, we assess code sharing and model documentation practices of 7500 publications about individual-based and agent-based models. The code availability increased over the years, up to 18% in 2018.Model documentation does not include all the elements that could improve the transparency of the models, such as mathematical equations, flow charts, and pseudocode. We find that articles with equations and flow charts being cited more among other model papers, probably because the model documentation is more transparent.The practices of code sharing improve slowly over time, partly due to the emergence of more public repositories and archives, and code availability requirements by journals and sponsors. However, a significant change in norms and habits need to happen before computational modeling becomes a reproducible science.