The Common Modelling Protocol: A hierarchical framework for simulation of agricultural and environmental systems

A modular approach to simulation modelling offers significant advantages for its application to agricultural and environmental questions, including re-use of model equations in different contexts and with different user-interfaces; configuration of model structures that are most appropriate to a given problem; and facilitation of collaboration between modelling teams. This paper describes the Common Modelling Protocol (CMP), a generic, open and platform-independent framework for modular simulation modelling that is in widespread use. The CMP is distinguished from existing simulation frameworks by taking an explicitly hierarchical view of the biophysical system being simulated and by representing continuous and discontinuous processes equally naturally. Modules of model logic are represented in the CMP by entities known as “components”. Each component may possess “properties” that convey the value of the quantities in its equations and “event handlers” that compute model logic. Low-level information-transfers in the CMP are carried out by means of a message-passing system. Co-ordinated sequences of messages carry out tasks such as initialization, exchange of variable values and the control of computation order. Extensible Markup Language (XML) is used in the protocol for tasks such as denoting data types, submitting simulations for execution and describing components to user-interface software. Examples are presented showing how the CMP can be used to couple modules developed by different teams and to configure a complex model structure. The choices and trade-offs encountered when building a framework for modular simulation are analyzed, using the CMP and other simulation frameworks as examples. The kinds of scientific issues that arise when the CMP is used to realize collaboration between modelling groups are discussed.