Changes between Version 109 and Version 110 of WKTRaster/SpecificationWorking01

Timestamp:

Feb 3, 2010, 8:01:31 AM (14 years ago)

Author:

pracine

Comment:

—

WKTRaster/SpecificationWorking01

@@ -278 +278 @@
 [[Image(WKTRasterAsPolygon.gif)]]
 
-'''ST_AsWKTPolygon(raster, band) -> wktgeomval set''' - Returns a set of "geomval" value, one for each group of pixel sharing the same value for the provided band.
+'''ST_AsWKTPolygon(raster, integer) -> wktgeomval set''' - Returns a set of "geomval" value, one for each group of pixel sharing the same value for the provided band.
 
  This is a set-returning function (SRF). A "wktgeomval " value is a complex type composed of a the wkt representation of a geometry (one for each group of pixel sharing the same value) and the value associated with this geometry. These values are always returned as a value of type double precision. The shape of each polygon follow pixels edges.
@@ -295 +295 @@
 '''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
+ 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
@@ -327 +327 @@
  It might be faster to skip test 2) if this test is not signicantly faster than test 3).
 
-'''ST_Intersection(raster, integer, geometry) -> geometry''' - Returns a set of "geomval" value representing the shared portion of the geometry and the raster areas sharing a common meaningfull values. 
+'''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[[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 2: 
 
-  ST_Intersection(raster, integer, geometry, 'raster') -> raster[[BR]]
+  ST_Intersection(raster, integer, geometry, 'raster') -> raster -- the integer parameter is the band number of the raster[[BR]] 
   ST_Intersection(raster, geometry, 'raster') -> raster -- default to band # 1
 
  Variant 3: 
 
-  ST_Intersection(geometry, raster, integer, 'raster') -> raster[[BR]]
+  ST_Intersection(geometry, raster, integer, 'raster') -> raster -- the integer parameter is the band number of the raster[[BR]]
   ST_Intersection(geometry, raster, 'raster') -> raster -- default to band # 1
 
  Variant 4: 
 
-  ST_Intersection(raster, integer, raster, integer) -> raster[[BR]]
-  ST_Intersection(raster, raster) -> raster -- default to band # 1
+  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
+  ST_Intersection(raster, integer, raster) -> raster -- default second raster to band # 1
+  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, 'geometry') -> geometry -- default to band # 1
+  ST_Intersection(raster, raster, integer, 'geometry') -> geometry -- default first raster to band # 1
+  ST_Intersection(raster, integer, raster, 'geometry') -> geometry -- default second raster to band # 1
+  ST_Intersection(raster, raster, 'geometry') -> geometry -- default both raster 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_AsPolygon(raster) and ST_Intersection(geometry, geometry) is then performed between the provided geometry and all the geometries resulting from the polygonisation of the raster.
@@ -384 +388 @@
 == '''Objective 0.1.6f - Being able to return a JPEG, a TIFF or a PNG.''' ==
  
-'''ST_bytea(raster, band) -> raster'''[[BR]]
+'''ST_bytea(raster, integer) -> raster''' -- the integer parameters is the band number of the raster.[[BR]]
 What is does?
 
@@ -406 +410 @@
 ----
 
-'''ST_Band(raster, band) -> raster'''[[BR]]
+'''ST_Band(raster, integer) -> raster''' -- the integer parameters are the band number of the rasters.[[BR]]
 Return a single band from a multiband raster. If "band" is greater than the value returned by ST_GetNumBands(), the function returns the last band. This function should be used to select a band before converting it to JPEG, TIFF, PNG, SVG or KML with the corresponding function. e.g. '''ST_AsTIFF(ST_Band(raster, band))