RS_MakeEmptyRaster

Returns an empty raster geometry. Every band in the raster is initialized to 0.0.

Signatures

RS_MakeEmptyRaster(numBands: Integer, bandDataType: String = 'D', width: Integer, height: Integer, upperleftX: Double, upperleftY: Double, cellSize: Double)

RS_MakeEmptyRaster(numBands: Integer, bandDataType: String = 'D', width: Integer, height: Integer, upperleftX: Double, upperleftY: Double, scaleX: Double, scaleY: Double, skewX: Double, skewY: Double, srid: Integer)

Parameters

Integer

required

The number of bands in the raster. If not specified, the raster will have a single band.

String

Optional parameter specifying the data types of all the bands in the created raster. Accepts one of:

"D" - 64 bits Double
"F" - 32 bits Float
"I" - 32 bits signed Integer
"S" - 16 bits signed Short
"US" - 16 bits unsigned Short
"B" - 8 bits unsigned Byte

Defaults to 'D'.

Integer

required

The width of the raster in pixels.

Integer

required

The height of the raster in pixels.

Double

required

The X coordinate of the upper left corner of the raster, in terms of the CRS units.

Double

required

The Y coordinate of the upper left corner of the raster, in terms of the CRS units.

Double

required

The size of the cells in the raster, in terms of the CRS units. Used with the first signature, which defaults to the Cartesian coordinate system.

Double

required

The scaling factor of the cells on the X axis.

Double

required

The scaling factor of the cells on the Y axis.

Double

required

The skew of the raster on the X axis, effectively tilting cells in the horizontal direction.

Double

required

The skew of the raster on the Y axis, effectively tilting cells in the vertical direction.

Integer

required

The SRID of the raster. Use 0 for the default Cartesian coordinate system. Use 4326 for WGS84.

For more information about ScaleX, ScaleY, SkewX, SkewY, please refer to the Affine Transformations section.

If any other value than the accepted values for the bandDataType is provided, RS_MakeEmptyRaster defaults to double as the data type for the raster.

Return type

The resulting raster.

Examples

With 2 bands

SELECT RS_MakeEmptyRaster(2, 10, 10, 0.0, 0.0, 1.0)

+--------------------------------------------+
|rs_makeemptyraster(2, 10, 10, 0.0, 0.0, 1.0)|
+--------------------------------------------+
|                        GridCoverage2D["g...|
+--------------------------------------------+

With 2 bands and dataType

SELECT RS_MakeEmptyRaster(2, 'I', 10, 10, 0.0, 0.0, 1.0) - Create a raster with integer datatype

+--------------------------------------------+
|rs_makeemptyraster(2, 10, 10, 0.0, 0.0, 1.0)|
+--------------------------------------------+
|                        GridCoverage2D["g...|
+--------------------------------------------+

With 2 bands, scale, skew, and SRID

SELECT RS_MakeEmptyRaster(2, 10, 10, 0.0, 0.0, 1.0, -1.0, 0.0, 0.0, 4326)

+------------------------------------------------------------------+
|rs_makeemptyraster(2, 10, 10, 0.0, 0.0, 1.0, -1.0, 0.0, 0.0, 4326)|
+------------------------------------------------------------------+
|                                              GridCoverage2D["g...|
+------------------------------------------------------------------+

With 2 bands, float dataType, scale, skew, and SRID

SELECT RS_MakeEmptyRaster(2, 'F', 10, 10, 0.0, 0.0, 1.0, -1.0, 0.0, 0.0, 4326) - Create a raster with float datatype

+------------------------------------------------------------------+
|rs_makeemptyraster(2, 10, 10, 0.0, 0.0, 1.0, -1.0, 0.0, 0.0, 4326)|
+------------------------------------------------------------------+
|                                              GridCoverage2D["g...|
+------------------------------------------------------------------+

Wherobots Cloud REST API

WherobotsDB

Vector tiles (PMTiles)

Havasu (Iceberg) table management

GeoStats and Map Matching

Rasterflow

RS_MakeEmptyRaster

Signatures

Parameters

Return type

Examples

With 2 bands

With 2 bands and dataType

With 2 bands, scale, skew, and SRID

With 2 bands, float dataType, scale, skew, and SRID

​Signatures

​Parameters

​Return type

​Examples

​With 2 bands

​With 2 bands and dataType

​With 2 bands, scale, skew, and SRID

​With 2 bands, float dataType, scale, skew, and SRID

Signatures

Parameters

Return type

Examples

With 2 bands

With 2 bands and dataType

With 2 bands, scale, skew, and SRID

With 2 bands, float dataType, scale, skew, and SRID