Documenting Social Simulation Models: The ODD Protocol as a Standard
Why Read This Chapter?
To learn about the importance of documenting your simulation model and discover a lightweight and appropriate framework to guide you in doing this.
The clear documentation of simulations is important for their communication, replication, and comprehension. It is thus helpful for such documentation to follow minimum standards. The “Overview, Design concepts and Details” document protocol (ODD) is specifically designed to guide the description of individual- and agent-based simulation models (ABMs) in journal articles. Popular among ecologists, it is also increasingly used in the social simulation community. Here, we describe the protocol and give an annotated example of its use, with a view to facilitating its wider adoption and encouraging higher standards in simulation description.
KeywordsDesign Concept Inference Engine Relative Agreement Opinion Interaction Social Simulation
We are grateful to Bruce Edmonds for inviting us to contribute this chapter, and for his helpful comments and suggested amendments to earlier drafts. Gary Polhill’s contribution was funded by the Scottish Government.
- Amouroux E, Gaudou B, Desvaux S, Drogoul A (2010) O.D.D.: a promising but incomplete formalism for individual-based model specification. In: Ho TB, Zuckerman DN, Kuonen P, Demaille A, Kutsche R-D (eds) 2010 IEEE-RIVF international conference on computing and communication technologies: research, innovation and vision for the future, Vietnam National University, Hanoi, 1–4 Nov 2010Google Scholar
- Gilbert N (2007) Agent-based models. Sage, LondonGoogle Scholar
- Heine B-O, Meyer M, Strangfeld O (2005) Stylised facts and the contribution of simulation to the economic analysis of budgeting. J Artif Soc Soc Simulat 8(4):4. http://jasss.soc.surrey.ac.uk/8/4/4.html
- Heppenstall A, Crooks A, See LM, Batty M (eds) (2012) Agent-based models of geographical systems. Springer, BerlinGoogle Scholar
- Livermore M (2010) MR POTATOHEAD framework: a software tool for collaborative land-use change modeling. In: Swayne DA, Yang W, Voinov AA, Rizzoli A, Filatova T (eds) International Environmental Modelling And Software Society (iEMSs) 2010 international congress on environmental modelling and software: modelling for environment’s Sake, Fifth Biennial Meeting, Ottawa. http://www.iemss.org/iemss2010/index.php?n=Main,Proceedings
- Polhill JG, Parker D, Brown D, Grimm V (2008) Using the ODD protocol for describing three agent-based social simulation models of land use change. J Artif Soc Soc Simulat 11(2):3. http://jasss.soc.surrey.ac.uk/11/2/3.html
- Railsback SF, Grimm V (2012) Agent-based and individual-based modeling: a practical introduction. Princeton University Press, PrincetonGoogle Scholar
- Triebig C, Klügl F (2010) Elements of a documentation framework for agent-based simulation. Cybern Syst 40(5):441–474Google Scholar
- Wheeler S (2005) Beyond the inverted pyramid: developing news-writing skills. In: Keeble R (ed) Print journalism: a critical introduction. Routledge, Abingdon, pp 84–93Google Scholar
- Wilensky U (1999) NetLogo. http://ccl.northwestern.edu/netlogo