TerraME: Simulation and Modelling of Terrestrial Systems

TerraME is a programming environment for spatial dynamical modelling. TerraME runs on cell spaces and supports cellular automata, agent-based models, and network models. Typical applications of TerraME include land change and hydrological models. Two important innovations in TerraME are its use of anisotropic spaces and of hybrid automata models.

Anisotropic spaces arise when modeling natural and human-related phenomena. For example, land settlers in a new area do not occupy all places at the same time. They follow roads and rivers, leading to an anisotropic pattern. Anisotropic spaces are implemented in TerraME using Generalized Proximity Matrices (GPM). The GPM is an extension of the usual definition of the spatial relations and include a combination of neighborhood measures in the absolute space and in the relative space.

A hybrid automaton is an abstract model for a system whose behavior has discrete and continuous parts. It extends the idea of finite automata to allow continuous change to take place between transitions. Adopting hybrid automata in spatial dynamical models allows complex models which include critical transitions.

A vision of research motivations and directions of Environmental Modelling in INPE is available in this presentation. An early presentation of our vision is How can GIScience contribute to Land Change Modelling?, the keynote speech at GIScience 2006. The rationale for the TerraME software is presented in the lecture Modelling human-environment interactions, presented in the Vespucci Summer School 2010.

The latest version of TerraME is the release candidate 5 (RC5). It works under Windows (XP, Vista, and Windows 7).

TerraME is distributed under the GNU Lesser General Public License. Older versions are available here. For information on future versions, please visit its development page.

TerraView is a GIS application based on TerraLib, a library to handle vector and raster data in several geographical DBMS. Some recommended add-on plugins to work with dynamic models are:

• Fill Cell Plugin: feeds cellular spaces with attributes based on any geometry, through a large set of operations.
• Copytheme2layer: A simple and useful plugin to interchange cellular spaces from different databases.

You can build models in TerraME using any text file editor. Below there is a list of editors we recommend due to their programming facilities.

• Crimson Editor: Recommended for most users. Follow these instructions for running TerraME within Crimson. There is a syntax highlight configuration file for TerraME; put it in “C:/Program Files/Emerald Editor Community/Crimson Editor/spec”.
• Eclipse SDK: Recommended for large projects. There is a Lua plugin for Eclipse.

The DataBase Management Systems (DBMS) currently supported by TerraME are:

• Microsoft Access: Recommended for small projects. It is usually installed with Windows.
• MySQL: Recommended for large projects.

aRT (R-TerraLib API) is an R package that provides the integration between the statistical software R and the GIS library TerraLib. The aim is to have a package for accessing geospatial data to be analysed in R.

• Tutorial: An Introduction to TerraME (version 1.4)
• Lua for TerraME: A Short Introduction
• Classes and Functions Documentation

• Simple Fire Spread Model: code
• Fire Spread Model: code + database + paper
• Game of Life: code
• Schelling's Seggregation Model: code
• Hydrological model: code + database
• Iterated Prisoner's Dilemma: code
• Spatial Games: code
• LUCC model for Amazonia: code + database

• A brief course on TerraME was given at the Vespucci Summer School 2010.

• Tiago Carneiro. Nested-CA: a foundation for multiscale modeling of land use and land change. PhD Thesis, INPE, 2006.
• Evaldinólia Moreira, Sergio Costa, Ana Paula Aguiar, Gilberto Camara, Tiago Carneiro. Dynamical coupling of multiscale land change models, Landscape Ecology, 24(9), p. 1183-1194, 2009.
• Tiago Carneiro, Gilberto Câmara, Raian Maretto. Irregular Cellular Spaces: Supporting Realistic Spatial Dynamic Modeling using Geographical Databases. X Brazilian Symposium on Geoinformatics, GeoInfo'08, Rio de Janeiro, 2008.
• Pedro Andrade, Antonio Miguel Monteiro, Gilberto Câmara, Sandra Sandri. Games on Cellular Spaces: How Mobility Affects Equilibrium. Journal of Artificial Societies and Social Simulation (JASSS), 12(1), p. 4, 2009.

The chief developer of TerraME is Prof. Tiago Garcia de Senna Carneiro, from the Federal University of Ouro Preto. INPE's development group includes PhD students Pedro Andrade, Sergio Costa, Rodolfo Maduro Almeida and MsC student Raian Vargas Maretto. INPE's researchers involved in developing models using TerraME include Dr. Gilberto Camara, Dr. Antonio Miguel Monteiro, Dr. Ana Paula Aguiar, and PhD student Giovana Mira de Espindola. The TerraME kernel development team also includes some bachelors and undergraduate students from the Computer Science department of the Federal University of Ouro Preto: Antônio José da Cunha Rodrigues and Rodolfo Ayala Lopes Costa.

TerraME has been developed as a joint effort among TerraLab (Laboratory for Modelling and Simulation of Land Systems), at Federal University of Ouro Preto, with Image Processing Division (DPI) and Earth System Science Center (CCST), at INPE.