ラスタ管理 |
AddRasterConstraints
ロードされたラスタテーブルの特定のカラムにラスタ制約を追加します。制約には空間参照系、スケール、ブロックサイズ、アラインメント、バンド数、バンド型、ラスタカラムが規則正しいブロックかどうかを示すフラグがあります。テーブルは制約が推論されるためのデータがロードされなければなりません。制約の設定が完了するとtrueを返し、問題があると通知を返します。
- rasttable, rastcolumn, srid=true, scale_x=true, scale_y=true, blocksize_x=true, blocksize_y=true, same_alignment=true, regular_blocking=false, num_bands=true, pixel_types=true, nodata_values=true, out_db=true, extent=true
- rasttable, rastcolumn, VARIADIC constraints
- rastschema, rasttable, rastcolumn, VARIADIC constraints
- rastschema, rasttable, rastcolumn, srid=true, scale_x=true, scale_y=true, blocksize_x=true, blocksize_y=true, same_alignment=true, regular_blocking=false, num_bands=true, pixel_types=true, nodata_values=true, out_db=true, extent=true
|
DropRasterConstraints
ラスタテーブルカラムを参照するPostGISラスタ制約を削除します。データの再読み込みやラスタカラムデータの更新の際に使えます。
- rasttable, rastcolumn, srid, scale_x, scale_y, blocksize_x, blocksize_y, same_alignment, regular_blocking, num_bands=true, pixel_types=true, nodata_values=true, out_db=true, extent=true
- rastschema, rasttable, rastcolumn, srid=true, scale_x=true, scale_y=true, blocksize_x=true, blocksize_y=true, same_alignment=true, regular_blocking=false, num_bands=true, pixel_types=true, nodata_values=true, out_db=true, extent=true
- rastschema, rasttable, rastcolumn, constraints
|
AddOverviewConstraints
ラスタカラムに対して、他のオーバビューであることをタグ付けします。
- ovschema, ovtable, ovcolumn, refschema, reftable, refcolumn, ovfactor
- ovtable, ovcolumn, reftable, refcolumn, ovfactor
|
DropOverviewConstraints
ラスタカラムに対して他のオーバビューであることをタグ付けしているのを解除します。
- ovschema, ovtable, ovcolumn
- ovtable, ovcolumn
|
PostGIS_GDAL_Version
()
PostGISで使っているGDALライブラリの版を報告します。 |
PostGIS_Raster_Lib_Build_Date
()
完全なラスタライブラリをビルドした日付を報告します。 |
PostGIS_Raster_Lib_Version
()
完全なラスタの版とビルドコンフィギュレーション情報を報告します。 |
ST_GDALDrivers
()
使用しているGDALライブラリが対応するラスタ書式の一覧を返します。この一覧でcan_write=TrueとなっているものだけがST_AsGDALRasterで使えます。 |
ST_Contour
(rast, bandnumber=1, level_interval=100.0, level_base=0.0, fixed_levels=ARRAY[], polygonize=false)
与えられたラスタバンドから等高線ベクタを生成します。GDAL等高線生成アルゴリズムを使います。 |
ST_InterpolateRaster
(input_points, algorithm_options, template, template_band_num=1)
X値とY値を使用してグリッド上のポイントを配置し、ポイントのZ値をサーフェス標高として配置し、3次元ポイントの入力セットに基づいてグリッドサーフェスを補間します。 |
UpdateRasterSRID
ユーザが指定したカラムとテーブルにあるラスタの全てについてSRIDを変更します。
- schema_name, table_name, column_name, new_srid
- table_name, column_name, new_srid
|
ST_CreateOverview
(tab, col, factor, algo='NearestNeighbor')
与えられたラスタカバレッジから解像度を落としたものを生成します。 |
ラスタコンストラクタ |
ST_AddBand
与えられたタイプで、与えられた初期値にした新しいバンドを、与えられたインデックス位置に追加したラスタを返します。インデックス位置を指定していない場合には、バンドは末尾に追加されます。
- rast, addbandargset
- rast, index, pixeltype, initialvalue=0, nodataval=NULL
- rast, pixeltype, initialvalue=0, nodataval=NULL
- torast, fromrast, fromband=1, torastindex=at_end
- torast, fromrasts, fromband=1, torastindex=at_end
- rast, index, outdbfile, outdbindex, nodataval=NULL
- rast, outdbfile, outdbindex, index=at_end, nodataval=NULL
|
ST_AsRaster
PostGISジオメトリをPostGISラスタに変換します。
- geom, ref, pixeltype, value=1, nodataval=0, touched=false
- geom, ref, pixeltype=ARRAY['8BUI'], value=ARRAY[1], nodataval=ARRAY[0], touched=false
- geom, scalex, scaley, gridx, gridy, pixeltype, value=1, nodataval=0, skewx=0, skewy=0, touched=false
- geom, scalex, scaley, gridx=NULL, gridy=NULL, pixeltype=ARRAY['8BUI'], value=ARRAY[1], nodataval=ARRAY[0], skewx=0, skewy=0, touched=false
- geom, scalex, scaley, pixeltype, value=1, nodataval=0, upperleftx=NULL, upperlefty=NULL, skewx=0, skewy=0, touched=false
- geom, scalex, scaley, pixeltype, value=ARRAY[1], nodataval=ARRAY[0], upperleftx=NULL, upperlefty=NULL, skewx=0, skewy=0, touched=false
- geom, width, height, gridx, gridy, pixeltype, value=1, nodataval=0, skewx=0, skewy=0, touched=false
- geom, width, height, gridx=NULL, gridy=NULL, pixeltype=ARRAY['8BUI'], value=ARRAY[1], nodataval=ARRAY[0], skewx=0, skewy=0, touched=false
- geom, width, height, pixeltype, value=1, nodataval=0, upperleftx=NULL, upperlefty=NULL, skewx=0, skewy=0, touched=false
- geom, width, height, pixeltype, value=ARRAY[1], nodataval=ARRAY[0], upperleftx=NULL, upperlefty=NULL, skewx=0, skewy=0, touched=false
|
ST_Band
既存のラスタの、一つ以上のバンドを新しいラスタとして返します。既存のラスタから新しいラスタを構築する際に使えます。
- rast, nbands = ARRAY[1]
- rast, nband
- rast, nbands, delimiter=,
|
ST_MakeEmptyCoverage
(tilewidth, tileheight, width, height, upperleftx, upperlefty, scalex, scaley, skewx, skewy, srid=unknown)
空のラスタタイルのグリッドでジオリファレンスを施されている領域を生成します。 |
ST_MakeEmptyRaster
与えられたピクセル範囲 (width & height)、左上のX,Y、ピクセルサイズ、回転 (scalex, scaley, skewx, skewy)と空間参照系 (srid)が指定された空ラスタ (バンドを持たないラスタ)を返します。ラスタが渡されると、新しいラスタは渡されたラスタと同じサイズ、アラインメント、SRIDになります。SRIDが指定されていない場合には、空間参照系は不明 (0)とされます。
- rast
- width, height, upperleftx, upperlefty, scalex, scaley, skewx, skewy, srid=unknown
- width, height, upperleftx, upperlefty, pixelsize
|
ST_Tile
求められた出力ラスタのピクセル数に基づいて入力ラスタを分割した結果のラスタ集合を返します。
- rast, nband, width, height, padwithnodata=FALSE, nodataval=NULL
- rast, nband, width, height, padwithnodata=FALSE, nodataval=NULL
- rast, width, height, padwithnodata=FALSE, nodataval=NULL
|
ST_Retile
(tab, col, ext, sfx, sfy, tw, th, algo='NearestNeighbor')
任意のタイル化されたラスタカバレッジから構成されたタイルの集合を返します。 |
ST_FromGDALRaster
(gdaldata, srid=NULL)
対応するGDALラスタファイルからラスタを返します。 |
ラスタアクセサ |
ST_GeoReference
(rast, format=GDAL)
GDAL書式または一般的にワールドファイルでみられるESRI書式の地理参照メタデータを返します。デフォルトはGDALです。 |
ST_Height
(rast)
ラスタの高さをピクセル単位で返します。 |
ST_IsEmpty
(rast)
ラスタが空 (幅が0で高さが0)の場合にはTRUEを返します。他の場合には、FALSEを返します。 |
ST_MemSize
(rast)
ラスタが取る領域の合計をバイト単位で返します。 |
ST_MetaData
(rast)
ピクセル数、回転 (スキュー)、左上隅位置等のラスタオブジェクトに関する基本的なメタデータを返します。 |
ST_NumBands
(rast)
ラスタオブジェクトのバンド数を返します。 |
ST_PixelHeight
(rast)
空間参照系の地理的な単位でのピクセルの高さを返します。 |
ST_PixelWidth
(rast)
空間参照系の地理的な単位でのピクセルの幅を返します。 |
ST_ScaleX
(rast)
空間参照系の地理的な単位でのピクセル幅のX成分を返します。 |
ST_ScaleY
(rast)
空間参照系の地理的な単位でのピクセル幅のY成分を返します。 |
ST_RasterToWorldCoord
(rast, xcolumn, yrow)
ラスタの指定した列と行における左上隅の地理座標X値とY値 (経度と緯度)を返します。列と行の番号は1始まりです。 |
ST_RasterToWorldCoordX
ラスタの指定した列と行における左上隅の地理座標のX値を返します。列と行の番号は1始まりです。
- rast, xcolumn
- rast, xcolumn, yrow
|
ST_RasterToWorldCoordY
ラスタの指定した列と行における左上隅の地理座標のY値を返します。列と行の番号は1始まりです。
- rast, yrow
- rast, xcolumn, yrow
|
ST_Rotation
(rast)
ラスタの回転をラジアンで返します。 |
ST_SkewX
(rast)
空間参照のXスキュー (回転パラメータ)を返します。 |
ST_SkewY
(rast)
空間参照のYスキュー (回転パラメータ)を返します。 |
ST_SRID
(rast)
ラスタのspatial_ref_sysテーブルで定義されている空間参照系識別番号を返します。 |
ST_Summary
(rast)
ラスタの中身の概要が文字列で返されます。 |
ST_UpperLeftX
(rast)
適用されている空間参照系でのラスタの左上隅のX座標値を返します。 |
ST_UpperLeftY
(rast)
適用されている空間参照系でのラスタの左上隅のY座標値を返します。 |
ST_Width
(rast)
ラスタの幅をピクセル単位で返します。 |
ST_WorldToRasterCoord
ラスタの空間参照系による地理座標のX値とY値 (経度と緯度)またはポイントジオメトリに対応するピクセルの左上隅を返します。
- rast, pt
- rast, longitude, latitude
|
ST_WorldToRasterCoordX
ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの列を返します。
- rast, pt
- rast, xw
- rast, xw, yw
|
ST_WorldToRasterCoordY
ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの行を返します。
- rast, pt
- rast, xw
- rast, xw, yw
|
ラスタピクセルアクセサとセッター |
ST_PixelAsPolygon
(rast, columnx, rowy)
指定した行と列のピクセルの境界となるジオメトリを返します。 |
ST_PixelAsPolygons
(rast, band=1, exclude_nodata_value=TRUE)
全てのピクセルについて境界となるジオメトリを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。 |
ST_PixelAsPoint
(rast, columnx, rowy)
ピクセルの左上隅のポイントジオメトリを返します。 |
ST_PixelAsPoints
(rast, band=1, exclude_nodata_value=TRUE)
全てのピクセルについてポイントジオメトリを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルの左上隅です。 |
ST_PixelAsCentroid
(rast, x, y)
ピクセルで表現される面の重心 (ポイントジオメトリ)を返します。 |
ST_PixelAsCentroids
(rast, band=1, exclude_nodata_value=TRUE)
全てのピクセルについて重心 (ポイントジオメト)リを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルで表現される面の重心です。 |
ST_Value
指定したバンドにおけるcolumnx, rowyで指定したピクセルまたは指定したジオメトリポイントに対応するピクセルの値を返します。 バンド番号は1始まりで、指定しない場合には、1番と仮定します。exclude_nodata_valueがFALSEに設定された場合には、NODATA ピクセルを含む全てのピクセルがインタセクトするかが考慮され、値を返します。exclude_nodata_valueを渡さない場合には、ラスタのメタデータから読みます。
- rast, pt, exclude_nodata_value=true
- rast, band, pt, exclude_nodata_value=true, resample='nearest'
- rast, x, y, exclude_nodata_value=true
- rast, band, x, y, exclude_nodata_value=true
|
ST_NearestValue
与えられたバンドの、columnxとrowyで指定されるか、またはラスタと同じ空間参照系で表現されたポイントで指定されたピクセルに最も近いNODATAでない値を返します。
- rast, bandnum, pt, exclude_nodata_value=true
- rast, pt, exclude_nodata_value=true
- rast, bandnum, columnx, rowy, exclude_nodata_value=true
- rast, columnx, rowy, exclude_nodata_value=true
|
ST_SetZ
(rast, geom, resample=nearest, band=1)
入力ジオメトリと同じX/y座標値と、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたZ値とを持つジオメトリを返します。 |
ST_SetM
(rast, geom, resample=nearest, band=1)
入力ジオメトリと同じX/Y値を持ち、かつ、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたM値を持つジオメトリを返します。 |
ST_Neighborhood
与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの周囲にある、NODATAでない2次元倍精度浮動小数点数配列を返します。
- rast, bandnum, columnX, rowY, distanceX, distanceY, exclude_nodata_value=true
- rast, columnX, rowY, distanceX, distanceY, exclude_nodata_value=true
- rast, bandnum, pt, distanceX, distanceY, exclude_nodata_value=true
- rast, pt, distanceX, distanceY, exclude_nodata_value=true
|
ST_SetValue
与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの値または指定したジオメトリとインタセクトするピクセル群の値を設定することから得られる、変更されたラスタを返します。バンド番号は1始まりで、指定しない場合には、1番と仮定します。
- rast, bandnum, geom, newvalue
- rast, geom, newvalue
- rast, bandnum, columnx, rowy, newvalue
- rast, columnx, rowy, newvalue
|
ST_SetValues
与えられたバンドに複数の値を設定して、変更されたラスタを返します。
- rast, nband, columnx, rowy, newvalueset, noset=NULL, keepnodata=FALSE
- rast, nband, columnx, rowy, newvalueset, nosetvalue, keepnodata=FALSE
- rast, nband, columnx, rowy, width, height, newvalue, keepnodata=FALSE
- rast, columnx, rowy, width, height, newvalue, keepnodata=FALSE
- rast, nband, geomvalset, keepnodata=FALSE
|
ST_DumpValues
指定したバンドの値を2次元で得ます。
- rast, nband=NULL, exclude_nodata_value=true
- rast, nband, exclude_nodata_value=true
|
ST_PixelOfValue
検索値と同じ値を持つピクセルのcolumnx, rowyピクセル座標を得ます。
- rast, nband, search, exclude_nodata_value=true
- rast, search, exclude_nodata_value=true
- rast, nband, search, exclude_nodata_value=true
- rast, search, exclude_nodata_value=true
|
ラスタエディタ |
ST_SetGeoReference
地理参照6パラメタを一度に設定します。数値は空白で区切ります。GDALまたはESRI書式の入力を受け付けます。デフォルトはGDALです。
- rast, georefcoords, format=GDAL
- rast, upperleftx, upperlefty, scalex, scaley, skewx, skewy
|
ST_SetRotation
(rast, rotation)
ラスタの回転をラジアン単位で設定します。 |
ST_SetScale
ピクセルサイズのX値とY値を空間参照系の単位で設定します。数値は単位/ピクセルの幅または高さです。
- rast, xy
- rast, x, y
|
ST_SetSkew
地理参照のスキュー (回転パラメタ)のX値とY値を設定します。一つだけ渡した場合には、X値とY値は同じ値に設定されます。
- rast, skewxy
- rast, skewx, skewy
|
ST_SetSRID
(rast, srid)
スタのSRIDをspatial_ref_sysに定義されている特定の整数値に設定します。 |
ST_SetUpperLeft
(rast, x, y)
ラスタの左上隅の投影座標系のX値とY値を設定します。 |
ST_Resample
指定したリサンプリングアルゴリズム、新しいピクセル範囲、グリッドの隅、定義するか他のラスタから借りてきた地理参照属性を使ってリサンプリングを行います。
- rast, width, height, gridx=NULL, gridy=NULL, skewx=0, skewy=0, algorithm=NearestNeighbor, maxerr=0.125
- rast, scalex=0, scaley=0, gridx=NULL, gridy=NULL, skewx=0, skewy=0, algorithm=NearestNeighbor, maxerr=0.125
- rast, ref, algorithm=NearestNeighbor, maxerr=0.125, usescale=true
- rast, ref, usescale, algorithm=NearestNeighbor, maxerr=0.125
|
ST_Rescale
スケール (ピクセルサイズ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (英語または米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。
- rast, scalexy, algorithm=NearestNeighbor, maxerr=0.125
- rast, scalex, scaley, algorithm=NearestNeighbor, maxerr=0.125
|
ST_Reskew
キュー (回転パラメタ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。
- rast, skewxy, algorithm=NearestNeighbor, maxerr=0.125
- rast, skewx, skewy, algorithm=NearestNeighbor, maxerr=0.125
|
ST_SnapToGrid
グリッドにスナップすることでラスタをリサンプリングします。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間('Lanczos')を用います。デフォルトは最近傍補間です。
- rast, gridx, gridy, algorithm=NearestNeighbor, maxerr=0.125, scalex=DEFAULT 0, scaley=DEFAULT 0
- rast, gridx, gridy, scalex, scaley, algorithm=NearestNeighbor, maxerr=0.125
- rast, gridx, gridy, scalexy, algorithm=NearestNeighbor, maxerr=0.125
|
ST_Resize
ラスタを新しい幅、高さにサイズ再設定を行います。
- rast, width, height, algorithm=NearestNeighbor, maxerr=0.125
- rast, percentwidth, percentheight, algorithm=NearestNeighbor, maxerr=0.125
- rast, width, height, algorithm=NearestNeighbor, maxerr=0.125
|
ST_Transform
ラスタを既知の空間参照系から他の既知の空間参照系に、指定したリサンプリングアルゴリズムで投影変換します。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。
- rast, srid, algorithm=NearestNeighbor, maxerr=0.125, scalex, scaley
- rast, srid, scalex, scaley, algorithm=NearestNeighbor, maxerr=0.125
- rast, alignto, algorithm=NearestNeighbor, maxerr=0.125
|
ラスタバンド統計情報と解析 |
ST_Count
ラスタまたはラスタカバレッジの指定したバンドのピクセル数を返します。バンドを指定しない場合には、1番と仮定します。exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。
- rast, nband=1, exclude_nodata_value=true
- rast, exclude_nodata_value
|
ST_CountAgg
集約関数です。ラスタ集合の与えられたバンドのピクセル数を返します。バンドが指定されていない場合には、1番と仮定します。exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。
- rast, nband, exclude_nodata_value, sample_percent
- rast, nband, exclude_nodata_value
- rast, exclude_nodata_value
|
ST_Histogram
ラスタまたはラスタカバレッジのビン範囲で分割したデータ分布をまとめるヒストグラムの集合を返します。ビン数を指定しない場合には自動計算されます。
- rast, nband=1, exclude_nodata_value=true, bins=autocomputed, width=NULL, right=false
- rast, nband, bins, width=NULL, right=false
- rast, nband, exclude_nodata_value, bins, right
- rast, nband, bins, right
|
ST_Quantile
ラスタまたはラスタテーブルカバレッジのサンプルまたは母集団の分位数を計算します。値がラスタの25%,50%,75%にあるかを調べることができます。
- rast, nband=1, exclude_nodata_value=true, quantiles=NULL
- rast, quantiles
- rast, nband, quantiles
- rast, quantile
- rast, exclude_nodata_value, quantile=NULL
- rast, nband, quantile
- rast, nband, exclude_nodata_value, quantile
- rast, nband, quantile
|
ST_SummaryStats
ラスタまたはラスタカバレッジの指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる統計情報の概要を返します。バンドを指定しない場合には、1番と仮定します。
- rast, exclude_nodata_value
- rast, nband, exclude_nodata_value
|
ST_SummaryStatsAgg
集約関数です。ラスタ集合の指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる統計情報の概要を返します。バンドを指定しない場合には、1番と仮定します。
- rast, nband, exclude_nodata_value, sample_percent
- rast, exclude_nodata_value, sample_percent
- rast, nband, exclude_nodata_value
|
ST_ValueCount
ラスタ (またはラスタカバレッジ)の指定されたバンドで、指定した値を持つピクセルを対象として、ピクセルバンド値とピクセル数からなるレコードの集合を返します。バンドを指定しない場合には、1番と仮定します。デフォルトではNODATA値のピクセルは数えられず、ピクセルの他の値は出力され、ピクセルバンド値は最も近い整数に丸められます。
- rast, nband=1, exclude_nodata_value=true, searchvalues=NULL, roundto=0,
- rast, nband, searchvalues, roundto=0,
- rast, searchvalues, roundto=0,
- rast, searchvalue, roundto=0
- rast, nband, exclude_nodata_value, searchvalue, roundto=0
- rast, nband, searchvalue, roundto=0
- rastertable, rastercolumn, nband=1, exclude_nodata_value=true, searchvalues=NULL, roundto=0,
- rastertable, rastercolumn, searchvalues, roundto=0,
- rastertable, rastercolumn, nband, searchvalues, roundto=0,
- rastertable, rastercolumn, nband, exclude_nodata_value, searchvalue, roundto=0
- rastertable, rastercolumn, searchvalue, roundto=0
- rastertable, rastercolumn, nband, searchvalue, roundto=0
|
出力 |
ST_AsBinary/ST_AsWKB
ラスタのWell-Known Binary (WKB)表現を返します。
- rast, outasin=FALSE
- rast, outasin=FALSE
|
ST_AsHexWKB
(rast, outasin=FALSE)
Well-Known Binary (WKB)ラスタを16進数表現で返します。 |
ST_AsGDALRaster
(rast, format, options=NULL, srid=sameassource)
指定されたGDALラスタ書式でラスタタイルを返します。ラスタ書式はコンパイルしたライブラリが対応するものです。ライブラリが対応する書式の一覧を得るにはST_GDALRasters()を使います。 |
ST_AsJPEG
ラスタの選択されたバンドを、単一のJoint Photographic Exports Group (JPEG)画像としてバイト配列で返します。バンドを指定せず、1バンドか3より多いバンドがある場合には、1番バンドを使用します。3バンドのみ指定した場合には、3バンドを使用し、RGBに対応付けます。
- rast, options=NULL
- rast, nband, quality
- rast, nband, options=NULL
- rast, nbands, options=NULL
- rast, nbands, quality
|
ST_AsPNG
ラスタの選択されたバンドを、単一のportable network graphics (PNG)画像としてバイト配列で返します。バンドを指定せず、1バンドか3バンドか4バンドある場合には、全てのバンドを使用します。バンドを指定せず、2バンドか4より多いバンドがある場合には、1番バンドを使用します。対象バンドはRGBまたはRGBAに対応付けられます。
- rast, options=NULL
- rast, nband, compression
- rast, nband, options=NULL
- rast, nbands, compression
- rast, nbands, options=NULL
|
ST_AsTIFF
ラスタの選択されたバンドを、単一のTIFF画像 (バイト配列)として返します。バンドを指定しないか指定したバンドがラスタ内に無い場合には、全てのバンドの使用を試みます。
- rast, options='', srid=sameassource
- rast, compression='', srid=sameassource
- rast, nbands, compression='', srid=sameassource
- rast, nbands, options, srid=sameassource
|
ラスタ処理: 地図代数 |
ST_Clip
入力ジオメトリで切り取ったラスタを返します。バンドが指定されていない場合には、全てのバンドが処理されます。cropが指定されていなかったりTRUE となっている場合には、出力ラスタは切り取られます。touchedがTRUEの場合には、接触するピクセルは取り込まれ、TRUEでない場合には、中心がジオメトリ内にあるピクセルだけが取り込まれます。
- rast, nband, geom, nodataval=NULL, crop=TRUE, touched=FALSE
- rast, nband, geom, nodataval, crop=TRUE, touched=FALSE
- rast, nband, geom, crop, touched=FALSE
- rast, geom, nodataval=NULL, crop=TRUE, touched=FALSE
- rast, geom, nodataval, crop=TRUE, touched=FALSE
- rast, geom, crop, touched=FALSE
|
ST_ColorMap
元のラスタと指定したバンドから4個までの8BUIバンド (grayscale, RGB, RGBA)からなる新しいラスタを生成します。
- rast, nband=1, colormap=grayscale, method=INTERPOLATE
- rast, colormap, method=INTERPOLATE
|
ST_Grayscale
元のラスタと指定したバンドを赤、緑、青バンドとして一つの8BUIバンドを持つラスタを生成します。
- rast, redband=1, greenband=2, blueband=3, extenttype=INTERSECTION
- rastbandargset, extenttype=INTERSECTION
|
ST_Intersection
二つのラスタの共有部分またはベクタ化したラスタとジオメトリとのインタセクトした部分を表現する、ラスタまたはジオメトリとピクセル値の組の集合を返します。
- geom, rast, band_num=1
- rast, geom
- rast, band, geomin
- rast1, rast2, nodataval
- rast1, rast2, returnband, nodataval
- rast1, band1, rast2, band2, nodataval
- rast1, band1, rast2, band2, returnband, nodataval
|
ST_MapAlgebra (callback function version)
コールバック関数版 - 一つ以上の入力ラスタ、バンドインデックスと一つのユーザ定義コールバック関数から、一つのバンドからなるラスタを返します。
- rastbandargset, callbackfunc, pixeltype=NULL, extenttype=INTERSECTION, customextent=NULL, distancex=0, distancey=0, VARIADIC userargs=NULL
- rast, nband, callbackfunc, pixeltype=NULL, extenttype=FIRST, customextent=NULL, distancex=0, distancey=0, VARIADIC userargs=NULL
- rast, nband, callbackfunc, pixeltype=NULL, extenttype=FIRST, customextent=NULL, distancex=0, distancey=0, VARIADIC userargs=NULL
- rast1, nband1, rast2, nband2, callbackfunc, pixeltype=NULL, extenttype=INTERSECTION, customextent=NULL, distancex=0, distancey=0, VARIADIC userargs=NULL
- rast, nband, callbackfunc, mask, weighted, pixeltype=NULL, extenttype=INTERSECTION, customextent=NULL, VARIADIC userargs=NULL
|
ST_MapAlgebra (expression version)
数式版 - 一つか二つの入力ラスタ、バンド番号、一つ以上のユーザ定義SQL式から一つのバンドを持つラスタを返します。
- rast, nband, pixeltype, expression, nodataval=NULL
- rast, pixeltype, expression, nodataval=NULL
- rast1, nband1, rast2, nband2, expression, pixeltype=NULL, extenttype=INTERSECTION, nodata1expr=NULL, nodata2expr=NULL, nodatanodataval=NULL
- rast1, rast2, expression, pixeltype=NULL, extenttype=INTERSECTION, nodata1expr=NULL, nodata2expr=NULL, nodatanodataval=NULL
|
ST_MapAlgebraExpr
1バンド版: 入力バンドに対する妥当なPostgreSQL代数演算で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番を仮定します。
- rast, band, pixeltype, expression, nodataval=NULL
- rast, pixeltype, expression, nodataval=NULL
|
ST_MapAlgebraExpr
2バンド版: 二つの入力バンドに対する妥当なPostgreSQL代数演算で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、どちらも1番と仮定します。結果ラスタは、一つ目のラスタのアラインメント (スケール、スキュー、ピクセル角位置)にあわされます。範囲は"extenttype"引数で定義されます。取りうる"extenttype"の値はINTERSECTION, UNION, FIRST, SECONDです。
- rast1, rast2, expression, pixeltype=same_as_rast1_band, extenttype=INTERSECTION, nodata1expr=NULL, nodata2expr=NULL, nodatanodataval=NULL
- rast1, band1, rast2, band2, expression, pixeltype=same_as_rast1_band, extenttype=INTERSECTION, nodata1expr=NULL, nodata2expr=NULL, nodatanodataval=NULL
|
ST_MapAlgebraFct
1バンド版 - 入力バンドに対する妥当なPostgreSQL関数で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番と仮定します。
- rast, onerasteruserfunc
- rast, onerasteruserfunc, VARIADIC args
- rast, pixeltype, onerasteruserfunc
- rast, pixeltype, onerasteruserfunc, VARIADIC args
- rast, band, onerasteruserfunc
- rast, band, onerasteruserfunc, VARIADIC args
- rast, band, pixeltype, onerasteruserfunc
- rast, band, pixeltype, onerasteruserfunc, VARIADIC args
|
ST_MapAlgebraFct
2バンド版 - 二つの入力バンドに対する妥当なPostgreSQL関数で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番と仮定します。"extenttype"のデフォルトはINTERSECTIONです。
- rast1, rast2, tworastuserfunc, pixeltype=same_as_rast1, extenttype=INTERSECTION, VARIADIC userargs
- rast1, band1, rast2, band2, tworastuserfunc, pixeltype=same_as_rast1, extenttype=INTERSECTION, VARIADIC userargs
|
ST_MapAlgebraFctNgb
(rast, band, pixeltype, ngbwidth, ngbheight, onerastngbuserfunc, nodatamode, VARIADIC args)
1バンド版: ユーザ定義PostgreSQL関数を使用する最近傍地図代数関数です。入力ラスタバンドの近傍の値を与えたPL/pgSQLユーザ定義関数の結果からなるラスタを返します。 |
ST_Reclass
元のラスタから再分類したバンドタイプからなるラスタを生成します。nbandは変更するバンドです。nbandが指定されていない場合には、1と仮定します。他の全てのバンドは変更せずに返します。可視画像の書式としてより単純な描画を行うために、16BUIバンドを8BUIバンドに変換する、等のために使います。
- rast, nband, reclassexpr, pixeltype, nodataval=NULL
- rast, VARIADIC reclassargset
- rast, reclassexpr, pixeltype
|
ST_Union
ラスタタイルの集合を結合して1以上のバンドからなる単一ラスタを返します。
- rast
- rast, unionargset
- rast, nband
- rast, uniontype
- rast, nband, uniontype
|
組み込み地図代数コールバック関数 |
ST_Distinct4ma
近隣のピクセル値のうち一意となるものを数えるラスタ処理関数です。
- matrix, nodatamode, VARIADIC args
- value, pos, VARIADIC userargs
|
ST_InvDistWeight4ma
(value, pos, VARIADIC userargs)
近隣のピクセル値の内挿補間を行うラスタ処理関数です。 |
ST_Max4ma
近隣のピクセル値の最大値を計算するラスタ処理関数です。
- matrix, nodatamode, VARIADIC args
- value, pos, VARIADIC userargs
|
ST_Mean4ma
近隣のピクセル値の平均値を計算するラスタ処理関数です。
- matrix, nodatamode, VARIADIC args
- value, pos, VARIADIC userargs
|
ST_Min4ma
近隣のピクセル値の最小値を計算するラスタ処理関数です。
- matrix, nodatamode, VARIADIC args
- value, pos, VARIADIC userargs
|
ST_MinDist4ma
(value, pos, VARIADIC userargs)
対象ピクセルと値を持つ近隣ピクセルとの最短距離をピクセル単位で返すラスタ処理関数です。 |
ST_Range4ma
近隣のピクセル値の範囲を計算するラスタ処理関数です。
- matrix, nodatamode, VARIADIC args
- value, pos, VARIADIC userargs
|
ST_StdDev4ma
近隣のピクセル値の標準偏差を計算するラスタ処理関数です。
- matrix, nodatamode, VARIADIC args
- value, pos, VARIADIC userargs
|
ST_Sum4ma
近隣のピクセル値の合計を計算するラスタ処理関数です。
- matrix, nodatamode, VARIADIC args
- value, pos, VARIADIC userargs
|
ラスタ処理: DEM (標高) |
ST_Aspect
標高ラスタバンドの傾斜方向 (デフォルトの単位は度)を返します。地形解析に使えます。
- rast, band=1, pixeltype=32BF, units=DEGREES, interpolate_nodata=FALSE
- rast, band, customextent, pixeltype=32BF, units=DEGREES, interpolate_nodata=FALSE
|
ST_HillShade
与えられた方位、高度、明度、スケールの入力を使って標高ラスタバンドの仮想照明を返します。
- rast, band=1, pixeltype=32BF, azimuth=315, altitude=45, max_bright=255, scale=1.0, interpolate_nodata=FALSE
- rast, band, customextent, pixeltype=32BF, azimuth=315, altitude=45, max_bright=255, scale=1.0, interpolate_nodata=FALSE
|
ST_Roughness
(rast, nband, customextent, pixeltype="32BF", interpolate_nodata=FALSE )
DEMの「粗度」を計算したラスタを返します。 |
ST_Slope
標高ラスタバンドの傾斜角 (デフォルトでは度単位)を返します。地形解析に使えます。
- rast, nband=1, pixeltype=32BF, units=DEGREES, scale=1.0, interpolate_nodata=FALSE
- rast, nband, customextent, pixeltype=32BF, units=DEGREES, scale=1.0, interpolate_nodata=FALSE
|
ST_TPI
(rast, nband, customextent, pixeltype="32BF", interpolate_nodata=FALSE )
地形的位置指数を計算したラスタを返します。 |
ST_TRI
(rast, nband, customextent, pixeltype="32BF", interpolate_nodata=FALSE )
起伏指標を計算したラスタを返します。 |
ラスタとラスタバンドの空間関係関数 |
ST_Contains
rastAの外にrastBの点が無く、rastAの内部にrastBの内部の点が一つ以上ある場合にTRUEを返します。
- rastA, nbandA, rastB, nbandB
- rastA, rastB
|
ST_ContainsProperly
rastBがrastAの内部でインタセクトし、かつrastAの境界とも外部ともインタセクトしない場合にTRUEを返します。
- rastA, nbandA, rastB, nbandB
- rastA, rastB
|
ST_Covers
rastBがrastAの外部に点を持たない場合にTRUEを返します。
- rastA, nbandA, rastB, nbandB
- rastA, rastB
|
ST_CoveredBy
rastAがrastBの外部に点を持たない場合にTRUEを返します。
- rastA, nbandA, rastB, nbandB
- rastA, rastB
|
ST_Disjoint
rastAがrastBとインタセクトしない場合にTRUEを返します。
- rastA, nbandA, rastB, nbandB
- rastA, rastB
|
ST_Intersects
rastAがrastBとインタセクトする場合にTRUEを返します。
- rastA, nbandA, rastB, nbandB
- rastA, rastB
- rast, nband, geommin
- rast, geommin, nband=NULL
- geommin, rast, nband=NULL
|
ST_Overlaps
rastAとrastBがインタセクトして、かつ一方がもう一方に完全には包含されない場合にはTRUEを返します。
- rastA, nbandA, rastB, nbandB
- rastA, rastB
|
ST_Touches
rastAとrastBが少なくとも一つの共通の点を持ち、かつ二つのラスタの内部同士がインタセクトしない場合にTRUEを返します。
- rastA, nbandA, rastB, nbandB
- rastA, rastB
|
ST_SameAlignment
ラスタが同じスキュー、スケール、空間参照系、オフセットを持つ (ピクセルが分割されることなく同じグリッドに置かれている)場合にTRUEを返し、そうでない場合は問題を詳述する通知とともにFALSEを返します。
- rastA, rastB
- ulx1, uly1, scalex1, scaley1, skewx1, skewy1, ulx2, uly2, scalex2, scaley2, skewx2, skewy2
- rastfield agg
|
ST_NotSameAlignmentReason
(rastA, rastB)
ラスタが同じアラインメントを持つかどうか、また、持たない場合にはその理由を示す文字列を返します。 |
ST_Within
rastAがrastBの外部に点を持たず、rastAの内部の少なくとも一つの点がrastBの内部にある場合にTRUEを返します。
- rastA, nbandA, rastB, nbandB
- rastA, rastB
|
ST_DWithin
rastAとrastBが指定した距離内にある場合にTRUEを返します。
- rastA, nbandA, rastB, nbandB, distance_of_srid
- rastA, rastB, distance_of_srid
|
ST_DFullyWithin
rastAとrastBが指定した距離内に完全に収まる場合にTRUEを返します。
- rastA, nbandA, rastB, nbandB, distance_of_srid
- rastA, rastB, distance_of_srid
|