Changes between Version 162 and Version 163 of WKTRaster/SpecificationWorking03

Timestamp:

10/28/11 08:45:44 (13 years ago)

Author:

pracine

Comment:

—

WKTRaster/SpecificationWorking03

@@ -411 +411 @@
 '''ST_BurnToRaster(rast, geometry[, value, expression, nodata1expr, nodata2expr, nodatanodataexpr]) -> raster'''
 
- * Burn a raster to the band of an existing raster.
+ * Burn a geometry in the band of an existing raster.
  
  * No geoferencing metadata have to be provided since the ones of the provided raster are used.
 
- * This function is mostly different from the ST_AsRaster(geometry) by the fact that it must provide some options to take into account the existing pixel values when burning the new value associated with the geometry.
+ * This function is mainly different from the ST_AsRaster(geometry) by the fact that it must provide some options to take into account the existing pixel values when burning the new value associated with the geometry.
+
+ * This function could also be called ST_SetValues(). However does not just "set" values. It set them in a more flexible way possibly taking existing values into account. This is why "Burn" might be a better name. Very open to other name propositions...
 
  * It should be implemented as some wrappers around ST_MapAlgebra(raster, band, ST_AsRaster(geometry, val, raster, "CROP"), 'expression', 'nodata1expr', 'nodata2expr', 'nodatanodataexpr').