software-cst-317-2015
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
software-cst-317-2015 [2015/08/14 09:42] gilberto |
software-cst-317-2015 [2016/06/20 21:22] pedro |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| 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 | 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 ===== | + | ====== Introduction to Earth System Modelling: Software ====== |
| - | ==== Software Description ==== | + | ===== 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: | + | 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. Please read the following introduction about TerraME, to get a sense of the language and what we are going to teach: |
| - | * {{http://www.dpi.inpe.br/gilberto/papers/mrel_paper.pdf|Experiences with a Socio-Environmental Modeling Course, //Modelling in Science Education and Learning//, 2014}} | + | * A primer on TerraME, 2016. |
| - | * {{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: | + | The next step is to learn the basics of Lua, which is a simple and elegant programming language. We provide an introduction about Lua for TerraME users: |
| - | * {{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://www.terrame.org/lib/exe/fetch.php?media=docs:luaforterrame-ashortintroduction2.pdf|Lua for TerraME: A Short Introduction.]] |
| - | * {{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 ==== | + | ===== TerraME ===== |
| - | Please first install the TerraME software, available at the [[https://github.com/TerraME/terrame/releases | TerraME github release site]]. | + | The TerraME software is available at the [[https://github.com/TerraME/terrame/releases | TerraME github release site]]. |
| - | === TerraME installation in Windows === | + | ==== TerraME installation in Windows ==== |
| - | Please install TerraME in "C:\TerraME" in Windows. | + | - Download the EXE application to your desktop. |
| + | - Doubleclick the EXE application. When prompted for an installation directory, please choose "C:\TerraME". | ||
| - | === TerraME installation in MAC OS X === | + | ==== TerraME installation in MAC OS X ==== |
| - | To install TerraME on a MAC, please follow the instructions below: | + | - Download the DMG application to your destktop. |
| + | - Double click the DMG application and move the TerraME icon to the Applications folder. | ||
| + | - In MAC OS X, TerraME should be run from a Terminal. To allow for terminal execution, please add the following line to your ".bash_profile": ''export PATH=$PATH:/Applications/terrame.app/Contents/bin'' | ||
| - | - 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 ==== | + | ===== 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. | 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. | ||
| Line 48: | Line 35: | ||
| After you download ZeroBraneStudio (ZBS), please do the following steps: | 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''". | + | ==== Zero Brane Studio in Windows ==== |
| - | - 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''. | + | - 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 ''C:\ZeroBraneStudio\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 ''C:\ZeroBraneStudio\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 ''C:\ZeroBraneStudio\spec''. | ||
| + | - Optional: delete the other interpreters of ZeroBrane (Corona, Guideros, etc.) and leave only Lua, Lua5.2 and TerraME. | ||
| + | |||
| + | ==== Zero Brane Studio in MAC OS X ==== | ||
| + | |||
| + | - 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 ''/Applications/ZeroBraneStudio.app/Contents/ZeroBraneStudio/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 ''/Applications/ZeroBraneStudio.app/Contents/ZeroBraneStudio/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 ''/Applications/ZeroBraneStudio.app/Contents/ZeroBraneStudio/spec''. | ||
| + | - Optional: delete the other interpreters of ZeroBrane (Corona, Guideros, etc.) and leave only Lua, Lua5.2 and TerraME. | ||
| + | |||
| + | ==== Zero Brane Studio in Linux ==== | ||
| + | |||
| + | - 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 ''/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 ''/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 ''/opt/zbstudio/spec''. | ||
| - Optional: delete the other interpreters of ZeroBrane (Corona, Guideros, etc.) and leave only Lua, Lua5.2 and TerraME. | - Optional: delete the other interpreters of ZeroBrane (Corona, Guideros, etc.) and leave only Lua, Lua5.2 and TerraME. | ||
| - | ==== Additional Packages for TerraME ==== | + | ===== Additional Packages for TerraME ===== |
| For this course, we are going to use additional packages: | 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. | + | * sysdyn - 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. | + | * sci - scientific and statistical functions in TerraME. |
| + | * ca - cellular automata models. | ||
| + | * logo - simple agent-based models. | ||
| - | 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. | + | To install these packages, run TerraME, click on the button "Install Package" and select the files one by one. |
software-cst-317-2015.txt · Last modified: 2016/07/05 11:25 by pedro
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 3.0 Unported
