Changes between Version 36 and Version 37 of WKTRaster/SpecificationFinal01

Timestamp:

Aug 27, 2010, 2:17:35 PM (14 years ago)

Author:

pracine

Comment:

—

WKTRaster/SpecificationFinal01

@@ -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.
 
- Variant 1: ST_DumpAsPolygons(raster) -> geomval set -- default to band # 1
+ '''Variants'''
+
+  1) ST_DumpAsPolygons(raster, integer) -> geomval set
+
+  2) ST_DumpAsPolygons(raster) -> geomval set -- default to band # 1
 
  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). 
 
- Variant 1: ST_Intersects(geometry, raster, integer) -> boolean -- the third parameter is the raster band number
-
- Variant 2: ST_Intersects(geometry, raster) -> boolean -- default to band # 1
- 
- Variant 3: ST_Intersects(raster, geometry) -> boolean -- default to band # 1
+ '''Variants'''
+
+ 1) ST_Intersects(geometry, raster, integer) -> boolean -- the third parameter is the raster band number
+
+ 2) ST_Intersects(geometry, raster) -> boolean -- default to band # 1
+ 
+ 3) ST_Intersects(raster, geometry) -> boolean -- default to band # 1
 
  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.
 
- Variant 1: 
-
-  ST_Intersection(raster, geometry) -> geometry -- default to band # 1[[BR]]
-  ST_Intersection(geometry, raster, integer) -> geometry -- the integer parameter is the band number of the raster[[BR]]
-  ST_Intersection(geometry, raster) -> geometry -- default to band # 1
-
-
- Variant 4: 
-
-  ST_Intersection(raster, integer, raster, integer) -> raster -- the integer parameters are the band number of the rasters[[BR]]
-  ST_Intersection(raster, raster, integer) -> raster -- default first raster to band # 1[[BR]]
-  ST_Intersection(raster, integer, raster) -> raster -- default second raster to band # 1[[BR]]
-  ST_Intersection(raster, raster) -> raster -- default both rasters to band # 1
-
- Variant 5: 
-
-  ST_Intersection(raster, integer, raster, integer, 'geometry') -> geometry[[BR]]
-  ST_Intersection(raster, raster, integer, 'geometry') -> geometry -- default first raster to band # 1[[BR]]
-  ST_Intersection(raster, integer, raster, 'geometry') -> geometry -- default second raster to band # 1[[BR]]
-  ST_Intersection(raster, raster, 'geometry') -> geometry -- default both raster to band # 1
+ Variants: 
+
+  1) ST_Intersection(raster, geometry) -> geometry -- default to band # 1[[BR]]
+  2) ST_Intersection(geometry, raster, integer) -> geometry -- the integer parameter is the band number of the raster[[BR]]
+  3) ST_Intersection(geometry, raster) -> geometry -- default to band # 1
+
 
  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.