  TerraLib - Dependencies
  =======================

If you want to build yourself TerraLib then you need to install some third-party libraries.

For Microsoft Visual C++ users we have prepared a zip file in a binary format. 
It contains all the third-party libraries for building a 64-bit version of TerraLib with Qt 5.12.3pport.

You can download the 3rdparty package from 3 places:
   1) The 3rdparty used by tagged version:  
     http://www.dpi.inpe.br/terralib5/terralib5-3rdparty
	       choose the rigth tag 5.y.z: terralib-5.y.z-3rdparty-msvc-2017-win64.zip

   2) The 3rdparty used by developers of terralib team to work with 'develop' branch : 
     http://www.dpi.inpe.br/terralib5-devel/3rdparty/bin/terralib5-3rdparty-msvc-2017-win64.zip

   3) The 3rdparty used by developers to correct bugs in a specific branch ('release-5.x'): 
     http://www.dpi.inpe.br/terralib5-devel/3rdparty/bin: choose one of the directories aligned with the release-5.y branch
	     /5.6/terralib5-3rdparty-msvc-2017-win64.zip  - branch 'release-5.6'
		 /5.5/terralib5-3rdparty-msvc-2017-win64.zip  - branch 'release-5.5'
		 
NOTE: The zip file downloaded from (2) or (3) might not work with tagged version.


Below is a list of third-party libraries dependencies and its versions.

1. Boost (Mandatory)
--------------------

TerraLib is built on top of Boost libraries. You will need to have them installed in order to build TerraLib.

Make sure to have at least version 1.74 installed.

If you prefer to install from source, download it from:
http://www.boost.org


2. Qt (Optional)
----------------

Make sure you have an installed version of  Qt 5.12.3 or later.

Linux users may use any package manager to perform an easy installation.

Mac OS X can use package managers such as Homebrew (http://brew.sh) or MacPorts (http://www.macports.org) in order to have an easy installation.

If you prefer to install from source, download it from:
http://qt-project.org/downloads.

Make sure to have at least version 4.6.3 installed.

Windows users that had downloaded the auxiliary package (in the TerraLib site) must install Qt 5.4.1


3. QtPropertyBrowser (Optional)
-------------------------------

QtPropertyBrowser is a free and open source Qt component available from:
https://qt.gitorious.org/qt-solutions/qt-solutions

We have been using a special port of QtPropertyBrowser that you can get from here:
http://www.dpi.inpe.br/terralib5-devel/qtpropertybrowser.tar.gz

You can extract the qtpropertybrowser.tar.gz files using:

$ tar xzvf qtpropertybrowser.tar.gz

Run qmake specifying the installation directory:

$ qmake "TERRALIB_DIR=install_dir"

Run make and make install:

$ make
$ make install


4. Qwt (Optional)
-----------------

Qwt is available from http://qwt.sourceforge.net.

Make sure to have at least version 6.1.2 installed


5. GDAL (Optional)
------------------

GDAL is available from http://www.gdal.org.

Make sure to have at least version gdal-3.1.2 installed.


6. PostgreSQL libpq (Optional)
------------------------------

libpq is available with PostgreSQL source from http://www.postgresql.org.

Make sure to have at least version 9.4.1 installed. 


7. Microsoft Jet database engine ADO (.mdb) versus  
   Microsoft Access Database Engine (.accbd)   - (optional)
---------------------------

Microsoft ADO is available with Microsoft Office 2007 package
and usually is its installed under a folder such as:

C:\Program Files (x86)\Common Files\System\ado
C:\Program Files (x86)\Common Files\System\Ole DB

or (for 64bits)

C:\Program Files\Common Files\System\ado
C:\Program Files\Common Files\System\Ole DB\Ole DB

If you do not have Office 2007 installed you can download the 
AccessDatabaseEngine from  

https://www.microsoft.com/en-us/download/details.aspx?id=13255

     AccessDatabaseEngine.exe     (32-bit version)
     AccessDatabaseEngine_x64.exe (64-bit version)

NOTE: Some problems might occur if 32 and 64 bits are installed. 
See the Terralib4 plugin documentation if you need both versions installed.

http://www.dpi.inpe.br/terralib5/help/help_5.6.1/plugins/terralib4/Terralib4ConverterACE.html


8. Xerces-c (Optional)
----------------------

Apache Xerces-C++ is available from http://xerces.apache.org/xerces-c.

Make sure to have at least version 3.1.4 installed.


9. GEOS (Optional)
------------------

GEOS is available from http://trac.osgeo.org/geos.

Make sure to have at least version 3.8.1 installed.

10. Proj4 (Optional)
--------------------

Proj4 is available from http://trac.osgeo.org/proj.

Make sure to have at least version 7.1.0 installed.


11. GNU Iconv (Optional)
------------------------

GNU Iconv is available from https://www.gnu.org/software/libiconv.

Any recent version may be used.


12. GNU gettext (Optional)
--------------------------

GNU gettext is available from https://www.gnu.org/software/gettext.

Any recent version may be used.


13. Google Test and Google Mock (Optional)
--------------------------

Google Test and Google Mock are available from https://github.com/google/googletest.

Any recent version may be used.


For more information on TerraLib, please, visit its main web page at:
http://www.terralib.org


  November 2020, TerraLib Team <terralib-team@dpi.inpe.br>
