[SEDONA-292] Bridge Sedona Raster and Map Algebra operators

[jiayuasu]

Did you read the Contributor Guide?

• Yes, I have read Contributor Rules and Contributor Development Guide

Is this PR related to a JIRA ticket?

• Yes, the URL of the associated JIRA ticket is https://issues.apache.org/jira/browse/SEDONA-292. The PR name follows the format [SEDONA-292] my subject.

What changes were proposed in this PR?

New functions

1. Add RS_MakeEmptyRaster (mainly for test purposes): equivalent to the same function in PosGIS
2. Add RS_MetaData: equivalent to the same function in PosGIS
3. Add RS_BandAsArray: extract a band from a raster as an array of double
4. Add RS_AddBandFromArray: add an array of double into a raster as a band (replace or append)

Deprecate old functions

Deprecate the following operators

1. geotiff data source for reading and writing geotiffs to arrays of double. We should use binaryFile data source for reading and raster data source for writing
2. RS_Append. Now each array of double in the map algebra world must be a single band. RS_Append unfortunately stacks two bands together.

Refactor

Refactor the code structure to the following categories according to PostGIS definition (https://postgis.net/docs/RT_reference.html):

• Raster constructors
• Raster editors
• Raster accessors
• Raster outputs
• Pixel functions
• Map algebra

How was this patch tested?

Add new test cases

Did this PR include necessary documentation updates?

• Yes, I am adding a new API. I am using the current SNAPSHOT version number in since vX.Y.Z format.

[jiayuasu]

@umartin Hi Martin, any comments or suggestion on this?

[umartin]

@umartin Hi Martin, any comments or suggestion on this?

Sorry for being a little late to the party. I've been swamped by my day job. Looks very clean to me. Nice to see raster support getting a real boost!