関連する有理多項式係数 (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 | 「近く」 | 有効な値:
|
アウトスリッド | 新しいラスタオブジェクトの空間参照情報。 | integer | 値は、元のラスタオブジェクトの値と同じです。 | なし |
nodataValue | 新しいラスタオブジェクトのバンドに基づいて指定される新しいnodata値。 | float8 float8[] | NULL | nodataValueパラメーターで値または配列を指定できます。
|
RPC_DEM_MISSING_VALUE | demパラメータが新しいnodata値またはラスターデータに設定されている場合の高さ値は、demパラメータの有効値に含まれません。 | float8 | 0 | なし |
次の表に、storageOptionパラメーターのパラメーターを示します。
パラメーター | 説明 | データ型 | デフォルト値 | 説明 |
chunking | データをチャンクとして保存するかどうかを指定します。 | Boolean | 値は、元のラスタオブジェクトの値と同じです。 | なし |
chunkdim | データのチャンクに使用されるディメンション。 | String | 値は、元のラスタオブジェクトの値と同じです。 | このパラメーターは、chunkingパラメーターをtrueに設定した場合にのみ有効になります。 |
chunktable | チャンクテーブルの名前です。 | String | '' | 値 " を指定すると、現在のセッションでランダムな名前の一時チャンクテーブルが作成されます。 このチャンクテーブルは、新しいラスターオブジェクトを格納するために使用されます。 一時チャンクテーブルは、現在のセッションでのみ使用できます。 セッションが終了すると、一時チャンクテーブルも削除されます。 新しいラスターオブジェクトを保存する場合は、チャンクテーブルの名前を指定する必要があります。 指定された並列メソッドが匿名ユーザーによって作成されたチャンクテーブルをサポートしていない場合は、事前にチャンクテーブルを作成する必要があります。 |
compression | ラスターオブジェクトのデータを圧縮する形式。 | String | 値は、元のラスタオブジェクトの値と同じです。 | 有効な値:
|
quality | 圧縮の質。 | integer | 値は、元のラスタオブジェクトの値と同じです。 | このフィールドはJPEG形式でのみ有効です。 |
interleaving | ラスターオブジェクトのデータをインターリーブするために使用されるメソッド。 | String | 値は、元のラスタオブジェクトの値と同じです。 | 有効な値:
|
endian | 新しいラスタオブジェクトのエンディアン形式。 | String | 値は、元のラスタオブジェクトの値と同じです。 | 有効な値:
|
例:
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;