BioMA
Framework
BioMA
is a modelling framework composed of models and
applications designed for running, calibrating, and improving biophysical and crop growth
models. Biophysical models are algorithms to simulate a part of
the biophysical system. Such algorithms can be coded
into discrete software components.
The BioMA modelling framework is based on independent components,
for both modelling solutions and the graphical user interface. As a basic
user, you can run readily-available modelling solutions; as an advanced user, you can extend
existing modelling solutions and/or add new components. The framework also includes
integrated tools to support the calibration of the models, to run the
simulations at grid level, and to visualize the results.
The BioMA framework is the result of a multi‐team development including the Food Security Unit of the Joint Research Centre, European Commission and the Italian Council for Agricultural Research and Economics (CREA https://www.crea.gov.it/web/agricoltura-e-ambiente).
An example of a possible workflow using some of the available tools within the BioMA framework is given below:
Models as BioMA framework components
Models in BioMA are composed
of small components, which could be recombined (modularity) to increase
reusability and sharing. Different partners can develop their own components,
following the BioMA rules and guidelines, and the
framework guarantees that the components could be combined together to create a
more complete modelling solution.
The figure below shows some of the components created in the BioMA framework, divided in groups according to their
field:
BioMA
Spatial
BioMA
allows running a model in a spatialized way,
through the BioMA Spatial application. This allows to
easily scale the simulation of the models from plot or field scale to country or
global scale. The following shows an example of the generation of spatialized
agro-climatic indices, for which an aridity index was run
across Latin America on a 25 km grid:
BioMA
Spatial can read and write input and output
data to databases, CSV files, and other formats through an extensible set of
input/output data managers.
Software Tools and Documentation
The following table presents elements of the
BioMA modelling framework and provides access to the respective resources.
Note that, to support the users who are new to the application, several
tutorials have been produced that guide the user through the required steps (either
to configure the user's own components and models, or to configure and run existing modelling
solutions).
|
Software Tool/Component
|
Description
|
Date/Version
|
Link to Resources
|
|
BioMA
Framework User Guide
|
The BioMA modelling framework
is designed
and developed for analyzing, parametrizing,
and running modelling
solutions based on biophysical models. It is based
on independent components.
|
6/20/2019
|
|
|
Modelling solution composition:
|
|
Tutorial - How to create a Modelling Solution
|
It guides the users of BioMA to create their
own modelling solutions by implementing new model strategies.
|
13/09/2019
(2019-1.0)
|
|
|
Composition Layer Interactive Code (CLIC) User Guide
|
It
allows creating code to build a modelling solution.
|
9/26/2019
|
|
|
Model simulation:
|
|
BioMA
Spatial Tutorial
|
This tutorial shows how to use the BioMA
Spatial GUI to configure and run a modelling solution, as well as to
visualize the results of the simulation.
|
9/10/2019
(2019-2.1)
|
|
|
BioMA
Spatial
|
Graphical User Interface for configuring, running, and viewing a modelling solution in
a spatially and temporally distributed context. The software available for
download is a custom version of BioMA Spatial and
relates to the Euroclima 2 project.
|
9/22/2015
(2015-1.1)
|
|
|
Parameter calibration:
|
|
Optimizer User Guide
|
It allows calibrating models of any modelling solution made available in BioMA.
|
8/26/2019
|
|
|
Visual analysis of simulation results:
|
|
Graphical Data Displayer (GDD) User Guide
|
It
allows displaying values either by textual tables or by several kinds of
graphs.
|
9/26/2019
|
|
|
Map Data Visualizer (MDV) User Guide
|
It
allows inspecting and visually analyzing the outputs of simulations.
|
6/20/2019
|
|
|
Component creation:
|
|
Tutorial - How to create a Component
|
It guides the users of BioMA to create their
own components.
|
13/09/2019
(2019-1.0)
|
|
|
Domain Class Coder (DCC)
|
It
allows generating the code of domain and parameter classes.
|
|
CREA BioMA
|
|
Strategies Class Coder (SCC)
|
It
allows generating the code of model classes (strategies).
|
|
|
Model Components Explorer (MCE)
|
It allows
exploring the component interfaces and the domain classes.
|
|
|
Model Parameters Editor (MPE)
|
It allows creating and editing the parameters of strategies.
|
|
|
Documentation ofBioMA Layers:
|
|
Composition Layer Documentation
|
The
Composition Layer of BioMA allows composing new
modelling solutions and/or develop components
|
6/20/2019
|
|
|
Configuration Layer Documentation
|
The
Configuration Layer of BioMA allows composing new
modelling solutions and/or develop components.
|
6/20/2019
|
|
|
Data Layer Documentation
|
The
Data Layer of BioMA is a set of C# libraries that
allows a programmer to manage the query and the modification of the database
records.
|
7/15/2019
|
|
|
Documentation of Modelling Solutions:
|
|
CropSyst
Modelling Solution
|
These documents provide a description of the CropSyst, WOFOST, and WARM modelling solutions, which are implemented in the BioMA
modelling framework.
|
6/21/2019
|
|
|
WOFOST
Modelling Solution
|
6/21/2019
|
|
|
WARM Modelling Solution
|
6/21/2019
|
|