| 1 | PostGIS WKT Raster - Seamless operations between vector and raster layers |
|---|
| 2 | ------------------------------------------------------------------------- |
|---|
| 3 | http://www.postgis.org/support/wiki/index.php?WKTRasterHomePage |
|---|
| 4 | |
|---|
| 5 | |
|---|
| 6 | WKT Raster's goal is to implement the RASTER type as much as possible |
|---|
| 7 | like the GEOMETRY type is implemented in PostGIS and to offer a single |
|---|
| 8 | set of overlay SQL functions (like ST_Intersects) operating seamlessly |
|---|
| 9 | on vector and raster coverages. |
|---|
| 10 | |
|---|
| 11 | rt_core/ contains the primitives to deal with rasters in memory, |
|---|
| 12 | the function to serialize/deserialize both in-memory and on-disk |
|---|
| 13 | rasters, the functions to parse and output (hex)wkb. |
|---|
| 14 | You can see rt_core/testapi.c and rt_core/testwkb.c for example usage. |
|---|
| 15 | |
|---|
| 16 | rt_pg/ contains postgresql-specific wrappers, and SQL code to define |
|---|
| 17 | the RASTER type. |
|---|
| 18 | |
|---|
| 19 | doc/ contains technical references and RFC documents. |
|---|
| 20 | |
|---|
| 21 | REQUIREMENTS |
|---|
| 22 | ------------ |
|---|
| 23 | |
|---|
| 24 | WKTRaster core lib depends on liblwgeom, as found in postgis |
|---|
| 25 | source package as of SVN 2009-01 (latest 1.3.5 release won't work). |
|---|
| 26 | |
|---|
| 27 | PostgreSQL interface depends on PostgreSQL version 8.3.5. |
|---|
| 28 | |
|---|
| 29 | BUILD |
|---|
| 30 | ----- |
|---|
| 31 | |
|---|
| 32 | To build: |
|---|
| 33 | |
|---|
| 34 | $ ./configure --with-postgis-sources=/usr/src/postgis-svn |
|---|
| 35 | $ make |
|---|
| 36 | |
|---|
| 37 | Note that the 'configure' script isn't there if you fetched |
|---|
| 38 | the code from the SVN repository. In that case running ./autogen.sh |
|---|
| 39 | should create it for you. |
|---|
| 40 | |
|---|
| 41 | Under MinGW you might have to add "--with-pgconfig=/usr/local/pgsql/bin/pg_config" if |
|---|
| 42 | configure can't find your pgsql path. |
|---|
| 43 | |
|---|
| 44 | |
|---|
| 45 | PRE-INSTALL TEST |
|---|
| 46 | ---------------- |
|---|
| 47 | |
|---|
| 48 | After a successful build, you can run: |
|---|
| 49 | |
|---|
| 50 | $ make check |
|---|
| 51 | |
|---|
| 52 | It won't test postgresql interface, as that would require more setup |
|---|
| 53 | then a simple make check. See POST-INSTALL TESTING for more info on how |
|---|
| 54 | to test that part. |
|---|
| 55 | |
|---|
| 56 | INSTALL |
|---|
| 57 | ------- |
|---|
| 58 | |
|---|
| 59 | You need to install the library to the postgresql library |
|---|
| 60 | directory. You do it by running: |
|---|
| 61 | |
|---|
| 62 | $ sudo make install |
|---|
| 63 | |
|---|
| 64 | POST-INSTALL TEST |
|---|
| 65 | ----------------- |
|---|
| 66 | |
|---|
| 67 | You can run the post install tests against it: |
|---|
| 68 | |
|---|
| 69 | $ make post-install-check |
|---|
| 70 | |
|---|
| 71 | USE |
|---|
| 72 | --- |
|---|
| 73 | |
|---|
| 74 | In order to enable your databases to use the wktraster |
|---|
| 75 | functionalities you have to feed them the enabler script: |
|---|
| 76 | |
|---|
| 77 | $ psql -f rt_pg/rtpostgis.sql $MYDB |
|---|
| 78 | |
|---|
| 79 | Note that you must have loaded PostGIS in the database |
|---|
| 80 | in order for that to work (see postgis documentation |
|---|
| 81 | for how to do that). |
|---|
