From f08c2bac715d38fd189dc6e621de1bb65297ce9f Mon Sep 17 00:00:00 2001 From: Regina Obe Date: Fri, 11 Feb 2011 22:06:50 +0000 Subject: [PATCH] remove new section to see if that fixes build git-svn-id: http://svn.osgeo.org/postgis/trunk@6802 b70326c6-7e19-0410-871a-916f4a2858ee --- doc/reference_raster.xml | 267 +-------------------------------------- 1 file changed, 2 insertions(+), 265 deletions(-) diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml index 2c2376fe2..b35e0d7d3 100644 --- a/doc/reference_raster.xml +++ b/doc/reference_raster.xml @@ -8,270 +8,7 @@ user. raster is a new PostGIS type for storing and analyzing raster data. For more information about Raster, please refer to PostGIS Raster Home Page. - - Loading and Creating Rasters - For most use cases, you will create PostGIS rasters by loading existing raster files using the packaged raster2pgsql raster loader. - - Using the raster2pgsql Raster Loader - - The raster2pgsql.py is a raster loader python script that utilizes Python, PyGDAL, and NumPy to convert any GDAL supported raster format into sql suitable for loading into a PostGIS raster table. - It is capable of loading folders of raster files as well as creating overviews of rasters. - - - - - --help, -h - - - Display help screen. - - - - - - (c|a|d) These are mutually exclusive options: - - - - - -c - - - Create new table and populate it with raster(s), this is the default mode - - - - - - -a - - - Append raster(s) to an existing table. - - - - - - -d - - - Drop table, create new one and populate it with raster(s) - - - - - - - - - - -o OUTPUT, --output=OUTPUT - Specify output file, otherwise send to stdout. - - - - --version - - - Shows program version - - - - - - Mandatory paramters: - - - - - -r RASTER, --raster=RASTER - - - Append raster to list of input files, at least one raster file required. You may use wildcards (?,*) for specifying multiple files. - - - - - - -t TABLE, --table=TABLE - - - Raster destination in form of [<schema>.]<table> or base raster table for overview level>1, required - - - - - - - - - - - Raster processing: Optional parameters used to manipulate input raster dataset - - - - - -s <SRID> - - - Assign output raster with specified SRID. - - - - - - -b BAND, --band=BAND - - - Specify number of band to be extracted from raster. If not specified all bands are added. - - - - - - -k BLOCK_SIZE, --block-size=BLOCK_SIZE - - Cut raster(s) into tiles to be inserted one by table row.BLOCK_SIZE is expressed as WIDTHxHEIGHT. Incomplete tiles are completed with nodata values. - Each tile is stored as a separate record in the raster table. If no block size is specified, then each raster file is brought in as an individual record. - - - - - -R, --register - - Register the raster as a filesystem (out-db) raster. - Only the metadata of the raster and path location to the raster is stored in the database (not the pixels). - - - - - -l OVERVIEW_LEVEL, --overview-level=OVERVIEW_LEVEL - create overview tables named as - o_<LEVEL>_<RASTER_TABLE> and populate with GDAL-provided overviews (regular blocking only) - - - - - - - - - Optional parameters used to manipulate database objects - - - - - -f COLUMN, --field=COLUMN - - Specify name of destination raster column, default is 'rast' - - - - - - -F, --filename - - Add a column with the name of the file - - - - - -I - - - Create a GiST index on the raster column. - - - - - - -M, --vacuum - - - Vacuum analyze the raster table. - - - - - - -V, --create-raster-overviews - - Create RASTER_OVERVIEWS table used to store overviews metadata. - - - - - - - - - -e ENDIAN, --endian=ENDIAN - Control endianness of generated binary output of raster; specify 0 for XDR and 1 for NDR (default); only NDR output is supported now - - - - -v, --verbose - Specify output file, otherwise send to stdout verbose mode. Useful for debugging - - - - - - - An example session using the loader to create an input file and uploading it might look like - this: - - - python raster2pgsql.py -s 4269 -I -r *.tif -F myschema.demelevation -o elev.sql - psql -d gisdb -f elev.sql - - - A conversion and upload can be done all in one step using UNIX pipes: - - - python raster2pgsql.py -s 4269 -I -r *.tif -F myschema.demelevation | psql -d gisdb - - - - For the examples in this reference we will be using a raster table of dummy rasters - Formed with the following code - -CREATE TABLE dummy_rast(rid integer, rast raster); -INSERT INTO dummy_rast(rid, rast) -VALUES (1, -('01' -- little endian (uint8 ndr) -|| -'0000' -- version (uint16 0) -|| -'0000' -- nBands (uint16 0) -|| -'0000000000000040' -- scaleX (float64 2) -|| -'0000000000000840' -- scaleY (float64 3) -|| -'000000000000E03F' -- ipX (float64 0.5) -|| -'000000000000E03F' -- ipY (float64 0.5) -|| -'0000000000000000' -- skewX (float64 0) -|| -'0000000000000000' -- skewY (float64 0) -|| -'00000000' -- SRID (int32 0) -|| -'0A00' -- width (uint16 10) -|| -'1400' -- height (uint16 20) -)::raster -), --- Raster: 5 x 5 pixels, 3 bands, PT_8BUI pixel type, NODATA = 0 -(2, ('01000003009A9999999999A93F9A9999999999A9BF000000E02B274A' || -'41000000007719564100000000000000000000000000000000FFFFFFFF050005000400FDFEFDFEFEFDFEFEFDF9FAFEF' || -'EFCF9FBFDFEFEFDFCFAFEFEFE04004E627AADD16076B4F9FE6370A9F5FE59637AB0E54F58617087040046566487A1506CA2E3FA5A6CAFFBFE4D566DA4CB3E454C5665')::raster); - - - - + Raster Management Functions @@ -3726,4 +3463,4 @@ WHERE A.rid =2 ; - + \ No newline at end of file -- 2.50.1