將源柵格對象進行投影變換,返回變換后的柵格對象。
語法
raster ST_Transform(raster rast,
integer outSrid,
cstring processexpr default '',
cstring storageOption default '')
參數(shù)
參數(shù)名稱 | 描述 |
---|---|
rast | 需要投影變換的raster對象。 |
outSrid | 輸出的影像的空間參考值,必須為有效的sird值(可以在表spatial_ref_sys查詢到)。 |
processExpr | JSON字符串,指定重采樣的方式以及nodata處理方式。 |
storageOption | 返回結果的存儲選項,為JSON字符串。 |
processExpr為JSON字符串數(shù)組,每個子JSON對象指定參數(shù)如下。
參數(shù)名稱 | 描述 | 類型 | 默認值 | 說明 |
---|---|---|---|---|
resample | 重采樣方式。 | text | 'Near' | 柵格重采樣方式,支持'Near'、'Average'、'Cubic'和'Bilinear'四種。 |
nodata | 源影像的nodata值是否有效。 | bool | false |
|
nodataValue | 按波段指定新的nodata值。 |
float8 float8[] |
NULL | nodataValue可指定為單個值或數(shù)組。
|
說明 nodata與nodatavalue參數(shù)需謹慎使用,如果源柵格沒有nodata,建議nodata設置為false,同時不需要指定nodatavalue,否則會出現(xiàn)結果影像失真的情況。
storageOption參數(shù)如下。
參數(shù)名稱 | 描述 | 類型 | 默認值 | 說明 |
---|---|---|---|---|
chunking | 是否使用分塊存儲。 | boolean | 和原始raster一致 | - |
chunkdim | 分塊的維度信息。 | string | 和原始raster一致 | 在chunking=true時才有效。 |
chunktable | 分塊表名稱。 | string | '' | 如果傳入''值,則會產(chǎn)生一個隨機表名臨時塊表用于存放數(shù)據(jù)。 該臨時表只在當前會話中有效。如果需要保持一個可訪問的裁剪對象,則需要指定塊表名稱。 |
compression | 壓縮算法類型。 | string | 和原始raster一致 | 目前只支持none、jpeg、zlib、png、lzo和lz4。 |
quality | 壓縮質(zhì)量。 | integer | 和原始raster一致 | 只針對jpeg壓縮算法。 |
interleaving | 交錯方式。 | string | 和原始raster一致 | 必須是以下一種:
|
endian | 字節(jié)序。 | string | 和原始raster一致 | 必須為以下其中之一:
|
說明 如果chunktable傳入NULL或者'',則會在當前session中創(chuàng)建一個隨機表名的臨時表用于存放轉(zhuǎn)換后的raster對象,該臨時表只在當前會話中有效,會話結束臨時表也隨即刪除。如果需要將轉(zhuǎn)換的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名稱,將轉(zhuǎn)換結果持續(xù)化存儲
----------------------------------------------------
CREATE TABLE rat_transform_result(id integer, rast raster);
--不指定nodata
INSERT INTO rat_transform_result(id, rast)
select 10, ST_Transform(rast,32652, '{"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_transform_result(id, rast)
select 11, ST_Transform(rast,32652, '{"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數(shù)組
INSERT INTO rat_transform_result(id, rast)
select 12, ST_Transform(rast,32652, '{"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名稱,轉(zhuǎn)換結果存放在隨機表名的臨時表中,僅可用于session內(nèi)部的嵌套計算
----------------------------------------------------
CREATE TEMP TABLE rat_transform_result_temp(id integer, rast raster);
INSERT INTO rat_transform_result_temp(id, rast)
select 1, ST_Transform(rast,32652,'{"resample":"Near","nodata":false, "nodataValue":[255,255,255]}','{"chunking":true,"chunkdim":"(256,256,1)","compression":"none","interleaving":"bsq"}')
from datasource_table
where id =1;