The quantity of data and processes used in modeling projects has been dramatically increasing in recent years due to the progress in computation capability and to the popularity of new approaches such as open data. Modelers face an increasing difficulty in analyzing and modeling complex systems that consist of many heterogeneous entities. Adapting existing models is relevant to avoid dealing with the complexity of writing and studying a new model from scratch. ODD (Overview, Design concepts, Details) protocol has emerged as a solution to document Agent-Based Models (ABMs). It appears to be a convenient solution to address significant problems such as comprehension, replication, and dissemination. However, it lacks a standard that formalizes the use of data in empirical models. This paper tackles this issue by proposing a set of rules that outline the use of empirical data inside an ABM. We call this new protocol ODD+2D (ODD+Decision + Data). ODD+2D integrates a mapping diagram called DAMap (Data to Agent Mapping). This mapping model formalizes how data are processed and mapped to agent-based models. In this paper, we focus on the architecture of ODD+2D, and we illustrate it with a residential mobility model in Marrakesh.

中文翻译：

---

ODD + 2D：基于ODD的协议，用于将数据映射到经验ABM

近年来，由于计算能力的进步以及诸如开放数据之类的新方法的普及，用于建模项目的数据和流程的数量已急剧增加。建模人员在分析和建模由许多异构实体组成的复杂系统时面临越来越大的困难。调整现有模型对于避免从头开始编写和研究新模型的复杂性至关重要。ODD（概述，设计概念，详细信息）协议已成为文档基于代理的模型（ABM）的解决方案。这似乎是解决诸如理解，复制和传播等重大问题的便捷解决方案。但是，它缺乏规范化经验模型中数据使用的标准。本文通过提出一套规则概述了ABM内部经验数据的使用来解决此问题。我们将此新协议称为ODD + 2D（ODD +决策+数据）。ODD + 2D集成了一个称为DAMap（数据到代理的映射）的映射图。此映射模型正式化了如何处理数据并将其映射到基于代理的模型。在本文中，我们重点介绍ODD + 2D的体系结构，并使用马拉喀什的住宅移动性模型对其进行说明。