栅格图像处理函数ST_Rescale_云数据库 RDS(RDS)-阿里云帮助中心

对源栅格对象进行像素缩放，对应的地理空间范围保持不变，返回缩放后的栅格对象。

语法

raster ST_Rescale(raster rast,
         f8 scale_x,
          f8 scale_y,
      cstring processexpr default '',
       cstring storageOption default '');

raster ST_Rescale(raster raster,
         f8 scale_xy,
      cstring processexpr default '',
       cstring storageOption default '')

参数

参数名称	描述
rast	需要投影变换的raster对象。
scale_x	x方向的缩放比例。
scale_y	y方向的缩放比例。
scale_xy	x、y方向的缩放比例，两者相同。
processExpr	JSON字符串，指定重采样的方式以及nodata处理方式。
storageOption	返回结果的存储选项，为JSON字符串。

processExpr为JSON字符串数组，每个子JSON对象指定参数如下。

参数名称	描述	类型	默认值	说明
resample	重采样方式。	text	'Near'	栅格重采样方式，支持'Near'、'Average'、'Cubic'和'Bilinear'四种。
nodata	源影像的nodata值是否有效。	bool	false	如果为true，表示源影像的nodata是有效的，像元值为nodata的像元不参与重采样计算。如果为false，表示源影像的nodata是无效的，像元值为nodata的像元参与重采样计算。
nodataValue	按波段指定新的nodata值。	float8 float8[]	NULL	nodataValue可指定为单个值或数组。如果指定为单个值，表示输出栅格对象的所有波段使用同一个nodata值。如果指定为数组，则数组元素个数必须与栅格的波段数一致。

说明

nodata与nodatavalue参数需谨慎使用，如果源栅格没有nodata，建议nodata设置为false，同时不需要指定nodatavalue，否则会出现结果影像失真的情况。

storageOption参数如下。

参数名称	描述	类型	默认值	说明
chunking	是否使用分块存储。	boolean	和原始raster一致	-
chunkdim	分块的维度信息。	string	和原始raster一致	在chunking=true时才有效。
chunktable	分块表名称。	string	''	如果传入''值，则会产生一个随机表名临时块表用于存放数据。该临时表只在当前会话中有效。如果需要保持一个可访问的裁剪对象，则需要指定块表名称。
compression	压缩算法类型。	string	和原始raster一致	目前只支持none、jpeg、zlib、png、lzo和lz4。
quality	压缩质量。	integer	和原始raster一致	只针对jpeg压缩算法。
interleaving	交错方式。	string	和原始raster一致	必须是以下一种： bip：Band interleaved by pixel bil：Band nterleaved by pixel bsq：Band Sequential
endian	字节序。	string	和原始raster一致	必须为以下其中之一： NDR：Little endian XDR：Big endian

说明

如果chunktable传入NULL或者''，则会在当前session中创建一个随机表名的临时表用于存放转换后的raster对象，该临时表只在当前会话中有效，会话结束临时表也随即删除。如果需要将转换的raster对象保存下来，则chunktable选项需要指定具体表名称。

示例

CREATE TABLE if not exists datasource_table(id integer, rast raster);
INSERT INTO datasource_table values(1, ST_ImportFrom('rbt','$(RAST_DATA_DIR)/512_512_1_bsq_8u_geo.tif', '{}'));
----------------------------------------------------
-- 方式一：指定chunkTable名称，将resize结果持续化存储
----------------------------------------------------
CREATE TABLE rat_rescale_result(id integer, rast raster);

--不指定nodata
INSERT INTO rat_rescale_result(id, rast) 
select 10, ST_Rescale(rast,1024,1024, '{"resample":"Near","nodata":false}','{"chunking":true,"chunkdim":"(256,256,1)","compression":"none","interleaving":"bsq","chunktable":"result_rbt"}') 
from datasource_table 
where id =1;

--指定单个nodatavalue,同时nodata像元参与计算
INSERT INTO rat_rescale_result(id, rast) 
select 11, ST_Rescale(rast,1024,1024, '{"resample":"Near","nodata":true,"nodatavalue":255}','{"chunking":true,"chunkdim":"(256,256,1)","compression":"none","interleaving":"bsq","chunktable":"result_rbt"}') 
from datasource_table 
where id =1;

--指定nodata数组
INSERT INTO rat_rescale_result(id, rast) 
select 12, ST_Rescale(rast,1024,1024, '{"resample":"Near","nodata":false,"nodatavalue":[255,255,255]}','{"chunking":true,"chunkdim":"(256,256,1)","compression":"none","interleaving":"bsq","chunktable":"result_rbt"}') 
from datasource_table 
where id =1;

----------------------------------------------------
-- 方式二：不指定chunktable名称，转换结果存放在随机表名的临时表中，仅可用于session内部的嵌套计算
----------------------------------------------------
CREATE TEMP TABLE rat_rescale_result_temp(id integer, rast raster);

INSERT INTO rat_rescale_result_temp(id, rast) 
select 1, ST_Rescale(rast,1024,1024,'{"resample":"Near","nodata":false, "nodataValue":[255,255,255]}','{"chunking":true,"chunkdim":"(256,256,1)","compression":"none","interleaving":"bsq"}') 
from datasource_table 
where id =1;