Changes between Version 36 and Version 37 of WKTRaster/SpecificationFinal01


Ignore:
Timestamp:
08/27/10 14:17:35 (14 years ago)
Author:
pracine
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WKTRaster/SpecificationFinal01

    v36 v37  
    168168 This is a set-returning function (SRF). A "geomval" value is a complex type composed of a polygon geometry (one for each contiguous group of pixel sharing the same value) and the value associated with this geometry. These values are always returned as double precision number. The shape of each polygon follow pixels edges.
    169169
    170  Variant 1: ST_DumpAsPolygons(raster) -> geomval set -- default to band # 1
     170 '''Variants'''
     171
     172  1) ST_DumpAsPolygons(raster, integer) -> geomval set
     173
     174  2) ST_DumpAsPolygons(raster) -> geomval set -- default to band # 1
    171175
    172176 This function should be used with precaution on raster with float pixel type as it could return one "geomval" (or polygon) per pixel. This kind of raster should be reclassified (using the planned ST_Reclass(raster,...) function) before using ST_DumpAsPolygons().
     
    208212'''ST_Intersects(raster, integer, geometry) -> boolean''' - Returns TRUE if the geometry and the raster "spatially intersect" - (share any portion of space) and FALSE if they don't (they are disjoint).
    209213
    210  Variant 1: ST_Intersects(geometry, raster, integer) -> boolean -- the third parameter is the raster band number
    211 
    212  Variant 2: ST_Intersects(geometry, raster) -> boolean -- default to band # 1
    213  
    214  Variant 3: ST_Intersects(raster, geometry) -> boolean -- default to band # 1
     214 '''Variants'''
     215
     216 1) ST_Intersects(geometry, raster, integer) -> boolean -- the third parameter is the raster band number
     217
     218 2) ST_Intersects(geometry, raster) -> boolean -- default to band # 1
     219 
     220 3) ST_Intersects(raster, geometry) -> boolean -- default to band # 1
    215221
    216222 This function permform a full intersection test and proceed in three steps to determine if the raster intersects with the geometry:
     
    238244'''ST_Intersection(raster, integer, geometry) -> geometry''' - Returns a set of "geomval" value representing the shared portion of the geometry and the raster band areas sharing a common meaningfull values. The integer parameter is the band number of the raster.
    239245
    240  Variant 1:
    241 
    242   ST_Intersection(raster, geometry) -> geometry -- default to band # 1[[BR]]
    243   ST_Intersection(geometry, raster, integer) -> geometry -- the integer parameter is the band number of the raster[[BR]]
    244   ST_Intersection(geometry, raster) -> geometry -- default to band # 1
    245 
    246 
    247  Variant 4:
    248 
    249   ST_Intersection(raster, integer, raster, integer) -> raster -- the integer parameters are the band number of the rasters[[BR]]
    250   ST_Intersection(raster, raster, integer) -> raster -- default first raster to band # 1[[BR]]
    251   ST_Intersection(raster, integer, raster) -> raster -- default second raster to band # 1[[BR]]
    252   ST_Intersection(raster, raster) -> raster -- default both rasters to band # 1
    253 
    254  Variant 5:
    255 
    256   ST_Intersection(raster, integer, raster, integer, 'geometry') -> geometry[[BR]]
    257   ST_Intersection(raster, raster, integer, 'geometry') -> geometry -- default first raster to band # 1[[BR]]
    258   ST_Intersection(raster, integer, raster, 'geometry') -> geometry -- default second raster to band # 1[[BR]]
    259   ST_Intersection(raster, raster, 'geometry') -> geometry -- default both raster to band # 1
     246 Variants:
     247
     248  1) ST_Intersection(raster, geometry) -> geometry -- default to band # 1[[BR]]
     249  2) ST_Intersection(geometry, raster, integer) -> geometry -- the integer parameter is the band number of the raster[[BR]]
     250  3) ST_Intersection(geometry, raster) -> geometry -- default to band # 1
     251
    260252
    261253 This is a set-returning function (SRF). It returns a set of "geomval" representing the point set intersection of the geometry and the areas of the raster sharing a common meaningfull value (NODATA values ARE taken into account). The raster is first polygonised using ST_DumpAsPolygons(raster) and ST_Intersection(geometry, geometry) is then performed between the provided geometry and all the geometries resulting from the polygonisation of the raster.