Resources

Documentation Standards

Advancing the use of agent-based models in scholarly research demands rigorous standards in model code and experiment documentation. CoMSES Net supports open metadata and documentation standards including codemeta, DataCite, and the ODD protocol.

The ODD Protocol was initially proposed by Volker Grimm et al. in 2006 with the following rationale:

Simulation models that describe autonomous individual organisms (individual based models, IBM) or agents (agent-based models, ABM) have become a widely used tool, not only in ecology, but also in many other disciplines dealing with complex systems made up of autonomous entities. However, there is no standard protocol for describing such simulation models, which can make them difficult to understand and to duplicate.

The ODD is organized around the three main components to be documented about a model:

  1. Overview
  2. Design concepts
  3. Details

These components encompass seven sub-elements that must be documented in sufficient depth for the model's purpose and design to be clear and replicable for a third party: Purpose, State Variables and Scales, Process Overview and Scheduling, Design Concepts, Initialization, Input, and Submodels.

In addition to the original 2006 publication, Grimm et al. have continued to publish updates to the protocol with examples of its application to research projects.

This website uses cookies and Google Analytics to help us track user engagement and improve our site. If you'd like to know more information about what data we collect and why, please see our data privacy policy. If you continue to use this site, you consent to our use of cookies.