すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB RDS:ST_RPCRectify

最終更新日:Jan 15, 2024

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

構文

ラスターST_RPCRectify (ラスターrast、
 ラスターdemデフォルトNULL,
                    cstring rectifyOptionのデフォルト '{}' 、
                    cstring storageOptionのデフォルト '{}' 、
   cstring parallelOptionのデフォルト '{}') 

パラメーター

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

説明

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

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

パラメーター説明データ型デフォルト値説明
resampleピクセルを再サンプリングするために使用されるメソッド。String「近く」有効な値:
  • 近く
  • Average
  • 立方
  • バイリニア
アウトスリッド新しいラスタオブジェクトの空間参照情報。integer値は、元のラスタオブジェクトの値と同じです。なし
nodataValue新しいラスタオブジェクトのバンドに基づいて指定される新しいnodata値。 float8

float8[]

NULLnodataValueパラメーターで値または配列を指定できます。
  • 値を指定した場合、その値は新しいラスタオブジェクトのすべてのバンドに使用されます。
  • 配列 [0,0, 0] を指定する場合、配列要素の数は、新しいラスタオブジェクトのバンド数と同じでなければなりません。
  • このパラメーターを指定しない場合、システムはこのパラメーターを元のラスターオブジェクトのnodataValueパラメーターの値に設定します。 元のnodataValueパラメーターが指定されていない場合、システムはこのパラメーターを0に設定します。
RPC_DEM_MISSING_VALUEdemパラメータが新しいnodata値またはラスターデータに設定されている場合の高さ値は、demパラメータの有効値に含まれません。 float80なし

次の表に、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が存在しない場合は、raster_table(id integer, rast raster);

-- RPCラスタデータ。
INSERT INTO raster_table値 (1, ST_ImportFrom('t_chunk','<RAST_DATA_DIR>/rpc.tif', '{}'));

-DEMデータ。
INSERT INTO raster_table値 (2, ST_ImportFrom('t_chunk','<RAST_DATA_DIR>/rpc_dem.tif', '{}'));

CREATE TABLE raster_result(id integer, rast raster);

-- demパラメーターが指定されていません。 システムは、Nearest Neighbor Search (NNS) 法を用いてデータをサンプリングする。
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"}')
raster_tableから
id =1;

-- demパラメータが指定されています。 システムは、NNS法を用いてデータをサンプリングする。
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}')
raster_tableから
id =1;