From: Regina Obe Date: Mon, 19 Dec 2011 01:59:16 +0000 (+0000) Subject: update faq for raster to bring it more up to line with new loading , QGIS support... X-Git-Tag: 2.0.0alpha1~416 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=2d53f857265c1a8da1d01512b54f6bd157c1cb29;p=postgis update faq for raster to bring it more up to line with new loading , QGIS support etc., remove box2d and replace with box3d, minor rewording -- people who don't know GDAL don't know what a GDAL raster is. Took that word out when describing -G since it confuses rather than adding value. git-svn-id: http://svn.osgeo.org/postgis/trunk@8458 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/faq_raster.xml b/doc/faq_raster.xml index 15174b9cb..231724d5d 100644 --- a/doc/faq_raster.xml +++ b/doc/faq_raster.xml @@ -39,7 +39,7 @@ The easiest is to download binaries for PostGIS and Raster which are currently available for windows and latest versions of Mac OSX. - First you need a working PostGIS 1.3.5 or above and be running PostgreSQL 8.3, 8.4, or 9.0. Note in PostGIS 2.0 PostGIS Raster is fully integrated, so it will be compiled when you compile PostGIS. + First you need a working PostGIS 2.0.0 or above and be running PostgreSQL 8.4, 9.0, or 9.1. Note in PostGIS 2.0 PostGIS Raster is fully integrated, so it will be compiled when you compile PostGIS. Instructions for installing and running under windows are available at How to Install and Configure PostGIS raster on windows If you are on windows, you can compile yourself, or use the . If you are on Mac OSX Leopard or Snow Leopard, there are binaries available at Kyng Chaos Mac OSX PostgreSQL/GIS binaries. - Then to enable raster support in your database, run the rtpostgis.sql file in your database. + Then to enable raster support in your database, run the rtpostgis.sql file in your database. To upgrade an existing install use rtpostgis_upgrade_minor..sql instead of rtpostgis.sql For other platforms, you generally need to compile yourself. Dependencies are PostGIS and GDAL. For more details about compiling from source, please refer to Installing PostGIS Raster from source (in prior versions of PostGIS) @@ -59,7 +59,7 @@ - rtpostgis.so/dll is built with dependency on libgdal.dll/so. Make sure for Windows you have libgdal.dll in the bin folder of your PostgreSQL install. + rtpostgis.so/dll is built with dependency on libgdal.dll/so. Make sure for Windows you have libgdal-1.dll in the bin folder of your PostgreSQL install. For Linux libgdal has to be in your path or bin folder. You may also run into different errors if you don't have PostGIS installed in your database. Make sure to install PostGIS first in your database before trying to install the raster support. @@ -72,16 +72,7 @@ - Currently you need GDAL 1.6+ though later versions would be better since they have many memory leak fixes, Python 2.5 with GDAL 1.6 or higher bindings, - and NumPy. - - For windows users, installing these components from binary sources is documented in the - ReadMe.txt packaged with the Windows - PostGIS Raster experimental builds. - Once you have a functioning Python with GDAL and NumPy, you can - use the raster2pgsql.py script packaged with PostGIS Raster. - Please refer to raster2pgsql.py usage and for more details. + The latest version of PostGIS comes packaged with a raster2pgsql raster loader executable capable of loading many kinds of rasters and also generating lower resolution overviews without any additional software. Please refer to for more details. Pre-2.0 versions came with a raster2pgsql.py that required python with numpy and GDAL. This is no longer needed. @@ -93,7 +84,7 @@ Any that your GDAL library supports. GDAL supported formats are documented GDAL File Formats. Your particular GDAL install may not support all formats. To verify the ones supported by your particular GDAL install, you can use - gdalinfo --formats + raster2pgsql -G @@ -138,7 +129,7 @@ Are their binaries of GDAL available already compiled with PostGIS Raster suppport? - Yes. Check out the page GDAL Binaries page. Any compiled wiht PostgreSQL + Yes. Check out the page GDAL Binaries page. Any compiled with PostgreSQL support should have PostGIS Raster in them. We know for sure the following windows binaries have PostGIS Raster built in. FWTools latest stable version for Windows is compiled with Raster support. @@ -155,8 +146,9 @@ - You can use MapServer compiled with GDAL 1.7+ and PostGIS Raster driver support to view Raster data. - In theory any tool that renders data using GDAL can support PostGIS raster data or + You can use MapServer compiled with GDAL 1.7+ and PostGIS Raster driver support to view Raster data. QuantumGIS (QGIS) now supports viewing of PostGIS Raster if you + have PostGIS raster driver installed. + In theory any tool that renders data using GDAL can support PostGIS raster data or support it with fairly minimal effort. Again for Windows, Tamas' binaries http://vbkto.dyndns.org/sdk/ are a good choice if you don't want the hassle of having to setup to compile your own. diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml index 8600dcae6..aace33743 100644 --- a/doc/reference_raster.xml +++ b/doc/reference_raster.xml @@ -4784,16 +4784,16 @@ FROM dummy_rast WHERE rid=2; Raster Processing - + - Box2D - Returns the box 2d representation of the enclosing box of the raster + Box3D + Returns the box 3d representation of the enclosing box of the raster - box2d Box2D + box3d Box2D raster rast @@ -4806,18 +4806,20 @@ FROM dummy_rast WHERE rid=2; The polygon is defined by the corner points of the bounding box ((MINX, MINY), (MAXX, MAXY)) + + Changed: 2.0.0 In pre-2.0 versions, there used to be a box2d instead of box3d. Since box2d is a deprecated type, this was changed to box3d. Examples - SELECT rid, Box2D(rast) As rastbox + SELECT rid, Box3D(rast) As rastbox FROM dummy_rast; rid | rastbox ----+------------------------------------------------- -1 | BOX(0.5 0.5,20.5 60.5) -2 | BOX(3427927.75 5793243.5,3427928 5793244) +1 | BOX3D(0.5 0.5 0,20.5 60.5 0) +2 | BOX3D(3427927.75 5793243.5 0,3427928 5793244 0) diff --git a/doc/using_raster_dataman.xml b/doc/using_raster_dataman.xml index 157030098..ef3a41a50 100644 --- a/doc/using_raster_dataman.xml +++ b/doc/using_raster_dataman.xml @@ -14,7 +14,7 @@ by the executable will be the same as those compiled in the GDAL dependency library. To get a list of raster types your particular raster2pgsql supports use the -G switch. These should be the same as those provided by your PostGIS install documented here if you are using the same gdal library for both. The older version of this tool was a python script. The executable has replaced the python script. If you still find the need for the Python script - Examples of the pyhton one can be found at GDAL PostGIS Raster Driver Usage + Examples of the pyhton one can be found at GDAL PostGIS Raster Driver Usage. Pease note that the raster2pgsql python script may not work with future versions of PostGIS raster and is no longer supported. EXAMPLE USAGE: @@ -34,7 +34,7 @@ -G - Print the supported GDAL raster formats. + Print the supported raster formats.