= '''GDAL WKT Raster driver documentation''' =


= '''1 - Introduction''' =

WKT Raster is the project that provides '''raster support on PostGIS'''. 

This driver was developed during the [http://socghop.appspot.com/ Google Summer of Code] 2009. The driver only supports reading of regularly blocked in-db rasters. There are other functionalities under development:
  * Reading of non-regular blocked rasters.
  * Out-db raster support.
  * Create and modify rasters.
  * Integration with the GDAL utility programs.

== '''1.1 - Credits''' ==

'''Development '''
 * '''Jorge Arévalo''' develops the driver


== '''1.2 - More information''' ==
  * WKT Raster documentation page [http://trac.osgeo.org/postgis/wiki/WKTRaster/Documentation01 here]
  * Introduction to WKT Raster format and description of the work done during the Google Summer of Code 2009 [http://trac.osgeo.org/gdal/wiki/WKTRasterDriver here]
  * Search for "WKT Raster" in the [http://postgis.refractions.net/pipermail/postgis-users/ PostGIS-users] and [http://postgis.refractions.net/pipermail/postgis-devel/ PostGIS-devel] forums archives or in [http://www.nabble.com/PostGIS-f1221.html Nabble] or write to these forums.


= '''2 - Installation''' =

== '''2.1 - Requirements''' ==

For using GDAL WKT Raster driver, you will first need to install:

 * [http://www.postgresql.org/ PostgreSQL] version 8.3 or higher
 * [http://trac.osgeo.org/proj Proj4 library] version 4.4 or higher
 * [http://trac.osgeo.org/geos GEOS library] version 3.2.0 or higher
 * [http://postgis.refractions.net/ PostGIS] version 1.4.0 or higher
 * [http://trac.osgeo.org/postgis/wiki/WKTRaster WKTRaster PostGIS extension] version 0.1.6SVN or higher
 
== '''2.2 - Installed precompiled binaries''' ==

For the moment, there is no precompiled binaries. You can find precompiled binaries for the whole GDAL library [http://trac.osgeo.org/gdal/wiki/DownloadingGdalBinaries here]. The driver will be part of the library for 1.7.0 version.

== '''2.3 - Compiling and installing from sources''' ==

=== '''2.3.1 - Compiling on GNU/Linux''' ===

Follow the instructions to compile the requisites [http://www.gis4free.org/blog/2009/05/30/gsoc-09-weekly-report-1-2305-2905/ here] '''(only the 5 first steps)'''. After this, you will have to get the code of the ''fork'' of GDAL version 1.7.0SVN developed for the Google Summer of Code 2009. You can export the source code with Subversion from [http://www.gis4free.org/gdal_wktraster here] by:

{{{
>$ svn export http://www.gis4free.org/gdal_wktraster
}}}


The ''fork'' version of GDAL is compiled like the official one. You can find instructions on how to build GDAL library on UNIX-like systems [http://trac.osgeo.org/gdal/wiki/BuildingOnUnix here].

Once the driver is added to the official GDAL trunk, you should get the source code of GDAL from official's GDAL repository.


=== '''2.3.2 - Compiling on Windows''' ===

The GDAL library with the WKT Raster driver hasn't been yet compiled on Windows.

= '''3 - Using GDAL WKT Raster driver''' =

== '''3.1 - Loading raster data''' ==

== '''3.2 - Reading data''' ==

== '''3.3 - Creating and modifying data''' ==

= '''4 - GDAL WKT Raster driver reference''' =

= '''5 - Reporting problems''' =