====== Projeto TerraME GIMS ======
\\
{{ :leds:projetos:terramegims:imagens:terramegims_overview.png?nolink&850 }}
\\

===== O que é o TerraME GIMS? =====
O TerraME GIMS (TerraME Graphical Interface for Modeling and Simulation) é um ambiente integrado para a modelagem visual e simulação de fenômenos ambientais. O aplicativo estende as funcionalidades da plataforma Eclipse (www.eclipse.org) e permite construir, por meio de diagramas e da interação com widgets (componentes de interface gráfica), modelos na plataforma TerraME (Terra Modeling Environment). Os modelos são construídos utilizando-se metáforas visuais e o código correspondente, em TerraML (Terra Modeling Language), é gerado automaticamente. É possível ainda executar o modelo diretamente através da interface do TerraME GIMS.

A plataforma TerraME (www.terrame.org) é um ambiente de programação para a modelagem espacial dinâmica. Ela oferece suporte para a criação de modelos sobre espaços celulares bi-dimensionais baseados em autômatos celulares, agentes, e em rede. O TerraME oferece uma interface para a biblioteca TerraLib, permitindo a integração com bases de dados geográficos. Através da linguagem de modelagem TerraML, ela permite desenvolver modelos multi-escala e multi-paradigmas para aplicações ambientais.

O aplicativo TerraME  GIMS é desenvolvido e distribuído em duas versões: plug-in e RCP. A versão plug-in consiste em um conjunto de plug-ins para a plataforma Eclipse. Por sua vez, a versão RCP é uma aplicação stand-alone (não é necessário instalar o Eclipse).

  * versão RCP: é indicada para usuários sem experiência na plataforma Eclipse e que precisam apenas dos recursos do TerraME GIMS.
  * versão plug-in: é indicada para usuários com experiência na plataforma Eclipse e que necessitem utilizar outros recursos da desta, além do TerraME GIMS.

O TerraME GIMS se encontra na versão 1.2.0. Ela foi desenvolvida com base nos seguintes softwares e componentes: Eclipse Modeling Tools (versão Indigo SR2), Graphical Modeling Framework Tooling SDK (versão 3.0.2.201301191623), OCL Examples and Editors (versão 3.1.2.v201202060606).

===== Como obter? =====
A seguir são descritos os passos para instalar e configurar o TerraME e o TerraME GIMS.

==== TerraME ====
  * Como instalar / configurar (Windows)?
     - Baixar o TerraME 1.2.2 (www.terrame.org) e instalar por meio do wizard. Sugestão: instalar diretamente no C: ou D: (ex. C:\TerraME)
     - Testar a instalação: abrir o prompt de comando e digitar o comando "TerraME -version". Caso a instalação tenha sido bem sucedida, será exibida a versão do TerraME instalado.
  * Como instalar / configurar (Linux)?
     - Baixar e instalar o TerraME 1.2.2 (www.terrame.org). Obs.: para sistemas 64 bits é necessário instalar a dependência ia32-libs: abra o terminal e digite o comando "sudo apt-get install ia32-libs", informando a senha de usuário
     - Testar a instalação: no terminal digite o comando "TerraME -version". Caso a instalação tenha sido bem sucedida, será exibida a versão do TerraME instalado.
  * Como instalar / configurar (Mac)?
     - Baixar e instalar o Macports link (www.macports.org)
     - Atualiar os repositórios do Macports: abra o terminal e digite o comando "sudo port -v selfupdate", informando a senha de usuário
     - Após a atualização, instalar o Qt4: no terminal digite o comando "sudo port install qt4-mac"
     - Em seguida, instalar a biblioteca libpng: no terminal digite o comando "sudo port install libpng"
     - Baixar e instalar o TerraME 1.2.2 (www.terrame.org)
     - Após a instalação do TerraME, definir a variável de ambiente TME_PATH: (i) no terminal digite o comando "sudo open ~/.bash_profile"; (ii) adicione ao final do arquivo "export TME_PATH_1_2_2=/usr/local"; (iii) salve e feche o arquivo
     - Recarregar as variáveis de ambiente: no terminal digite "source ~/.bash_profile"
     - Testar a instalação: no terminal digite o comando "TerraME -version". Caso a instalação tenha sido bem sucedida, será exibida a versão do TerraME instalado.

==== TerraME GIMS versão RCP ====
  * Como instalar?
     - Baixar o TerraME GIMS versão RCP (//**[[leds:projetos:terramegims:downloads|DOWNLOAD]]**//)
     - Descompactar o TerraME GIMS no diretório desejado (ex. C:\terramegims)

==== TerraME GIMS versão plug-in ====
  * Como instalar (Windows, Linux, Mac)?
     - Baixar a plataforma Eclipse Indigo (3.7) versão Modeling Tools (http://www.eclipse.org/downloads/packages/release/indigo/sr2)
     - Descompactar o Eclipse no diretório desejado (ex. C:\eclipse)
     - Instalar o componente GMF Tooling (Graphical Modeling Framework Tooling): Help -> Install Modeling Components -> Concrete Syntax Development : Selecionar Graphical Modeling Framework Tooling -> Selecionar GMF Tooling SDK
     - Instalar o componente OCL Tools: Help -> Install Modeling Components -> Runtime and Tools : Selecionar OCL Tools -> Selecionar OCL Examples and Editors
     - Baixar o pacote de plug-ins do TerraME GIMS (//**[[leds:projetos:terramegims:downloads|DOWNLOAD]]**//)
     - Descompactar o pacote de plug-ins do TerraME GIMS na pasta plugins do Eclipse (ex. C:\eclipse\plugins). Atenção: copiar os arquivos ".jar" para a pasta plugins, e não a pasta.

==== Configurar o TerraME GIMS ====

  * Como configurar? Para executar os modelos diretamente pelo TerraME GIMS é necessário configurá-lo para executar o TerraME, seguindo os seguintes passos:
     - Run -> External Tools -> External Tools Configurations...
     - Na janela aberta selecione "Program" e adicione uma nova configuração clicando no botão "+" (New launch configuration)
     - Defina o nome para esta configuração: Name = TerraME
     - Configure os seguintes parâmetros na aba Main: Location = "C:\TerraME\bin\TerraME.exe" (interpretador do TerraME), Working Directory = "C:\TerraME\bin" (diretório do interpretador do TerraME), Arguments = ${selected_resource_loc}
     - Na aba Common marque a opção "Display in favorites menu"


===== Como utilizar? ======

==== Tutoriais =====
  * <del>Tutorial de instalação e configuração do TerraME (Windows | Linux | Mac)</del>
  * <del>Tutorial de instalação do TerraME GIMS (pdf | screencast-youtube)</del>
  * <del>Introdução ao TerraME GIMS (pdf | screencast-youtube)</del>

==== Artigos e relatórios =====
  * LIMA, T. F. M. ; CARNEIRO, T. G. S. ; FARIA, S. D. ; SILVA, P. H. A. ; PESSOA, M. S. . [[ http://ieeexplore.ieee.org/xpl/articleDetails.jsp?arnumber=6597192 | TerraME GIMS: An Eclipse Plug-In for Environmental Modeling ]]. In: [[http://se.inf.ethz.ch/events/topi2013/Program.html | Proceedings of the 3rd International Workshop on Developing Tools as Plug-Ins (TOPI)]]. 35th International Conference on Software Engineering (ICSE 2013), 2013, San Francisco, CA, USA. 2013. p. 37-42. ISSN: 2327-0748. DOI: 10.1109/TOPI.2013.6597192. The original publication is available at: [[ http://ieeexplore.ieee.org/xpl/articleDetails.jsp?arnumber=6597192 | IEEE Xplore ]]. {{:leds:publicacoes:downloads:paperconf_2013topi_limaetal2013.pdf|[paper]}} {{:leds:publicacoes:downloads:paperconf_2013topi_limaetal2013.bib|[bibtex]}}

  * LIMA, T. F. M. ; FARIA, S. D. ; CARNEIRO, T. G. S. . [[ http://dl.acm.org/citation.cfm?id=2029373 | Development of a didactic model for the hydrologic cycle using a graphical interface for the TerraME platform ]]. In: International Conference on Computational Science and its Applications, 2011, Santander, Espanha. The original publication is available at: [[http://dx.doi.org/10.1007/978-3-642-21898-9_7 | Lecture Notes in Computer Science Volume 6785, pp 75-90, 2011, Springer]]. [[http://dl.acm.org/citation.cfm?id=2029373|ACM DL]] {{:leds:publicacoes:downloads:paperconf_2011iccsa_limaetal2011.pdf|[pdf]}} {{:leds:publicacoes:downloads:paperconf_2011iccsa_limaetal2011.bib|[bibtex]}}

  * LIMA, T. F. M. ; FARIA, S. D. ; CARNEIRO, T. G. S. . Describing Graphically Multiscale Models for TerraME Platform. In: [[http://www.dsr.inpe.br/GeoChange/|Research Symposium GIScience for Environmental Change (GeoChange)]], 2010, Campos do Jordão, SP, Brasil. Proceedings of the GISScience for Environmental Change. Heidelberg: IOS Press, 2010. p. 43-48. {{:leds:publicacoes:downloads:paperconf_2010geochange_limaetal2010.pdf|[pdf]}} {{:leds:publicacoes:downloads:paperconf_2010geochange_limaetal2010.bib|[bibtex]}}

  * LIMA, T. F. M. ; CARNEIRO, T. G. S. ; FARIA, S. D. . Desenvolvimento de uma Plataforma Gráfica para a Descrição de Modelos de Sistemas Ambientais. In: [[ http://www.geoinfo.info/geoinfo2008/ | Proceedings of the X Brazilian Symposium on GeoInformatics ]], 2008, Rio de Janeiro, RJ, Brasil. p. 121-126. {{:leds:publicacoes:downloads:paperconf_2008geoinfo_limaetal2008.pdf|[paper]}} {{:leds:publicacoes:downloads:paperconf_2008geoinfo_limaetal2008.bib|[bibtex]}}

  * LIMA, T. ; CARNEIRO, T. ; LANA, R. ; CODEÇO, C. ; MARETTO, R. ; MEDEIROS, L. ; SILVA, L. ; SANTOS, L. ; REIS, I. ; COELHO, F. ; MONTEIRO, A. [[ http://dl.acm.org/citation.cfm?id=2694037 | A framework for modeling and simulating aedes aegypti and dengue fever dynamics ]]. In: [[http://wintersim.org/2014/ | Proceedings of the Winter Simulation Conference (WSC)]]. Winter Simulation Conference (WSC 2014), 2014, Savannah, GA, USA. 2014. p. 1481-1492. The original publication is available at: [[ http://dl.acm.org/citation.cfm?id=2693848.2694037 | ACM DL ]]. {{:leds:publicacoes:downloads:paperconf_2014wsc_limaetal2014.pdf|[paper]}} {{:leds:publicacoes:downloads:paperconf_2014wsc_limaetal2014.bib|[bibtex]}}

  * LIMA, T. F. M. ; CARNEIRO, T. G. S. ; FARIA, S. D. . Desenvolvimento de uma Plataforma Gráfica para a Descrição de Modelos de Sistemas Ambientais. In: [[http://www.geoinfo.info/geoinfo2008/papers/geoinfo2008-proceedings.pdf|Proceedings of the X Brazilian Symposium on GeoInformatics]], 2008, Rio de Janeiro. p. 121-126. {{leds:publicacoes:downloads:2008geoinfo_limaetal2008.pdf|[pdf]}} {{leds:publicacoes:downloads:2008geoinfo_limaetal2008.bib|[bibtex]}}

==== Comunidade =====
  * Grupo de usuários: https://groups.google.com/d/forum/terramegims_usr

===== Quem desenvolve / contribui? =====
A equipe de desenvolvimento do TerraME GIMS é formada pelos professores [[leds:equipe:tiagolima:index|Tiago França Melo de Lima]] (coordenador) e [[http://lattes.cnpq.br/4579376264162079|Tiago Garcia de Senna Carneiro]] (colaborador), da Universidade Federal de Ouro Preto (UFOP). A equipe também inclui alunos de graduação da UFOP:  [[leds:equipe:miguelpessoa:index|Miguel Soares Pessoa]], [[leds:equipe:pablosilva:index|Pablo Antunes Henrique Silva]], [[leds:equipe:rafaelmartins:index|Rafael de Souza Oliveira Martins]], [[leds:equipe:lucasferreira:index|Lucas Saraiva Ferreira]].

===== Como contribuir? =====
Se você deseja conhecer melhor e participar da comunidade de desenvolvedores do TerraME GIMS e do TerraME, entre em contato conosco. Você pode contribuir de várias maneiras:
  * enviando problemas encontrados e sugestões de melhoria para o grupo de usuários (https://groups.google.com/d/forum/terramegims_usr);
  * compartilhando modelos, artigos e relatórios de trabalhos utilizando o TerraME GIMS / TerraME;
  * ajudando na elaboração e tradução de tutoriais e documentos;
  * participando do desenvolvimento do software;
  * apoiando financeiramente o projeto.
Não deixe de entrar em contato: tiagolima@decsi.ufop.br