Laatabi A. auteur aut IRD Marilleau Nicolas auteur aut IRD Nguyen-Huu Tri auteur aut IRD Hbid H. auteur aut IRD Babram M. A. auteur aut IRD text journalArticle eng text/pdf reformatted digital access 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 diagramcalled DAMap (Data to Agent Mapping). This mapping model formalizes howdata 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. specialized Empirical Agent-Based Models ODD protocol ODD+2D Mapping Data analysis Social simulation MAROC MARRAKECH 122 128 21 2 art. 9 [24 p.] 2018 1460-7425 https://www.documentation.ird.fr/hor/fdi:010073670 10.18564/jasss.3646 1460-7425 [F B010073670] https://www.documentation.ird.fr/hor/fdi:010073670 https://horizon.documentation.ird.fr/exl-doc/pleins_textes/divers18-09/010073670.pdf IRD - Base Horizon / Pleins textes 2018-09-12 2018-10-03 fdi:010073670 fre