Personal tools


From HaskellWiki

(Difference between revisions)
Jump to: navigation, search
Line 62: Line 62:
  #ghci SpatialOper.hs  
  #ghci SpatialOper.hs  
printing some test values, e.g.:
Printing some test values, e.g.:

Revision as of 12:02, 30 November 2009


1 What is it ?

Logo terrahs.png is a software component that enables the development of geographical applications in a functional language, using the data handling capabilities and spatial operations of TerraLib. TerraLib is a C++ library that supports different spatial database management systems, and that includes a large number of spatial algorithms. As a result, we get a combination of the good features of both programming paradigms.

2 Features

  • Input and output formats: Layers or themes from TerraLib databases (just MySQL), Esri Shape File (*.shp), TIFF file.
  • Data types: Raster or image (just 8 bits), Vectors (Point, Line, Polygon and Cell), Temporal (DateTime, Interval)
  • Topological operators: intersects, within, touches, crosses ...
  • Geometric operations: intersection, union, difference, rotation.
  • Metrical operations: perimeter, area, distance, centroid, shapeindex, compacity, fractal

3 Demos

Example of vector data that can be exported to a TerraLib database, and then it can be visualised with TerraView.


The pattern for a main program in TerraHS has the following structure:

module Main(main) where
import TerraHS
host = "localhost";
dbname =  "demo_terrahs";
user = "root";
password = "root";
main:: IO()
main = do
	-- loading a vector data from a shape file
	gos <- loadVectorFile "MG_MUN96.shp"
	-- open a connection
	db <- open (TeMySQL host user password dbname)
	-- saving in a database layer
	store db "layer_name" gos
	print "saved"

Two different outcomes from a image data and theirs respective operations (a)input image, (b) inverted image and (c) reverse image.

Res imagens.png

The following examples use this data:

Its possible to run in the ghci:

 #ghci SpatialOper.hs 

Printing some test values, e.g.:

 Main> main
 Loading package syb ... linking ... done.
 Loading package base- ... linking ... done.
 Loading package terrahs-0.8 ... linking ... done.
 TePoint (12.5,10.0)
 TeLine2D [(1.0,1.0),(1.0,2.0),(1.0,7.0)]
 TePolygon [TeLine2D [(1.0,1.0),(1.0,2.0),(3.0,2.0),(3.0,1.0),(1.0,1.0)]]

or compile and run:

#ghc SpatialOper.hs -package terrahs-0.8 -o main

More details about the api in source documentation - online (HTML)

4 Download and Installation

TerraHS is a Haskell GIS application built using the TerraLib GIS library. In below, is available a debian packages for TerraLib. TerraHS-0.8 uses the TerraLib-3.3.0 version.

Optional, but is recommended to install the TerraView application.TerraView is a GIS application based on TerraLib, a GIS library to handle vector and raster data in geographical DBMS such as Access, PostgreSQL, MySQL and Oracle Spatial.

We have developed some specific libraries to support some functionalities for TerraHS.

Translib, a library for translation among different geographic format files (no database connection), based in the TerraLib library. This library is required for TerraHS to deal whith shape files (*.shp). Terralib4c is a library that maps c++ Terralib functions and classes to C functions.

Other requirements are: (a) GHC-6.8.3(or newer version) and (b) MySQL-5.0.41.

4.1 Installation notes for Windows

First, is necessary to install MySQL 5.0, and optionaly TerraView:

Logo-win.pngTerraView-3.3.0 for Windows

Other libraries are available in:

Logo-win.pngTerraHSdependecies install for Windows (TerraLIB+Terralib4C+Translib)

After that, download TerraHS and unzip the archive. From a prompt, move into the created directory and run the following commands:

runhaskell Setup configure --extra-lib-dirs: C:\TerraHSExtLibs 
runhaskell Setup build 
runhaskell Setup install 

The extra-lib-dirs depend of the path where was installed the TerraHSdependencies.

4.2 Installation notes for Debian distributions

The MySQL is usualy available in the Linux package of your distribution, you just check if it already installed.

For debian distributions, is possible to install they from debian packages:

Ubuntu-icon.pngTerraLib-3.3.0 for (Ubuntu 9.04 (i386))

Ubuntu-icon.pngTerraLib-3.3.0 for (Ubuntu 9.04 (amd_64))

Ubuntu-icon.pngTerraView-3.3.0 for (Ubuntu 9.04 (i386))

Ubuntu-icon.pngTerraHSdependecies (TerraLib4c + Translib) for Ubuntu 9.04 (i386)

Ubuntu-icon.pngTerraHSdependecies (TerraLib4c + Translib) for Ubuntu 9.04 (amd_64)

The TerraLib4c and Translib can be downloaded in separated way:

Ubuntu-icon.pngTranslib for Ubuntu 9.04 (i386)

Ubuntu-icon.pngTerralib4c for Ubuntu 9.04 (i386)

The installation procedure:

 #sudo dpkg -i package.deb

The uninstallation procedure:

 #sudo dpkg -r package

After that, download TerraHS in cabal package from Hackage and unzip the archive. From a prompt, move into the created directory and run the following commands:

runhaskell Setup configure 
runhaskell Setup build 
sudo runhaskell Setup install 

It is done.

4.3 Installation notes for generic Linux

The TerraLib and TerraView source files and instalation notes:

TerraLib4c and Translib are available as usual source Linux package in:

Linux-icon.pngTranslib Source

Linux-icon.pngTerraLib4c Source

The installation procedure:

#tar xvzf package.tar.gz
#cd package
#sudo make install

The uninstallation procedure:

 #cd package
 #sudo make uninstall

The installation of TerraHS is the same of Debian distribution:

runhaskell Setup configure 
runhaskell Setup build 
sudo runhaskell Setup install 

5 Papers, thesis and Reports

Some papers and thesis that use TerraHS:

  • Sérgio Costa, Gilberto Câmara, Prototyping GIS Application in Functional Programming. In: GeoPantanal, 2009, Corumbá. Anais do II Geopantanal, 2009. download
  • Costa, S. S., Câmara, G., & Palomo, D. (2007). TerraHS: Integration of Functional Programming and Spatial Databases for GIS Application Development. (pp. 127-149). Advances in Geoinformatics. Springer. link
  • Sergio Costa, Gilberto Câmara, Danilo Palomo. TerraHS: Integration of Functional Programming and Spatial Databases for GIS Application Development. VIII Brazilian Symposium in Geoinformatics, GeoInfo 2006, Campos do Jordão, 2006. download
  • Olga Bittencourt, Gilberto Câmara, Lúbia Vinhas, Joice Mota. Rule-based Evolution of Typed Spatio-temporal Objects. IX Brazilian Symposium in Geoinformatics, GeoInfo 2007, Campos do Jordão,
  • Sérgio Rosim. Estrutura baseada em grafos para representação unificada de fluxos locais para modelagem hidrológica distribuída. PhD Thesis in Computer Science at INPE,