GeoInformatics.cc

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
You are in [[http://www.geoinformatics.cc | Geoinformatics - Creative Commons]] :: [[http://www.geoinformatics.cc/doku.php?id=cst-317|Introduction to Earth System Modelling]] :: Software for the Course

===== Introduction to Earth System Modelling: Software =====

==== Software Description  ====

The models described in this course will be developed using [[http://www.terrame.org | TerraME]]. TerraME is an extension of the [[http://www.lua.org|Lua]] language. Some useful documents about TerraME:

  * {{http://www.dpi.inpe.br/gilberto/papers/mrel_paper.pdf|Experiences with a Socio-Environmental Modeling Course, //Modelling in Science Education and Learning//, 2014}}
  * {{http://www.dpi.inpe.br/gilberto/papers/terrame_ems_post_print.pdf|TerraME:An extensible toolbox for modelling nature-society interactions, //Environmental Modelling and Software//, 2013}}

Students should read the TerraME EMS and the MREL papers first, to get a sense of the language and what we are going to teach. The next step is to learn the basics of Lua, which is a simple and elegant programming language. Good references on Lua are:

  * {{http://www.lua.org/spe.html| Lua - an extensible extension language, by R. Ierusalimschy, L. H. de Figueiredo, W. Celes, //Software: Practice & Experience//,  26 #6 (1996) 635–652. }}
  * {{http://docs.coronalabs.com/guide/start/introLua/index.html| A one-pager introduction to Lua (very good!)}}
  * {{http://www.lua.org/pil/contents.html | The Lua book by Roberto Ierusalimschy (excellent!)}}
  * {{http://www.dpi.inpe.br/gilberto/cursos/cst-317-2014/luaforterrame-version2.pdf|Lua for TerraME: A Short Introduction}}

==== TerraME ====

Please first install the TerraME software, available at the  [[https://github.com/TerraME/terrame/releases |  TerraME github release site]]. 

=== TerraME installation in Windows ===

Please install TerraME in "C:\TerraME" in Windows. 

=== TerraME installation in MAC OS X  ===

To install TerraME on a MAC, please follow the instructions below:

  - Install homebrew, a package manager for MAC.
  - install qt5 using homebrew (%brew install qt5)
  - Download terrame-1.4-mac.tgz from TerraME website
  - Copy terrame-14.mac.tgz to /usr/local directory (as "sudo")
  - In /usr/local directory, run the command "sudo tar xzvf terrame-1.4-mac.tgz"
  - Include the following lines in your ".profile"
<code>    export TERRAME=/usr/local/terrame
    export TME_PATH=$TERRAME/bin 
    export PATH=$PATH:$TME_PATH
    export LUA_PATH="./?.lua;$TME_PATH/?.lua"
    export LUA_CPATH="$TME_PATH/?.so"
</code>

==== Zero Brane Studio: IDE for TerraME ====

We suggest that you use [[http://studio.zerobrane.com | ZeroBraneStudio]] as your programming environment for developing TerraME programs. In Windows, please install the program to ''C:\ZeroBraneStudio''. In MAC and Linux, please use the default installation path.

After you download ZeroBraneStudio (ZBS), please do the following steps:

  - Configuration file: tells ZBS where to find the TerraME interpreter. Copy the [[http://www.dpi.inpe.br/gilberto/terrame/zerobrane/user.lua | user.lua]] configuration file to the "cfg" folder where you have installed ZBS. In Windows, it is usually "''C:\ZeroBraneStudio\cfg''". In the MAC, the folder is "''/Applications/ZeroBraneStudio.app/Contents/ZeroBraneStudio/cfg''". In Ubuntu, it is "''/opt/zbstudio/cfg''".
  - Interpreter description file: tells ZBS how to use TerraME. Copy the [[http://www.dpi.inpe.br/gilberto/terrame/zerobrane/terrame.lua | terrame.lua]] interpreter description file to the "interpreters" folder where you have installed ZBS. In Windows, this folder is "C:\ZeroBraneStudio\interpreters". In the MAC, it is "''/Applications/ZeroBraneStudio.app/Contents/ZeroBraneStudio/interpreters''". In Ubuntu, it is ''/opt/zbstudio/interpreters''.
  - Keyword description: tells ZBS to highlight both Lua and TerraME keywords. Copy the [[http://www.dpi.inpe.br/gilberto/terrame/zerobrane/lua.lua | lua.lua]] keyword description file to the "spec" folder where you have installed ZeroBraneStudio. In Windows, this folder is "C:\ZeroBraneStudio\spec".In the MAC, it is "''/Applications/ZeroBraneStudio.app/Contents/ZeroBraneStudio/spec''". In Ubuntu, it is ''/opt/zbstudio/spec''.
  - Optional: delete the other interpreters of ZeroBrane (Corona, Guideros, etc.) and leave only Lua, Lua5.2 and TerraME.

==== Additional Packages for TerraME ====

For this course, we are going to use additional packages:

  * [[http://www.dpi.inpe.br/gilberto/terrame/sysdyn_0.1.zip | System Dynamics]] - a package for modelling system dynamic problems.
  * [[http://www.dpi.inpe.br/gilberto/terrame/sci_0.1.zip | SciTerraME]] - a package for scientific and statistical functions in TerraME.

To install these packages, please save the "zip" files to a folder in your computer. Run TerraME, click on the button "Install New Package" and select the files one by one.
GeoInformatics.cc

User Tools

Site Tools

Page Tools
