ST_RPCRectify - PolarDB - Alibaba Cloud ドキュメントセンター

関連する有理多項式係数 (RPC) パラメーターに基づいてラスタデータファイルを修正し、更新されたラスタデータファイルを返します。

構文

raster ST_RPCRectify(raster rast,
 raster dem default NULL,
                    cstring rectifyOption default '{}',
                    cstring storageOption default '{}',
   cstring parallelOption default '{}')

パラメーター

パラメーター	説明
rast	修正するラスターオブジェクト。
dem	この関数がラスタオブジェクトを修正するときに参照されるデジタル標高モデル (DEM) 。デフォルト値：null
rectifyOption	修正するオプション。値は JSON 形式の文字列です。
storageOption	出力のストレージオプションです。値は JSON 形式の文字列です。
parallelOption	並列オプション。値は JSON 形式の文字列です。

説明

ラスタオブジェクトにはRPC情報が含まれている必要があります。

rectifyOptionは、JSON形式の文字列の配列です。次の表に、各JSONオブジェクトのパラメーターを示します。

パラメーター	説明	データ型	デフォルト値	説明
resample	ピクセルを再サンプリングするために使用されるメソッド。	String	'Near'	有効な値： Near Average Cubic Bilinear
outSrid	新しいラスタオブジェクトの空間参照情報。	integer	The value is the same as the value for the original raster object.	None
nodataValue	新しいラスタオブジェクトのバンドに基づいて指定される新しいnodata値。	float8 float8[]	NULL	nodataValueパラメーターで値または配列を指定できます。値を指定した場合、その値は新しいラスタオブジェクトのすべてのバンドに使用されます。配列 [0,0, 0] を指定する場合、配列要素の数は、新しいラスタオブジェクトのバンド数と同じでなければなりません。このパラメーターを指定しない場合、システムはこのパラメーターを元のラスターオブジェクトのnodataValueパラメーターの値に設定します。元のnodataValueパラメーターが指定されていない場合、システムはこのパラメーターを0に設定します。
RPC_DEM_MISSING_VALUE	demパラメータが新しいnodata値またはラスターデータに設定されている場合の高さ値は、demパラメータの有効値に含まれません。	float8	0	None

次の表に、storageOptionパラメーターのパラメーターを示します。

パラメーター	説明	データ型	デフォルト値	説明
chunking	データをチャンクとして保存するかどうかを指定します。	Boolean	値は、元のラスタオブジェクトの値と同じです。	なし
chunkdim	データのチャンクに使用されるディメンション。	String	値は、元のラスタオブジェクトの値と同じです。	このパラメーターは、chunkingパラメーターをtrueに設定した場合にのみ有効になります。
chunktable	チャンクテーブルの名前です。	String	`''`	値 `"`を指定すると、現在のセッションでランダムな名前の一時チャンクテーブルが作成されます。このチャンクテーブルは、新しいラスターオブジェクトを格納するために使用されます。一時チャンクテーブルは、現在のセッションでのみ使用できます。セッションが終了すると、一時チャンクテーブルも削除されます。新しいラスターオブジェクトを保存する場合は、チャンクテーブルの名前を指定する必要があります。指定された並列メソッドが匿名ユーザーによって作成されたチャンクテーブルをサポートしていない場合は、事前にチャンクテーブルを作成する必要があります。
compression	ラスターオブジェクトのデータを圧縮する形式。	String	値は、元のラスタオブジェクトの値と同じです。	有効な値：なし JPEG ZLIB PNG LZO LZ4 JP2K
quality	圧縮の質。	integer	値は、元のラスタオブジェクトの値と同じです。	このフィールドはJPEG形式でのみ有効です。
interleaving	ラスターオブジェクトのデータをインターリーブするために使用されるメソッド。	String	値は、元のラスタオブジェクトの値と同じです。	有効な値： bip : ピクセルでインターリーブされたバンド (BIP) bil : ラインでインターリーブされたバンド (BIL) bsq : バンドシーケンシャル (BSQ)
endian	新しいラスタオブジェクトのエンディアン形式。	String	値は、元のラスタオブジェクトの値と同じです。	有効な値： NDR: 少しエンディアン XDR: ビッグエンディアン

例：

CREATE TABLE if not exists raster_table(id integer, rast raster);

-- The RPC raster data.
INSERT INTO raster_table values(1, ST_ImportFrom('t_chunk','<RAST_DATA_DIR>/rpc.tif', '{}'));

-- The DEM data.
INSERT INTO raster_table values(2, ST_ImportFrom('t_chunk','<RAST_DATA_DIR>/rpc_dem.tif', '{}'));

CREATE TABLE raster_result(id integer, rast raster);

-- The dem parameter is not specified. The system samples data by using the Nearest Neighbor Search (NNS) method.
INSERT INTO raster_result(id, rast) 
select 10, ST_RPCRectify(rast,
                       NULL,    
                         '{"resample":"Near"}',
                         '{"chunking":true,"chunkdim":"(256,256,1)","interleaving":"bsq","chunktable":"t_chunk"}') 
from raster_table 
where id =1;

-- The dem parameter is specified. The system samples data by using the NNS method.
INSERT INTO raster_result(id, rast) 
select 11, ST_RPCRectify(rast,
                       (SELECT rast FROM raster_table WHERE id = 2),    
                         '{"resample":"Near", "outSrid": 32635}',
                         '{"chunking":true,"chunkdim":"(256,256,1)","interleaving":"bsq","chunktable":"t_chunk"}',
                         '{"parallel": 8}') 
from raster_table 
where id =1;