© 2020, University of Surrey. All rights reserved. The Overview, Design concepts and Details (ODD) protocol for describing Individual-and Agent-Based Models (ABMs) is now widely accepted and used to document such models in journal articles. As a standardized document for providing a consistent, logical and readable account of the structure and dynamics of ABMs, some research groups also find it useful as a workflow for model design. Even so, there are still limitations to ODD that obstruct its more widespread adoption. Such limitations are discussed and addressed in this paper: the limited availability of guidance on how to use ODD; the length of ODD documents; limitations of ODD for highly complex models; lack of sufficient details of many ODDs to enable reimplementation without access to the model code; and the lack of provision for sections in the document structure covering model design ratio-nale, the model’s underlying narrative, and the means by which the model’s fitness for purpose is evaluated. We document the steps we have taken to provide better guidance on: structuring complex ODDs and an ODD summary for inclusion in a journal article (with full details in supplementary material; Table 1); using ODD to point readers to relevant sections of the model code; update the document structure to include sections on model rationale and evaluation. We also further advocate the need for standard descriptions of simulation experiments and argue that ODD can in principle be used for any type of simulation model. Thereby ODD would provide a lingua franca for simulation modelling.

中文翻译：

---

用于描述基于代理和其他仿真模型的ODD协议：第二个更新，以提高清晰度，复制性和结构现实性

©2020，萨里大学。版权所有。用于描述基于个人和代理的模型（ABM）的概述，设计概念和详细信息（ODD）协议现已被广泛接受，并用于在期刊文章中记录此类模型。作为提供一致，逻辑和可读性的ABM结构和动态描述的标准化文件，一些研究小组还发现它可用作模型设计的工作流程。即使这样，ODD仍然存在一些局限性，阻碍了它的更广泛采用。本文讨论并解决了这些局限性：关于如何使用ODD的指南的可用性有限；ODD文件的长度；ODD对于高度复杂模型的局限性；缺少许多ODD的足够详细信息，无法在不访问模型代码的情况下重新实现；以及文档结构中各节的规定不足，包括模型设计比率，模型的基本叙述以及评估模型适用性的方法。我们记录了为更好地提供指导而采取的步骤：构建复杂的ODD和ODD摘要以包含在期刊文章中（补充材料中有完整的详细信息；表1）；使用ODD将读者指向模型代码的相关部分；更新文档结构，以包括有关模型原理和评估的部分。我们还进一步主张需要对模拟实验进行标准描述，并认为ODD原则上可以用于任何类型的模拟模型。因此，ODD将提供通用语言用于仿真建模。模型的基本叙述，以及评估模型是否适合目的的方式。我们记录了为更好地提供指导而采取的步骤：构建复杂的ODD和ODD摘要以包含在期刊文章中（补充材料中的完整详细信息；表1）；使用ODD将读者指向模型代码的相关部分；更新文档结构，以包括有关模型原理和评估的部分。我们还进一步主张需要对模拟实验进行标准描述，并认为ODD原则上可用于任何类型的模拟模型。因此，ODD将提供通用语言用于仿真建模。模型的基本叙述，以及评估模型是否适合目的的方式。我们记录了为更好地提供指导而采取的步骤：构建复杂的ODD和ODD摘要以包含在期刊文章中（补充材料中有完整的详细信息；表1）；使用ODD将读者指向模型代码的相关部分；更新文档结构，以包括有关模型原理和评估的部分。我们还进一步主张需要对模拟实验进行标准描述，并认为ODD原则上可用于任何类型的模拟模型。因此，ODD将提供通用语言用于仿真建模。构建复杂的ODD和ODD摘要以包含在期刊文章中（补充材料中有完整详细信息；表1）；使用ODD将读者指向模型代码的相关部分；更新文档结构，以包括有关模型原理和评估的部分。我们还进一步主张需要对模拟实验进行标准描述，并认为ODD原则上可用于任何类型的模拟模型。因此，ODD将提供通用语言用于仿真建模。构建复杂的ODD和ODD摘要以包含在期刊文章中（补充材料中有完整详细信息；表1）；使用ODD将读者指向模型代码的相关部分；更新文档结构，以包括有关模型原理和评估的部分。我们还进一步主张需要对模拟实验进行标准描述，并认为ODD原则上可用于任何类型的模拟模型。因此，ODD将提供通用语言用于仿真建模。我们还进一步主张需要对模拟实验进行标准描述，并认为ODD原则上可用于任何类型的模拟模型。因此，ODD将提供通用语言用于仿真建模。我们还进一步主张需要对模拟实验进行标准描述，并认为ODD原则上可用于任何类型的模拟模型。因此，ODD将提供通用语言用于仿真建模。