このトピックでは、ST_Transform関数について説明します。 この関数は、ラスターオブジェクトの基本座標を既知の空間参照系から別のものに変換します。
構文
raster ST_Transform(raster rast、
整数outSrid,
cstring processexprデフォルト '',
cstring storageOptionデフォルト '') パラメーター
| パラメーター | 説明 |
| ラスト | 座標を変換する元のラスターオブジェクト。 |
| outSrid | 新しいラスタオブジェクトの空間参照システム。 このパラメーターの値は、spatial_ref_sysテーブルから照会できる有効なSIRDである必要があります。 |
| processExpr | ピクセルをリサンプリングし、nodata値を処理する方法を指定するJSON文字列。 |
| storageOption | 新しいラスターオブジェクトを格納する方法を指定するJSON文字列。 |
processExprパラメーターで指定されたJSON文字列の各子JSONオブジェクトは、フィールドを表します。 次の表に、これらのフィールドを示します。
| フィールド | 説明 | データ型 | デフォルト値 | 設定ノート |
| resample | ピクセルを再サンプリングするために使用される方法。 | テキスト | 近く | 有効な値: Near | Average | Cubic | Bilinear。 |
| ノデータ | 元のラスタオブジェクトのnodata値が有効かどうかを指定します。 | Boolean | false |
|
| nodataValue | 新しいラスタオブジェクトのバンドに基づいて指定された新しいnodata値。 | float8 float8[] | NULL | nodataValueフィールドで1つ以上のnodata値を指定できます。
|
説明 nodataフィールドとnodataValueフィールドを指定するときは注意してください。 元のラスターオブジェクトにnodata値を持つピクセルがない場合は、nodataフィールドをfalseに設定し、nodataValueフィールドを指定しないことを推奨します。 さもなければ、画像アーチファクトが発生し得る。
次の表に、storageOptionパラメーターのフィールドを示します。
| フィールド | 説明 | データ型 | デフォルト値 | 設定ノート |
| チャンキング | 新しいラスターオブジェクトをチャンクとして保存するかどうかを指定します。 | Boolean | 元のラスターオブジェクトと同じ | N/A |
| chunkdim | 新しいラスタオブジェクトをチャンクとして格納するために使用されるディメンション。 | String | 元のラスターオブジェクトと同じ | このフィールドは、チャンキングフィールドがtrueに設定されている場合にのみ有効です。 |
| chunktable | チャンクテーブルの名前です。 | String | null 文字列 (") | デフォルトでは、データを格納するためにランダムな名前の一時チャンクテーブルが生成されます。 この一時チャンクテーブルは、現在のセッションでのみ有効です。 新しいラスターオブジェクトを永続的に保存するには、chunktableフィールドでチャンクテーブルの名前を指定する必要があります。 |
| compression | 画像圧縮に使用される形式。 | String | 元のラスターオブジェクトと同じ | None、JPEG、Zlib、PNG、LZO、LZ4の6つの圧縮形式がサポートされています。 |
| 品質 | 新しいラスターオブジェクトの画質。 | Integer | 元のラスターオブジェクトと同じ | このフィールドはJPEG形式でのみ有効です。 |
| interleaving | 新しいラスタオブジェクトのインターリーブタイプ。 | String | 元のラスターオブジェクトと同じ | 有効な値：
|
| エンディアン | 新しいラスタオブジェクトのエンディアン形式。 | String | 元のラスターオブジェクトと同じ | 有効な値：
|
説明 chunktableフィールドをNULLまたはnull文字列 ('') に設定すると、現在のセッションでランダムな名前の一時チャンクテーブルが生成され、新しいラスターオブジェクトが格納されます。 一時チャンクテーブルは現在のセッションでのみ有効であり、現在のセッションが終了した直後に削除されます。 新しいラスターオブジェクトを永続的に保存するには、chunktableフィールドに永続チャンクテーブルを作成するように指定する必要があります。
例
CREATE TABLEが存在しない場合はdatasource_table(id integer, rast raster);
INSERT INTO datasource_table値 (1, ST_ImportFrom('rbt','$(RAST_DATA_DIR)/512_512_1_bsq_8u_geo.tif', '{}'));
----------------------------------------------------
-- メソッド1: chunktableフィールドを指定して、新しいラスタオブジェクトを格納するための永続チャンクテーブルを作成します。
----------------------------------------------------
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","interleating":"bsq","chunktable":"result_rbt"}')
datasource_tableから
id =1;
-- nodataValueフィールドで1つのnodata値を指定し、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"
datasource_tableから
id =1;
-- nodataValueフィールドに複数のnodata値を指定した場合:
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 "}')
datasource_tableから
id =1;
----------------------------------------------------
-- メソッド2: chunktableフィールドを指定しないでください。 新しいラスターオブジェクトは、ランダムな名前で一時チャンクテーブルに保存され、現在のセッションでネストされた計算にのみ使用できます。
----------------------------------------------------
CREATE TEMP TABLE rat_transform_result_temp(id integer, rast raster);
INSERT INTO rast_clip_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","interleating":"bsq"}')
datasource_tableから
id =1;