From: Paul Ramsey Date: Mon, 19 Mar 2012 20:40:51 +0000 (+0000) Subject: README.raster needs updating or removal (#1649) X-Git-Tag: 2.0.0beta4~4 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d0b5ff1eeb792b7c8b461344a977b69c84a69e77;p=postgis README.raster needs updating or removal (#1649) git-svn-id: http://svn.osgeo.org/postgis/trunk@9517 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/README.postgis b/README.postgis index a36227ea5..48bb0d14f 100644 --- a/README.postgis +++ b/README.postgis @@ -80,12 +80,9 @@ this to work. * GDAL (Optional, Version 1.6.0 or higher) - GDAL is required if you want to compile PostGIS with raster support. - - http://www.gdal.org/ - -See README.raster for further information on how to compile PostGIS with -Raster support. + GDAL (http://gdal.org) is *required* if you want to compile PostGIS + with raster support. To compile without raster support you + must ``./configure --without-raster`` CONFIGURATION @@ -110,6 +107,10 @@ If GEOS has been installed but cannot be found, configure will complain and refuse to proceed. You can specify an alternative ``geos-config`` file using the ``--with-geosconfig=/path/to/geos-config`` option. +If GDAL cannot be found, configure will complain and refuse to proceed. +You can either procede without raster support using ``--without-raster`` +or use ``--with-gdalconfig=/path/to/gdal-config`` option. + By default, both Topology and Raster extensions are enabled in ``./configure``. If you want to compile PostGIS *without* Raster support, you must provide the @@ -129,8 +130,6 @@ and utilities, as postgres run:: make -See README.raster to know how to build PostGIS Raster extension. - TESTING ------- @@ -146,8 +145,6 @@ Final lines of output contain a summary of test results: run, succeeded, failed. If you have any failure please file a bug report using the online bug tracker: http://trac.osgeo.org/postgis/report/3 -See README.raster to know how to test PostGIS raster extension. - INSTALLATION ------------ @@ -168,8 +165,6 @@ Where `[prefix]` above is extracted from ``pg_config --configure``. You can change them using ``./configure`` switches. See CONFIGURATION section. -See README.raster to know how to install PostGIS Raster extension. - CREATING NEW SPATIAL DATABASES ------------------------------ @@ -193,6 +188,15 @@ So, as postgres run:: Your database should now be spatially enabled. +ADDING RASTER SUPPORT TO A SPATIAL DATABASE +------------------------------------------- + +To enable raster support you must first load the ``postgis.sql`` file. +You can then load the ``rtpostgis.sql`` file. + + psql -f postgis/rtpostgis.sql -d + + UPGRADING EXISTING SPATIAL DATABASES ------------------------------------ @@ -244,7 +248,7 @@ For this purpose, PostGIS provides a utility script to restore a dump in # [3] Restore the dump into your new database. $ perl utils/postgis_restore.pl -v olddb.dump \ - 2> restore.log | psql newdb 2> errors.txt + 2> restore.log | psql newdb 2> errors.log The ``spatial_ref_sys`` entries found in your dump will be restored, but they will not override existing ones in ``spatial_ref_sys``. This is to ensure that @@ -303,9 +307,9 @@ with an SRID:: SELECT AddGeometryColumn('db', 'geotest', 'geopoint', 1, 'POINT', 2); INSERT INTO geotest (id, name, geopoint) - VALUES (1, 'Olympia', GeometryFromText('POINT(-122.90 46.97)', 1)); + VALUES (1, 'Olympia', ST_GeomFromText('POINT(-122.90 46.97)', 1)); INSERT INTO geotest (id, name, geopoint) - VALUES (2, 'Renton', GeometryFromText('POINT(-122.22 47.50)', 1)); + VALUES (2, 'Renton', ST_GeomFromText('POINT(-122.22 47.50)', 1)); SELECT name, AsText(geopoint) FROM geotest; @@ -329,11 +333,6 @@ Always run the ``VACUUM ANALYZE `` on your tables after creating an index. This gathers statistics which the query planner uses to optimize index usage. -PostGIS Raster support -~~~~~~~~~~~~~~~~~~~~~~ - -See README.raster to know how to enable raster support on a spatially enabled -database. PostGIS Topology support ~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/README.raster b/README.raster deleted file mode 100644 index 3cb8b1581..000000000 --- a/README.raster +++ /dev/null @@ -1,89 +0,0 @@ -PostGIS WKT Raster - Seamless operations between vector and raster layers -------------------------------------------------------------------------- -http://www.postgis.org/support/wiki/index.php?WKTRasterHomePage - - -PostGIS Raster's goal 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. - -raster/rt_core/ contains the primitives to deal with rasters in memory, -the function to serialize/deserialize both in-memory and on-disk -rasters, the functions to parse and output (hex)wkb. -You can see raster/rt_core/testapi.c and raster/rt_core/testwkb.c for -example usage. - -raster/rt_pg/ contains postgresql-specific wrappers, and SQL code to define -the RASTER type. - -raster/doc/ contains technical references and RFC documents. - -REQUIREMENTS ------------- - -PostGIS Raster core lib depends on liblwgeom, as found in postgis -source package as of SVN 2009-01 (latest 1.3.5 release won't work). - -Some PostGIS Raster functions depends on GDAL library version 1.6.0 or -higher - -PostGIS Raster loader dependes on Python GDAL bindings. - -PostgreSQL interface depends on PostgreSQL version 8.3.5. - - -BUILD ------ - -To build PostGIS with raster support: - - $ ./configure --with-raster - $ make - -Note that the 'configure' script isn't there if you fetched -the code from the SVN repository. In that case running ./autogen.sh -should create it for you. - -Under MinGW you might have to add "--with-pgconfig=/usr/local/pgsql/bin/pg_config" if -configure can't find your pgsql path. - - -PRE-INSTALL TEST ----------------- - -After a successful build, you can run: - - $ make raster-check - -It won't test postgresql interface, as that would require more setup -then a simple make check. See POST-INSTALL TESTING for more info on how -to test that part. - -INSTALL -------- - -You need to install the library to the postgresql library -directory. You do it by running: - - $ sudo make install - -POST-INSTALL TEST ------------------ - -You can run the post install tests against it: - - $ make raster-post-install-check - -USE ---- - -In order to enable your databases to use the raster -functionalities you have to feed them the enabler script: - - $ psql -f raster/rt_pg/rtpostgis.sql $MYDB - -Note that you must have loaded PostGIS in the database -in order for that to work (see PostGIS documentation -for how to do that). -