Navigation path

Software Resources

 

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 multiteam development including the Food Security Unit of the Joint Research Centre, European Commission and the Italian Council for Agricultural Research and Economics (CREA http://sito.entecra.it).

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

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.

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

Documentation of BioMA 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