====== aRT: R-TerraLib API ====== [[http://www.r-project.org|{{:software:rlogo-2.png?155 }}]] [[http://www.terralib.org|{{ http://www.terralib.org/imagens/logo_terralib_index.png?155}}]] aRT 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. R is an open source language and environment for statistical computing and graphics. To learn more about R go to [[http://www.r-project.org/|R project]] web page. TerraLib is an open source GIS classes and functions library, available from the Internet as a collaborative environment for the development of GIS tools. For further information visit [[http://www.terralib.org/|TerraLib project]] web page. \\ ===== Download and Installation ===== ===General Installation=== - Install aRT dependencies as detailed in the **[[#Dependencies|dependencies section]]**. - Install as usual for R packages: > install.packages("aRT", contrib="http://www.leg.ufpr.br/aRT") See [[software:art:faq|FAQ]] for more details. ===Windows binary=== * Instead of using install.packages(), you can download **{{http://www.leg.ufpr.br/~pedro/aRT/aRT_1.9-2.zip|aRT_1.9-2.zip}}** (Thursday, 18-Feb-2014) and use 'Install package(s) from local zip files' from the 'Packages' menu. ===Source code=== |**[[http://www.leg.ufpr.br/~pedro/aRT/aRT_1.9-2.tar.gz|aRT_1.9-2.tar.gz]]** (Thursday, 18-Feb-2014)| ===== Dependencies ===== aRT depends on other availability of resources as follows and may not run correctly with versions other than indicated. ===Windows=== - **[[http://www.mysql.com/downloads/|MySQL]] version 5.5 or greater**. MySQL is an open source DBMS. - **[[http://cran-r.c3sl.ufpr.br/web/packages/sp/index.html|sp]] version at least 1.0-13**. sp is an R package with S4 classes and methods for spatial data. ===Linux=== * Automatic install of all dependencies: **install-aRT-dep {{http://www.leg.ufpr.br/~pedro/aRT/install-aRT-dep-32.zip|32}} and {{http://www.leg.ufpr.br/~pedro/aRT/install-aRT-dep-64.zip|64}} bits** are apt-based scripts (Debian, Ubuntu, and friends) to facilitate installing aRT dependencies. This script installs MySQL DBMS. * Individual dependencies - **[[http://www.mysql.com/downloads/|MySQL]] version 5.5 or greater**. MySQL is an open source DBMS. It is optional, but you have to install at least one DBMS. * apt install: apt-get install mysql-server-5.5 libmysqlclient-dev - **[[http://www.postgresql.org/|PostgreSQL]] version 8.3 or greater**. PostgreSQL is also an open source DBMS. It is optional, but you have to install at least one DBMS. * apt install: apt-get install postgresql postgis - **[[http://www.trolltech.com/|Qt]] version 3.3.3**. Qt is a multiplatform toolkit for the development of graphic interfaces, implemented by Trolltech. * apt install: apt-get install libqt3-mt-dev - **[[http://www.gdal.org/|GDAL]]**. Geospatial Data Abstraction Library. * apt install: apt-get install libgdal1-dev - **JPEG.** A library for working with jpeg image format. * apt install: apt-get install libjpeg62-dev - **Libdime**: A library for reading, constructing, manipulating, and writing DXF file data. Necessary to compile TerraView. * apt install: apt-get install libdime-dev - **Libdrm** A direct interface with video hardware using the Linux kernel's Direct Rendering Modules. Necessary to compile TerraView. * apt install: apt-get install libdrm-dev - **[[http://cran-r.c3sl.ufpr.br/web/packages/sp/index.html|sp]] version at least 0.9-26**. sp is an R package with S4 classes and methods for spatial data. - **[[http://www.terralib.org/|TerraLib]] version 4.2.0**. TerraLib is a library of classes for GIS. It is available under svn: mkdir terralib cd terralib svn co https://svn.dpi.inpe.br/terralib/tags/v-4-2-0/src mkdir dependencies cd dependencies svn co https://svn.dpi.inpe.br/terralib/tags/v-4-2-0/dependencies/linux cd .. svn co https://svn.dpi.inpe.br/terralib/tags/v-4-2-0/terraView mkdir build cd build svn co https://svn.dpi.inpe.br/terralib/tags/v-4-2-0/build/qt cd .. After that, compile terraView: LD_LIBRARY_PATH=$TERRALIB_DIR/terralib/Release/linux-g++ export LD_LIBRARY_PATH cd build/qt makeTerraLib directory needs to be registered in ''LD_LIBRARY_PATH''. Put the following lines in your ''.bashrc'' (change path to ''TERRALIBDIR'' if needed): TERRALIBDIR=/usr/local/terralib LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$TERRALIBDIR/terralib/Release/linux-g++ export LD_LIBRARY_PATH After that, you can running 'terraView' directly from bash (Important: some new versions of terraView require the argument host for connecting to a DBMS, therefore it is necessary to fill it with '127.0.0.1'). If TerraLib is located at any another directory you can still install aRT by calling (replace ''/terralib/dir'' accordingly): R CMD INSTALL --configure-args=--with-terralib=/terralib/dir/ aRT ===== Examples ===== The following two figures are one example of R data (from [[http://www.est.ufpr.br/geoR|geoR]] package) that can be exported to a TerraLib database, and then it can be visualized with [[http://www.dpi.inpe.br/terraview|TerraView]].
{{ http://www.leg.ufpr.br/~pedro/aRT/images/parana-r.jpg?400 }} {{ http://www.leg.ufpr.br/~pedro/aRT/images/parana-tv.jpg?500 }}
One of the main objectives of aRT is to do spatial queries and operations in R. For example, in the following figure we have a spatial data from a TerraLib database of Recife city, in Brazil. In the top left figure we have the map of Recife and its districts, with some points, and the bottom left figure shows the seweage. The other two result from spatial queries. The top right answers "Which districts contains the points (yellow) and which ones are their neighbours (green)?" and the bottom right answers "Which sewers are inside (red) or touches (green) the districts that contain the points?" {{ http://www.leg.ufpr.br/~pedro/aRT/images/saudavel.jpeg?500 }} Another example is shown below. In the left figure there are two cities and their neighbours of first and second order. The right side shows all the neighbours that are completely within a buffer given a distance from the polygons, and the ones that has some overlap with this buffer. {{ http://www.leg.ufpr.br/~pedro/aRT/images/neighborhood.jpg?500 }} ===== Documentation ===== ===User Guides (also distributed as package vignettes)=== * Introduction ([[http://www.leg.ufpr.br/~pedro/aRT/doc/aRTintro.html|html]], {{http://www.leg.ufpr.br/~pedro/aRT/doc/aRTintro.pdf|pdf}}) * Database connections ([[http://www.leg.ufpr.br/~pedro/aRT/doc/aRTconn.html|html]], {{http://www.leg.ufpr.br/~pedro/aRT/doc/aRTconn.pdf|pdf}}) * sp data ([[http://www.leg.ufpr.br/~pedro/aRT/doc/aRTsp.html|html]], {{http://www.leg.ufpr.br/~pedro/aRT/doc/aRTsp.pdf|pdf}}) * Tables and Queries ([[http://www.leg.ufpr.br/~pedro/aRT/doc/aRTtable.html|html]], {{http://www.leg.ufpr.br/~pedro/aRT/doc/aRTtable.pdf|pdf}}) * Filling cells ([[http://www.leg.ufpr.br/~pedro/aRT/doc/aRTfillcell.html|html]], {{http://www.leg.ufpr.br/~pedro/aRT/doc/aRTfillcell.pdf|pdf}}) * GPM ([[http://www.leg.ufpr.br/~pedro/aRT/doc/aRTgpm.html|html]], {{http://www.leg.ufpr.br/~pedro/aRT/doc/aRTgpm.pdf|pdf}}) ===Papers and Presentations=== * aRT: R-TerraLib API. P. R. Andrade, P. J. Ribeiro Junior. [[http://www.r-project.org/useR-2006/|useR! 2006]] ({{http://www.leg.ufpr.br/~pedro/aRT/docs/aRTuseR.pdf|presentation}}, and a [[http://www.r-project.org/useR-2006/Photos/Conference/6.html|photo!]]) * Integration of Statistics and Geographic Information Systems: the R/TerraLib Case. P. R. Andrade, P. J. Ribeiro Junior, K. Fook. [[http://www.geoinfo.info/|GeoInfo 2005]] ({{http://www.leg.ufpr.br/~pedro/aRT/docs/P74.pdf|paper}}, {{http://www.leg.ufpr.br/~pedro/aRT/docs/IntegrationRTerraLib.pdf|presentation}}) * A Process and Environment for Embedding The R Software into TerraLib. P. R. Andrade, P. J. Ribeiro Junior. [[http://www.geoinfo.info/|GeoInfo 2005]] ({{http://www.leg.ufpr.br/~pedro/aRT/docs/p70.pdf|paper}}, {{http://www.leg.ufpr.br/~pedro/aRT/docs/ProccessAndEnvironment.pdf|presentation}}) ===Data sets and scripts=== Please uncompress the zip files in the current folder before running the scripts. For more examples, see folder 'tests' within aRT installation folder. * Creating cells and filling attributes ({{http://www.leg.ufpr.br/~pedro/aRT/data/rondonia.R|script}}, {{http://www.leg.ufpr.br/~pedro/aRT/data/rondonia.zip|shapefile data}}) * Union of polygons ({{http://www.leg.ufpr.br/~pedro/aRT/data/meso-parana.R|script}}, {{http://www.leg.ufpr.br/~pedro/aRT/data/meso-parana.zip|shapefile data}}) * Neighbourhood, relations, and metrics ({{http://www.leg.ufpr.br/~pedro/aRT/data/northwest.R|script}}, {{http://www.leg.ufpr.br/~pedro/aRT/data/northwest.zip|data dumped from R}}) * Neighborhood matrix and analysis with spdep ({{http://www.leg.ufpr.br/~pedro/aRT/data/neigh-parana-aRT.R|script aRT}}, {{http://www.leg.ufpr.br/~pedro/aRT/data/neigh-parana-maptools.R|script maptools}}, {{http://www.leg.ufpr.br/~pedro/aRT/data/neigh-parana.zip|shapefile data}}) * Adehabitat example ({{http://www.leg.ufpr.br/~pedro/aRT/data/adehabitat-peixeboi.R|script}}, {{http://www.leg.ufpr.br/~pedro/aRT/data/peixe_boi.zip|shapefile data}}) ===Courses=== * [[software:art:course|An Introduction to aRT]] (in portuguese) ===Other links=== * aRT [[software:art-dev|development page]] * [[software:art:faq|FAQ]] * [[http://www.leg.ufpr.br/~pedro/aRT/CHANGES|Change log]] * [[http://www.leg.ufpr.br/~pedro/aRT/old|Old versions]] (source code, see changelog for system requirements) * [[http://www.leg.ufpr.br/~pedro/aRT/old/win|Old Windows versions]] (see changelog for TerraLib version) * R resources for spatial statistics at the [[http://cran.r-project.org/web/views/Spatial.html| the CRAN spatial task view]]. ===== Contact ===== ===Discussion list=== * **art_l at leg.ufpr.br** ===Developers=== * [[http://leg.ufpr.br/~pedro|Pedro Ribeiro de Andrade]] - pedro.andrade at inpe.br (maintainer) * [[http://leg.ufpr.br/~paulojus|Paulo Justiniano Ribeiro Junior]] - paulojus at ufpr.br * Eduardo Sant'Ana da Silva - eduardo.santanadasilva at gmail.com * Henrique Dallazuanna - wwwhsd at gmail.com ===Collaborators in earlier versions=== * Marcos Aurélio Carrero * Adriana Zanella Martinhago * Thiago Eugênio Bezerra de Melo * Elias Teixeira Krainski * Karla Donato Fook ===== Acknowledgements ===== aRT has been developed with the computational resources of the Laboratory of Statistics and Geoinformation (LEG), at UFPR, together with Earth System Science Center (CST) and Image Processing Division (DPI), at INPE. [[http://wiki.leg.ufpr.br/doku.php/|{{http://www.leg.ufpr.br/~pedro/aRT/images/leg.jpg?100}}]] [[http://www.ufpr.br/portal/|{{http://www.leg.ufpr.br/~pedro/aRT/images/ufpr.jpg?130}}]] [[http://www.dpi.inpe.br/|{{http://www.leg.ufpr.br/~pedro/aRT/images/dpi.jpg?150}}]] [[http://www.ccst.inpe.br/#|{{http://www.leg.ufpr.br/~pedro/aRT/images/logo-ccst.jpg?230}}]] [[http://www.inpe.br/|{{http://www.leg.ufpr.br/~pedro/aRT/images/inpe.jpg}}]] This project is partially supported by Fapesp, process number 04/11012-0, FPLF process 2005.05.066, and CNPq 552044/2002-4. [[http://www.fapesp.br|{{http://www.leg.ufpr.br/~pedro/aRT/images/logo-fapesp.gif}}]] [[http://www.fplf.org.br|{{http://www.leg.ufpr.br/~pedro/aRT/images/logo_fplf.gif?90}}]] [[http://www.cnpq.br|{{http://www.leg.ufpr.br/~pedro/aRT/images/logo_cnpq.jpg}}]] [[http://www.dpi.inpe.br/saudavel/english.html|{{http://www.leg.ufpr.br/~pedro/aRT/images/saudavel-logo.jpeg?300}}]] ===== Statistics ===== Locations of visitors to this page [[http://www.leg.ufpr.br/~pedro/aRT/images/art-couts-2009-grande.jpg|{{http://www.leg.ufpr.br/~pedro/aRT/images/art-couts-2009-pequeno.jpg|Last Year}}]]