Changes between Version 36 and Version 37 of WKTRaster/SpecificationFinal01
- Timestamp:
- 08/27/10 14:17:35 (14 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WKTRaster/SpecificationFinal01
v36 v37 168 168 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. 169 169 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 171 175 172 176 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(). … … 208 212 '''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). 209 213 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 215 221 216 222 This function permform a full intersection test and proceed in three steps to determine if the raster intersects with the geometry: … … 238 244 '''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. 239 245 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 260 252 261 253 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.