ST_SnapToGrid
戻る  11.7. ラスターエディタ  次へ

名前

ST_SnapToGrid — グリッドにスナップすることでラスターをリサンプリングします。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間('Lanczos') を用います。デフォルトは最近傍補間です。

概要

raster ST_SnapToGrid(raster rast, double precision gridx, double precision gridy, text algorithm=NearestNeighbor, double precision maxerr=0.125, double precision scalex=DEFAULT 0, double precision scaley=DEFAULT 0);

raster ST_SnapToGrid(raster rast, double precision gridx, double precision gridy, double precision scalex, double precision scaley, text algorithm=NearestNeighbor, double precision maxerr=0.125);

raster ST_SnapToGrid(raster rast, double precision gridx, double precision gridy, double precision scalexy, text algorithm=NearestNeighbor, double precision maxerr=0.125);

説明

任意のピクセル隅 (gridx & gridy) と、任意引数としてピクセルサイズ (scalex & scaley) によって定義されるグリッドにスナップすることでラスターをリサンプリングします。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos') を用います。デフォルトは最も早いですが最も悪い内挿を行う最近傍補間です。

gridxとgridyは、新しいグリッドの任意のピクセル隅を定義します。これは新しいラスターの左上隅に必ずなるものではありません。新しいラスター範囲の内部または境界である必要はありません。

任意引数として、新しいグリッドのピクセルサイズをscalexとscaleyで指定することができます。

新しいラスターの範囲は元のラスターの範囲を含みます。

maxerrが指定されていない場合には 0.125とします。

[注記]

詳細については GDAL Warp resampling methodsをご覧下さい。

[注記]

グリッドパラメーターより多くの制御が必要な場合には、ST_Resampleを使います。

Availability: 2.0.0 GDAL 1.6.1以上が必要です。

Changed: 2.1.0 SRID なしのラスターで動作するようになりました。

例

ラスターをわずかに異なるグリッドにスナップさせる簡単な例です。

この例では元のラスターの左上の X 座標値を返します。

コード
SELECT ST_UpperLeftX(ST_AddBand(ST_MakeEmptyRaster(10, 10, 0, 0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0));
出力
st_upperleftx
---------------
             0
(1 row)

スナップ後のラスターの左上座標値。

コード
SELECT ST_UpperLeftX(ST_SnapToGrid(ST_AddBand(ST_MakeEmptyRaster(10, 10, 0, 0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0), 0.0002, 0.0002));
出力
st_upperleftx
---------------
       -0.0008
(1 row)