= PostGIS Raster Home Page (formerly WKT Raster) = 


{{{
#!html
<div style='float: right; margin-left: 5px; width: 260px; font-size: small;' > 
<div style='padding:5px; background-color: #F4F4F4; border: 1px solid gray;' >
<B>Quick Links</B><BR>

<UL>
<LI><A href=http://trac.osgeo.org/postgis/wiki/WKTRaster/PlanningAndFunding>Planning & Funding</A></LI>

<LI><A href=http://trac.osgeo.org/postgis/wiki/WKTRaster/Documentation01>Beta Documentation</A></LI>
<LI><A href=http://trac.osgeo.org/postgis/wiki/WKTRaster/FAQ>FAQ</A></LI>
<LI><A href=http://trac.osgeo.org/postgis/wiki/WKTRaster/SpecificationWorking02>Working Specs for PostGIS 2.0</A></LI>
<LI><A href=http://trac.osgeo.org/postgis/wiki/WKTRaster/SpecificationWorking03>Working Specs for Future Versions</A></LI>

<LI><A href=http://trac.osgeo.org/postgis/report/17> Open Tickets</A></LI>
</UL>

</div>
<div style='padding:5px; background-color: #FFDE38; border: 1px solid gray;' >

<B>What's new about PostGIS Raster?</B><BR><BR>

<I>February 14, 2011</I><BR><B>Two plugins to see PostGIS raster!</B><BR>Thanks to Maurício de Paulo, there is now a plugin to display PostGIS rasters in QGIS. Look for "wktraster" in the [http://pyqgis.org/repo/contributed QGIS plugin page] and [http://mapeandoobrasil.blogspot.com/2010/12/postgis-raster-plugin-para-qgis.html Mauricio's article] (if you can decrypt portuguese!). Same for gvSIG the popular spanish open source GIS! Nacho Brodin has develop a plugin to display raster stored in PostGIS. See the [http://www.osor.eu/projects/gvsig-postgisra page of the project]. On our side we are woking fixing bugs and implementing ST_MapAlgebra. See you at the Code Sprint in Montréal (march 15-18)!<BR><BR>


<I>September 15, 2010</I><BR><B>WKT Raster becomes THE new PostGIS raster type!</B><BR>It's official! The WKT Raster extension will become the new PostGIS RASTER type in PostGIS 2.0 planned for next april. The PostGIS and the WKT Raster team met at the FOSS4G friday's code sprint and decided that WKT Raster was mature enough to bring interesting new functionalities to PostGIS. A new MapAlgebra function should be added for this release. Congratulation to the whole team for all the work accomplished!<BR><BR>

<I>August 11, 2010</I><BR><B>PostGIS WKT Raster at FOSS4G</B><BR>There should be a lot of discussion about PostGIS WKT Raster at FOSS4G, the most important conference for free and open source software for geomatics, as both Pierre Racine and Jorge Arévalo presentations have been selected by the attendees. Pierre will first introduce the project in a presentation entitled “<A href=http://trac.osgeo.org/postgis/attachment/wiki/WKTRaster/FOSS4G2010_Pierre.pdf>Introducing PostGIS WKT Raster: Seamless raster/vector operations in a spatial database</A>” and Jorge will present the result of its meticulous study of the difference between PostGIS WKT Raster and Oracle GeoRaster in a presention entitled “<A href=http://trac.osgeo.org/postgis/attachment/wiki/WKTRaster/FOSS4G2010_Jorge.pdf>PostGIS WKT Raster. An Open Source alternative to Oracle GeoRaster</A>”. You can already read Jorge’s first impression in <A href=http://gis4free.wordpress.com/2010/07/19/oracle-georaster-part-i/>his first article in a series</A>. CU September 6th 2010 in Barcelona!<BR><BR>

<I>June 11, 2010</I><BR><B>A tutorial and a book!</B><BR>The <A href=http://www.manning.com/obe/>PostGIS in Action</A> chapter on PostGIS WKT Raster is out! Thanks to Regina Obe and Leo Hsu, there is already a good amount of literature on WKT Raster and this makes WKT Raster to be a little bit more in the PostGIS family. Pierre Racine has also written <A href=http://trac.osgeo.org/postgis/wiki/WKTRasterTutorial01> a tutorial on how to import and intersect a huge raster coverage with a vector coverage</A>. Your raster coverage is huge and you can't work with it in your favorite GIS platform? Read the tutorial! You will be amazed by the simplicity and the speed of the intersection functions. Good reading!<BR><BR>

<I>February 22, 2010</I><BR><B>A third company join the WKT Raster team!</B><BR>The award-winning GIS software development firm, <A href=http://www.avencia.com>Avencia</A>, specializing in web-based geographic analysis, visualization and modeling applications, decided to invest in WKT Raster development. The company sent David Zwarg and Jeff Adams to <A href=http://blog.cleverelephant.ca/2010/02/nyc-sprint-day-1.html>the Code Sprint 2010 in NY</A>. Jeff worked on PostGIS and David helped with many WKT Raster base functions. David committed himself to work on many other WKT Raster functions in the near future. His main task will be to design and implement the ST_MapAlgebra() and the ST_Resample() functions. Welcome David!<BR><BR>


<I>December 10, 2009</I><BR><B>Tyler Erickson speaks about his need for PostGIS WKT Raster at FOSS4G 2009</B><BR><A href=http://wiki.mtri.org/display/mtripub/tyler+erickson>Tyler Erickson</A>, Research Scientist at the Michigan Tech Research Institute <A href=http://download.osgeo.org/osgeo/foss4g/2009/SPREP/2Thu/Parkside%20GO4/1030/Thu%20G04%201130%20Erickson/Erickson_foss4g.ppt>presented his research project</A> at <A href=http://2009.foss4g.org/researchpapers/#researchpaper_5>FOSS4G 2009</A> in Sydney, Australia. Tyler uses <A href=http://geodjango.org/>GeoDjango</A> and PostGIS to visualise the results of CO2 simulation models directly in Google Earth. WKT Raster would enable him to easily do raster/vecter spatial analysis from his web application. Tyler's project was selected as one of the professional winners in Google’s 2009 KML in Research Competition.<BR><BR>

<I>December 4, 2009</I><BR><B>Jorge Arevalo full time on WKT Raster!</B><BR>Jorge Arevalo who developped the first version of the GDAL WKT Raster driver during the summer of 2009 will be working for at least one year on WKT Raster. Jorge is working for <A href=http://www.deimos-space.com/UK/index.asp?lang=UK>DEIMOS Space</A>, a Spanish aerospace company leading the <A href=http://www.espanavirtual.org/?q=en>Espana virtual</A> project. Jorge's superior, Miguel Lizondo, confirmed that Jorge would be devoting most of his time to WKT Raster in the coming year. This commitment should normally be extended for a second year afterward.<BR><BR>Jorge will follow the planned roadmap and will be the main developper for the coming year. <A href=http://mateusz.loskot.net/>Mateuzs Loskot</A> will continue contribute his spare time to the project and <A href=http://www.cef-cfr.ca/index.php?n=Membres.PierreRacine>Pierre Racine</A> will help Jorge with the specifications and the general management of the project.<BR><BR>Welcome (back) Jorge!<BR><BR>


<I>October 16, 2009</I><BR><B><A href=http://www.geomatique2009.com/fr/conferences/programme>PostGIS WKT Raster at Geomatique 2009 in Montréal</A>!</B><BR>Pierre Racine will present WKT Raster at Geomatique 2009 in Montréal on October 20. We hope we can get more people interested by the project! <A href=http://trac.osgeo.org/postgis/attachment/wiki/WKTRaster/WKTRasterIntro-Geomatique2009.pdf>See the presentation (PDF)!</A><BR><BR>

<I>June 04, 2009</I><BR><B><A href=http://gis4free.wordpress.com/>A prototype GDAL driver to WKT Raster implemented this summer</A>! </B><BR>Thanks to Mateusz Loskot, who proposed the Google Summer of Code project and Jorge Arevalo the student who was selected to implement it. 

</div>
</div>
}}}

Welcome to the '''PostGIS Raster''' project home page!

'''PostGIS Raster''' is an ongoing project aiming at developing '''raster support in PostGIS'''. It is a new project very different from the previous PGRaster project and also very different from [http://en.wikipedia.org/wiki/GeoRaster Oracle Spatial GeoRaster].

The goal of '''PostGIS Raster''' is to implement the RASTER type '''as much as possible like the GEOMETRY type''' is implemented in PostGIS and to offer '''a single set of overlay SQL functions''' (like ST_Intersects) operating '''seamlessly''' on vector and raster coverages.

== Installation ==

 * '''Linux -''' You will have to compile PostGIS Raster following the instructions in the Development Info section below.

 * '''Windows Binaries - ''' If you are running PostGIS on Windows, you can find fairly recent binaries of PostGIS Raster in the [http://www.postgis.org/download/windows/experimental.php Windows Experimental Builds section] along with binaries of the most recent PostGIS. These are for PostgreSQL 8.3, 8.4, upcoming 9.0.  Note that development on the standalone wktraster project deployable on PostGIS 1.3-1.5 has stopped and all future versions and bug fixes of raster support will be packaged in the PostGIS 2.0 builds.

 * '''Mac OSX Binaries - ''' If you are running PostGIS on Mac OSX leopard or Snow Leopard, you can find fairly recent binaries of PostGIS and PostGIS Raster at [http://www.kyngchaos.com/software/postgres KyngChaos PostgreSQL GIS] packages include PostgreSQL 8.4, PostGIS 1.5, PostGIS Raster, and pgRouting.

 * '''GDAL WKT Raster driver - ''' A [http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html GDAL WKT Raster driver] was developed following a [http://socghop.appspot.com/ Google Summer of Code 2009] grant obtained by [http://gis4free.wordpress.com/ Jorge Arevalo].

== Documentation ==

 * '''Documentation - ''' [wiki:WKTRaster/Documentation01 PostGIS Raster Documentation] is under development.

 * '''Function Reference - ''' You  will find every raster function documented [http://postgis.refractions.net/documentation/manual-svn/RT_reference.html as a chapter of the svn PostGIS documentation]. Find also some more useful functions [wiki:WKTRasterUsefulFunctions in this page].

 * '''Tutorials - ''' [wiki:WKTRasterTutorial01 This tutorial] will show you how to load a huge raster coverage and intersect it with a vector coverage. Jorge has a whole series on PostGIS Raster and comparing activities you do in Oracle GeoRaster vs. how you would do them with PostGIS Raster. Check out [http://gis4free.wordpress.com/category/postgis-raster/ Jorge's PostGIS Raster Tutorial Series].

 * '''Book - ''' [http://www.postgis.us/chapter_13 PostGIS in Action] has a full chapter dedicated to PostGIS Raster.

 * '''Presentations'''[[BR]][[BR]]
   * Introducing PostGIS WKT Raster: Seamless !Raster/Vector Operations in a Spatial Database - FOSS4G 2010, Barcelona, Spain, September 2010. [attachment:FOSS4G2010_Pierre.pdf PDF]
   * PostGIS WKT Raster. An Open Source alternative to Oracle !GeoRaster - FOSS4G 2010, Barcelona, Spain, September 2010. [attachment:FOSS4G2010_Jorge.pdf PDF]
   * Introduction to WKT Raster - Geomatique 2009, Montréal, October 2009. [attachment:WKTRasterIntro-Geomatique2009.pdf PDF]
   * Original Project Presentation - rationale, examples and preliminary specifications: [http://www.cef-cfr.ca/uploads/Membres/WKTRasterSpecifications1.0.ppt PPT], [http://www.cef-cfr.ca/uploads/Membres/WKTRasterSpecifications1.0.pdf PDF] (v1.0)

== Development Info ==

 * '''Planning'''[[BR]][[BR]]
   * With PostGIS 2.0: Spring 2011.
   * Look [wiki:WKTRaster/PlanningAndFunding at the planning page] for a detailed schedule and to know how to contribute.

 * '''Specifications -''' To know more about or contribute your ideas about the design of PostGIS Raster consult [wiki:WKTRaster/SpecificationWorking01 the working specification page]. Accepted specifications are aggregates into the [wiki:WKTRaster/SpecificationFinal01 final specification page]. 

 * '''Source Code, API and Bug report'''[[BR]][[BR]]
   * PostGIS Raster source code is available from the OSGeo Subversion repository
{{{
svn checkout https://svn.osgeo.org/postgis/spike/wktraster wktraster
}}}
   * You can also download the latest development snapshot from: http://www.postgis.org/download/ [[BR]][[BR]]
   * Compilation instructions are availables in the [wiki:WKTRaster/Documentation01 Documentation].[[BR]][[BR]]
   * API reference is available on [http://postgis.refractions.net/documentation/raster-doxygen/ PostGIS Raster Doxygen] pages.[[BR]][[BR]]
   * See report with [report:17 All tickets reported to PostGIS Raster]

== Displaying PostGIS rasters ==

There are some options to display rasters stored in PostGIS.

 * '''!OpenJump''' - !OpenJump will not display raster directly but a vectorization of the raster. Use a query like the following in the "Layer->Execute Query" dialog: 

{{{
SELECT ST_AsBinary((ST_DumpAsPolygons(rast)).geom), (ST_DumpAsPolygons(rast)).val
FROM rastertable
}}}

 * '''QGIS''' - There is now a plugin for QGIS displaying PostGIS rasters. See [http://www.mail-archive.com/qgis-user@lists.osgeo.org/msg07761.html the original thread], [http://mapeandoobrasil.blogspot.com/2010/12/postgis-raster-plugin-para-qgis.html Mapeando o Brasil] and [http://pyqgis.org/repo/contributed the QGIS plugin page]. For more info on the status of the plugin, contact Maurício de Paulo (mauricio.dev@gmail.com).

 * '''gvSIG''' - There is also a plugin for gvSIG, the popular spanish open source GIS. See [http://www.slideshare.net/nbrodin/postgisrastergvsig the presentation], [http://forge.osor.eu/docman/view.php/313/560/PostGISRaster-0.1-man-en.pdf the documentation] and [http://www.osor.eu/projects/gvsig-postgisra the project page]. The plugin should be integrated into gvSIG 1.11. For more info on the status of the plugin, contact Nacho Brodin (ibrodin@prodevelop.es).

== More Info ==

For more details and examples of application using PostGIS Raster:

   * Search for "WKT Raster" in the [http://postgis.refractions.net/pipermail/postgis-users/ PostGIS mailing list archive] or in [http://www.nabble.com/forum/Search.jtp?forum=1221&local=y&query=%22wkt+raster%22 Nabble]

   * PostGIS Raster has been designed following a thorough analysis of the numerous discussions about raster integration in PostGIS over the recent years. You can find most of the post to the PostGIS-users group related to raster integration [http://trac.osgeo.org/postgis/wiki/UsersWikiRasterNotes in this page].

   * Write to [http://www.cef-cfr.ca/index.php?n=Membres.PierreRacine Pierre Racine]

== Overview of Planned PostGIS Raster Features ==

'''PostGIS Raster...'''

'''...is as simple as PostGIS...'''
 * one table = one raster coverage (like a vector coverage)
 * one row = one tile or one raster object (like a vector coverage where one row = one geometry)
 * only one new type: RASTER (like the PostGIS GEOMETRY type)
 * each raster tile has a pixel size, a width and a height, a variable number of band, a pixel type per band and a nodata value per band. Everything essential to do base raster GIS operations. 

'''...is an extension of PostGIS to be installed separately'''
 * merge with PostGIS might occur in the future... 

'''...has an import/export mechanism similar to shp2pgsql'''
 * raster2pgsql and pgsql2raster utilities allowing import/export of a single raster or a batch of raster into a tiled coverage. 

'''...allows easy conversion from/to geometry/raster...'''
 * ST_DumpToPolygons(raster) -> geometry set
 * ST_AsRaster(geometry, pixelsize) -> raster 

'''...implements base GIS raster operations available in most GIS...'''
 * ST_Resample(raster, pixelsize, method) -> raster
 * ST_Clip(raster|geometry,geometry) -> same type as first argument
 * ST_Reclass(raster|geometry,string) -> same type as first argument
 * ST_MapAlgebra(raster|geometry, raster), mathematical expression, "raster"|"geometry") -> raster/geometry
 * etc...) 

'''...introduces raster/geometry seamless geometry constructors...'''
 * so you don't have to bother whether the layers are in raster or vector form when using analysis functions.
 * ST_Intersection(raster|geometry, raster|geometry, "raster"|"geometry") -> raster/geometry
 * ST_Union(raster|geometry, raster|geometry, "raster"|"geometry") -> raster/geometry
 * ST_Accum(raster set|geometry set, "raster"|"geometry") -> raster/geometry
 * ST_Transform(raster|geometry, SRID) -> same type as input
 * etc... 

'''...and seamless geometry operators...'''
 * ST_Intersects(raster|geometry, raster|geometry) -> boolean
 * ST_Contains(raster|geometry A, raster|geometry B) -> boolean
 * etc... 

'''...allows raster storage INSIDE the database (as WKB)...'''
 * for efficient overlay analysis operations between vector and raster layers... 

'''...or OUTSIDE the database (as JPEG or TIFF)...'''
 * so desktop and web applications can quickly access and load raster tiles and nevertheless benefits from the powerful PostGIS GiST spatial index. Every PostGIS Raster SQL functions working with in-db raster tiles work seamlessly with out-db raster tiles. 

'''...introduces the concept of raster objects...'''
  * geographic features are stored as variable size raster tiles instead of polygons.
  * allows vector to raster conversion without lost of information. 

'''...is much more simple than PGRaster and Oracle !GeoRaster! PostGIS Raster supports...'''
  * only one type (instead of two in Oracle Spatial: SDO_GEORASTER & SDO_RASTER). In PostGIS Raster there are no differences between rasters and tiles: a tile is a raster and a raster is a tile. i.e. one row = one tile = one raster; one table = one raster coverage.
  * no metadata (like PostGIS)
  * no masks (you can create a mask as a band)
  * no multiple dimensions (only two: x, y). Not to be confused with bands; PostGIS Raster DO supports multiband raster...
  * no pyramids (reduced resolution coverages can be stored as a separate layer)

== What do people think about PostGIS Raster? ==

[http://www.cleverelephant.ca/cv.html Paul Ramsey] (founder of PostGIS):
 ''This proposal is better than any I have seen, addresses solving problems that if solved will provide actual new functionality and benefit to users, and clearly you've thought this through over some time''

[http://www.paragoncorporation.com/Team.aspx Regina Obe] (coauthor of [http://www.manning.com/obe/ PostGIS in Action]):
 ''The functions PostGIS WKT Raster proposes look pretty cool actually and my vision of the benefits of storing raster in the database are covered in it''

= Open Tickets =

[[TicketQuery(status=new|assigned|reopened&component~=wktraster&order=priority)]]