Crop growth simulations play key roles in understanding the impact of global change on agriculture and in directing efforts to engineer plants capable of feeding the future world.
Unfortunately, code and documentation for many legacy models are difficult to find, use, and/or modify.

Dr. Edward Lochocki, a Postdoctoral Researcher at the University of Illinois, and colleagues present an updated modular crop growth simulator that overcomes these deficiencies in a new in silico Plants article. The legacy BioCro model predicted plant growth over time given crop-specific parameters and environmental data as input. The authors made the newest version, BioCro II, modular by separating the model equations, parameter values, and method of solution. This new structure allows researchers to easily add or modify components of a model, facilitating exploratory studies that can help guide experimental efforts to improve crop yield or resilience.

Three of the most significant advantages of the modular approach are expounded upon below:
First, the user needs less specialized knowledge to perform a simulation. Running the modular crop growth simulation software can be accomplished in three steps: users (1) choose equations from a library, (2) supply additional specifications, and (3) send this information to the BioCro engine, which solves the model and calculates the results. Although it is written primarily in C++, BioCro II is accessible through an R package that provides a user-friendly terminal-based interface, allowing users to harness the wide array of tools available in R for data input, statistical operations, and plotting.

Users can review details about the functions and library entries available in the BioCro II R package by accessing the comprehensive documentation A Practical Guide to BioCro.
Second, the user can build an understanding of individual model components as well as their interactions within the context of the entire model, taking advantage of the logical boundaries made by the module writers. Lochocki explains why this is important: “The scope of crop modelling is continually increasing as models start to include processes at different scales, from genetics all the way up to the global climate. At the same time, individual model components tend to become more detailed and specialized as they become more realistic. Complicating things further, interactions between model components can create new emergent behaviors. Coming at such a complex model head-on can be a daunting challenge, even for an expert in the field. Modular software like BioCro II allows a researcher to digest a large model in smaller pieces, understanding how each part functions on its own and in conjunction with others. In contrast, when a model is written as a monolithic chunk of code, this approach is difficult or impossible.”
Third, the user is easily able to swap model components for alternative versions to better match the available experimental inputs, to take advantage of new developments or to compare alternative components. The authors demonstrated this by swapping the model components for photosynthesis. They compared a simplified empirical statistical model of photosynthesis based on radiation use efficiency (RUE) with the mechanistic process-based Farquhar-von-Caemmerer-Berry (FvCB) model, leaving all other model components unchanged.

A full season of environmental data was used to simulate soybean growth for each of the two models. This exercise revealed that it is possible to achieve close agreement throughout the growing season despite the very different approaches used to determine photosynthesis (Figure 1a). The origin of this agreement can be investigated by examining the relationship between photosynthesis (Agross) and light that hits the canopy (PPFD) in the two models. In the FvCB model, photosynthesis levels off at higher light intensities, while the linear RUE model overestimates photosynthesis at high light and underestimates photosynthesis at low light (Figure 1b). Although the calculated values of photosynthesis agree on average, the agreement is fragile and unlikely to hold in other years because the FvCB model is sensitive to critical environmental variables that are ignored by the RUE model.
It is straightforward to explore these contrasting photosynthetic models further using BioCro II because all the parameters are specified outside the model equations and their values can easily be changed. To demonstrate the utility of this feature, the authors performed a sensitivity analysis to better understand the response of the mechanistic FvCB model to environmental factors, and hence reveal the dynamics that are not included in the empirical RUE model. They found that the temperature response of total biomass is not significantly different between the RUE and FvCB simulations, due to the temperature dependence of other components involved in the simulation. On the other hand, the response of biomass to CO2 concentration is significantly different between the two models, with the RUE simulation having almost no response at all (Figure 2c). This is a key insight into these models that would have been difficult to achieve without modularity.

BioCro II follows the general structure of a dynamical system. This means that the model describes how variables representing a particular system evolve with time. Although it may seem obvious that most models could be thought of in this way, many crop growth models are not programmed in this manner. However, writing the models explicitly as dynamical systems has many benefits. In particular, it facilitates modularity, in that two dynamical systems can be combined to form a third, simply by combining their individual components. In this way, complex multiscale models can be built from simpler ones. In practice, this is only possible to do if the model code is written in a way that clearly identifies components of a dynamical system. BioCro II enforces these distinctions, helping to ensure that dynamical systems and their sub-components can be recombined with ease
Co-author Dr. Justin McGrath, USDA Research Plant Physiologist, explains, “Models are nearly ubiquitously written explicitly as dynamical systems in many fields. BioCro II reproduces BioCro I as a dynamical system presenting it in a way familiar to most modelers. Furthermore, it extends the dynamical system concept by providing a way to modularly select parts of models, providing what we hope is a useful way for researchers to write their models and couple them with other models in the community”
READ THE ARTICLE:
Edward B Lochocki, Scott Rohde, Deepak Jaiswal, Megan L Matthews, Fernando Miguez, Stephen P Long, Justin M McGrath, BioCro II: a Software Package for Modular Crop Growth Simulations, in silico Plants, 2022, diac003, https://doi.org/10.1093/insilicoplants/diac003
BioCro II is open-source and available online at https://github.com/ebimodeling/biocro