james-willis commented on code in PR #3114:
URL: https://github.com/apache/sedona/pull/3114#discussion_r3616842806


##########
docs/api/sql/Raster-Operators/RS_AsRaster.md:
##########
@@ -26,7 +26,7 @@ Introduction: `RS_AsRaster` converts a vector geometry into a 
raster dataset by
 * `pixelType`: Defines data type of the output raster. This can be one of the 
following, D (double), F (float), I (integer), S (short), US (unsigned short) 
or B (byte).
 * `allTouched` (Since: `v1.7.1`): Decides the pixel selection criteria. If set 
to `true`, the function selects all pixels touched by the geometry, else, 
selects only pixels whose centroids intersect the geometry. Defaults to `false`.
 * `value`: The value to be used for assigning pixels covered by the geometry. 
Defaults to using `1.0` if not provided.
-* `noDataValue`: Used for assigning the no data value of the resultant raster. 
Defaults to `null` if not provided.
+* `noDataValue`: Used for assigning the no data value of the resultant raster; 
pixels not covered by the geometry are set to this value. Defaults to `null` if 
not provided, in which case uncovered pixels are `0` and the raster has no no 
data value.

Review Comment:
   I'm not sure what the project's position on matching behavior should be.
   
   I guess my opinion (without regard to prior art) is that the default should 
be the NDV of `ref` and if `ref` has no NDV we should error or return null. But 
of course this is a breaking change.
   
   The current behavior of setting the pixel to 0 but not setting the NDV to 
match is not great. But maybe it is the least bad solution.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to