PostGIS 3.5 柵格速查表

此版本新增 1 此版本增強 2   聚合 agg    需要 GEOS (3.9,3.10,3.11,3.12) 或更高版本 g3.9   2.5/3D 支援 3d   SQL-MMmm   支援地理 G
柵格支援資料類型
geomval    一個空間資料類型，具有兩個欄位 - geom（持有幾何物件）和 val（持有來自柵格波段的雙精度像素值）。
addbandarg    一種複合類型，用作 ST_AddBand 函數的輸入，定義新波段的屬性和初始值。
rastbandarg    一種複合類型，用於需要表達柵格和該柵格的波段索引時。
raster    柵格空間資料類型。
reclassarg    一種複合類型，用作 ST_Reclass 函數的輸入，定義重分類的行為。
summarystats    一種複合類型，由 ST_SummaryStats 和 ST_SummaryStatsAgg 函數返回。
unionarg    一種複合類型，用作 ST_Union 函數的輸入，定義要處理的波段和 UNION 操作的行為。

柵格管理
AddRasterConstraints    將柵格約束添加到已載入的柵格表格的特定欄位，該約束限制空間參考、比例、區塊大小、對齊方式、波段、波段類型以及一個標誌，表示柵格欄位是否為規則區塊。必須載入資料才能推斷約束。如果已完成約束設定則返回 true，否則發出通知。
  1. 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
  2. rasttable, rastcolumn, VARIADIC constraints
  3. rastschema, rasttable, rastcolumn, VARIADIC constraints
  4. 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 柵格約束。如果您需要重新載入資料或更新您的柵格欄位資料，則很有用。
  1. 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
  2. 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
  3. rastschema, rasttable, rastcolumn, constraints
AddOverviewConstraints    將柵格欄位標記為另一個柵格的概觀。
  1. ovschema, ovtable, ovcolumn, refschema, reftable, refcolumn, ovfactor
  2. ovtable, ovcolumn, reftable, refcolumn, ovfactor
DropOverviewConstraints    將柵格欄位從另一個柵格的概觀中取消標記。
  1. ovschema, ovtable, ovcolumn
  2. ovtable, ovcolumn
PostGIS_GDAL_Version ()    報告 PostGIS 使用的 GDAL 程式庫版本。
PostGIS_Raster_Lib_Build_Date ()    報告完整的柵格程式庫建置日期。
PostGIS_Raster_Lib_Version ()    報告完整的柵格版本和建置組態資訊。
ST_GDALDrivers ()    傳回 PostGIS 通過 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)    使用輸入的 3-d 點集，根據格狀表面進行內插。使用 X 和 Y 值在網格上定位點，並使用點的 Z 值作為表面高度。
UpdateRasterSRID    變更使用者指定欄位和表格中所有柵格的 SRID。
  1. schema_name, table_name, column_name, new_srid
  2. table_name, column_name, new_srid
ST_CreateOverview (tab, col, factor, algo='NearestNeighbor')    建立給定柵格覆蓋範圍的縮小解析度版本。

柵格建構函式
ST_AddBand    傳回一個柵格，其中包含以給定索引位置新增的給定類型的新波段，並具有給定的初始值。如果未指定索引，則將波段新增到末尾。
  1. rast, addbandargset
  2. rast, index, pixeltype, initialvalue=0, nodataval=NULL
  3. rast, pixeltype, initialvalue=0, nodataval=NULL
  4. torast, fromrast, fromband=1, torastindex=at_end
  5. torast, fromrasts, fromband=1, torastindex=at_end
  6. rast, index, outdbfile, outdbindex, nodataval=NULL
  7. rast, outdbfile, outdbindex, index=at_end, nodataval=NULL
ST_AsRaster    將 PostGIS 幾何轉換為 PostGIS 柵格。
  1. geom, ref, pixeltype, value=1, nodataval=0, touched=false
  2. geom, ref, pixeltype=ARRAY['8BUI'], value=ARRAY[1], nodataval=ARRAY[0], touched=false
  3. geom, scalex, scaley, gridx, gridy, pixeltype, value=1, nodataval=0, skewx=0, skewy=0, touched=false
  4. geom, scalex, scaley, gridx=NULL, gridy=NULL, pixeltype=ARRAY['8BUI'], value=ARRAY[1], nodataval=ARRAY[0], skewx=0, skewy=0, touched=false
  5. geom, scalex, scaley, pixeltype, value=1, nodataval=0, upperleftx=NULL, upperlefty=NULL, skewx=0, skewy=0, touched=false
  6. geom, scalex, scaley, pixeltype, value=ARRAY[1], nodataval=ARRAY[0], upperleftx=NULL, upperlefty=NULL, skewx=0, skewy=0, touched=false
  7. geom, width, height, gridx, gridy, pixeltype, value=1, nodataval=0, skewx=0, skewy=0, touched=false
  8. geom, width, height, gridx=NULL, gridy=NULL, pixeltype=ARRAY['8BUI'], value=ARRAY[1], nodataval=ARRAY[0], skewx=0, skewy=0, touched=false
  9. geom, width, height, pixeltype, value=1, nodataval=0, upperleftx=NULL, upperlefty=NULL, skewx=0, skewy=0, touched=false
  10. geom, width, height, pixeltype, value=ARRAY[1], nodataval=ARRAY[0], upperleftx=NULL, upperlefty=NULL, skewx=0, skewy=0, touched=false
ST_Band    以新柵格形式傳回現有柵格的一個或多個波段。適用於從現有柵格建立新柵格。
  1. rast, nbands = ARRAY[1]
  2. rast, nband
  3. rast, nbands, delimiter=,
ST_MakeEmptyCoverage (tilewidth, tileheight, width, height, upperleftx, upperlefty, scalex, scaley, skewx, skewy, srid=unknown)    以空白柵格圖塊網格覆蓋地理參考區域。
ST_MakeEmptyRaster    傳回具有給定維度（寬度和高度）、左上 X 和 Y、像素大小和旋轉（scalex、scaley、skewx 和 skewy）以及參考系統 (srid) 的空白柵格（沒有波段）。如果傳入柵格，則傳回具有相同大小、對齊方式和 SRID 的新柵格。如果省略 srid，則空間參考會設定為未知 (0)。
  1. rast
  2. width, height, upperleftx, upperlefty, scalex, scaley, skewx, skewy, srid=unknown
  3. width, height, upperleftx, upperlefty, pixelsize
ST_Tile    傳回一組柵格，這些柵格是根據所需輸出柵格的維度分割輸入柵格而產生的。
  1. rast, nband, width, height, padwithnodata=FALSE, nodataval=NULL
  2. rast, nband, width, height, padwithnodata=FALSE, nodataval=NULL
  3. 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。
  1. rast, xcolumn
  2. rast, xcolumn, yrow
ST_RasterToWorldCoordY    傳回影像柵格、欄和列的左上角幾何 Y 座標。欄和列的起始編號為 1。
  1. rast, yrow
  2. 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 (經度和緯度) 或以影像柵格空間參考座標系統表示的點幾何的欄和列左上角。
  1. rast, pt
  2. rast, longitude, latitude
ST_WorldToRasterCoordX    傳回點幾何 (pt) 或以影像柵格的世界空間參考系統表示的 X 和 Y 世界座標 (xw, yw) 的影像柵格中的欄。
  1. rast, pt
  2. rast, xw
  3. rast, xw, yw
ST_WorldToRasterCoordY    傳回點幾何 (pt) 或以影像柵格的世界空間參考系統表示的 X 和 Y 世界座標 (xw, yw) 的影像柵格中的列。
  1. rast, pt
  2. rast, xw
  3. rast, xw, yw

影像柵格波段存取器
ST_BandMetaData    傳回特定影像柵格波段的基本中繼資料。如果未指定波段編號，則預設為波段編號 1。
  1. rast, band=1
  2. rast, band
ST_BandNoDataValue (rast, bandnum=1)    傳回指定波段中代表無資料的值。如果沒有指定波段編號，則預設為波段編號 1。
ST_BandIsNoData    如果波段僅填入無資料值，則傳回 true。
  1. rast, band, forceChecking=true
  2. rast, forceChecking=true
ST_BandPath (rast, bandnum=1)    傳回儲存在檔案系統中波段的系統檔案路徑。如果沒有指定波段編號，則預設為 1。
ST_BandFileSize (rast, bandnum=1)    傳回儲存在檔案系統中波段的檔案大小。如果沒有指定波段編號，則預設為 1。
ST_BandFileTimestamp (rast, bandnum=1)    傳回儲存在檔案系統中波段的檔案時間戳記。如果沒有指定波段編號，則預設為 1。
ST_BandPixelType (rast, bandnum=1)    傳回指定波段的像素類型。如果沒有指定波段編號，則預設為 1。
ST_MinPossibleValue (pixeltype)    傳回此像素類型可儲存的最小值。
ST_HasNoBand (rast, bandnum=1)    如果沒有具有指定波段編號的波段，則傳回 true。如果沒有指定波段編號，則預設為波段編號 1。

影像柵格像素存取器和設定器
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    傳回指定欄、列像素或特定幾何點中指定波段的值。波段編號從 1 開始，如果未指定，則預設為 1。如果 exclude_nodata_value 設定為 false，則會考慮所有包含無資料像素的像素都相交並傳回值。如果未傳入 exclude_nodata_value，則從影像柵格的中繼資料讀取。
  1. rast, pt, exclude_nodata_value=true
  2. rast, band, pt, exclude_nodata_value=true, resample='nearest'
  3. rast, x, y, exclude_nodata_value=true
  4. rast, band, x, y, exclude_nodata_value=true
ST_NearestValue    傳回由 columnx 和 rowy 或以與影像柵格相同的空間參考座標系統表示的幾何點指定的指定波段像素最接近的非 NODATA 值。
  1. rast, bandnum, pt, exclude_nodata_value=true
  2. rast, pt, exclude_nodata_value=true
  3. rast, bandnum, columnx, rowy, exclude_nodata_value=true
  4. 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 和 rowY 或以與影像柵格相同的空間參考座標系統表示的幾何點指定的給定波段像素周圍非 NODATA 值的二維雙精確度陣列。
  1. rast, bandnum, columnX, rowY, distanceX, distanceY, exclude_nodata_value=true
  2. rast, columnX, rowY, distanceX, distanceY, exclude_nodata_value=true
  3. rast, bandnum, pt, distanceX, distanceY, exclude_nodata_value=true
  4. rast, pt, distanceX, distanceY, exclude_nodata_value=true
ST_SetValue    傳回從設定指定欄、列像素中指定波段的值或與特定幾何圖形相交的像素而修改的影像柵格。波段編號從 1 開始，如果未指定，則預設為 1。
  1. rast, bandnum, geom, newvalue
  2. rast, geom, newvalue
  3. rast, bandnum, columnx, rowy, newvalue
  4. rast, columnx, rowy, newvalue
ST_SetValues    傳回從設定指定波段的值而修改的影像柵格。
  1. rast, nband, columnx, rowy, newvalueset, noset=NULL, keepnodata=FALSE
  2. rast, nband, columnx, rowy, newvalueset, nosetvalue, keepnodata=FALSE
  3. rast, nband, columnx, rowy, width, height, newvalue, keepnodata=FALSE
  4. rast, columnx, rowy, width, height, newvalue, keepnodata=FALSE
  5. rast, nband, geomvalset, keepnodata=FALSE
ST_DumpValues    以二維陣列的形式取得指定波段的值。
  1. rast, nband=NULL, exclude_nodata_value=true
  2. rast, nband, exclude_nodata_value=true
ST_PixelOfValue    取得其值等於搜尋值的像素的 columnx、rowy 座標。
  1. rast, nband, search, exclude_nodata_value=true
  2. rast, search, exclude_nodata_value=true
  3. rast, nband, search, exclude_nodata_value=true
  4. rast, search, exclude_nodata_value=true

影像柵格編輯器
ST_SetGeoReference    在單次呼叫中設定地理參考 6 個地理參考參數。數字應以空白分隔。接受 GDAL 或 ESRI 格式的輸入。預設為 GDAL。
  1. rast, georefcoords, format=GDAL
  2. rast, upperleftx, upperlefty, scalex, scaley, skewx, skewy
ST_SetRotation (rast, rotation)    設定影像柵格的旋轉角度，以弧度表示。
ST_SetScale    設定像素在坐標參考系統單位中的 X 和 Y 大小。數值單位/像素寬度/高度。
  1. rast, xy
  2. rast, x, y
ST_SetSkew    設定地理參考的 X 和 Y 傾斜（或旋轉參數）。如果只傳入一個值，則 X 和 Y 會設為相同的值。
  1. rast, skewxy
  2. rast, skewx, skewy
ST_SetSRID (rast, srid)    將柵格的 SRID 設定為 spatial_ref_sys 表格中定義的特定整數 srid。
ST_SetUpperLeft (rast, x, y)    將柵格像素左上角的投影 X 和 Y 坐標值設定為指定值。
ST_Resample    使用指定的重採樣演算法、新維度、任意網格角落以及一組從另一個柵格定義或借用的柵格地理參考屬性，對柵格進行重採樣。
  1. rast, width, height, gridx=NULL, gridy=NULL, skewx=0, skewy=0, algorithm=NearestNeighbor, maxerr=0.125
  2. rast, scalex=0, scaley=0, gridx=NULL, gridy=NULL, skewx=0, skewy=0, algorithm=NearestNeighbor, maxerr=0.125
  3. rast, ref, algorithm=NearestNeighbor, maxerr=0.125, usescale=true
  4. rast, ref, usescale, algorithm=NearestNeighbor, maxerr=0.125
ST_Rescale    僅透過調整其縮放比例（或像素大小）對柵格進行重採樣。新的像素值是使用 NearestNeighbor（英式或美式拼寫）、Bilinear、Cubic、CubicSpline、Lanczos、Max 或 Min 重採樣演算法計算得出。預設為 NearestNeighbor。
  1. rast, scalexy, algorithm=NearestNeighbor, maxerr=0.125
  2. rast, scalex, scaley, algorithm=NearestNeighbor, maxerr=0.125
ST_Reskew    僅透過調整其傾斜度（或旋轉參數）對柵格進行重採樣。新的像素值是使用 NearestNeighbor（英式或美式拼寫）、Bilinear、Cubic、CubicSpline 或 Lanczos 重採樣演算法計算得出。預設為 NearestNeighbor。
  1. rast, skewxy, algorithm=NearestNeighbor, maxerr=0.125
  2. rast, skewx, skewy, algorithm=NearestNeighbor, maxerr=0.125
ST_SnapToGrid    透過將柵格貼齊網格來對其進行重採樣。新的像素值是使用 NearestNeighbor（英式或美式拼寫）、Bilinear、Cubic、CubicSpline 或 Lanczos 重採樣演算法計算得出。預設為 NearestNeighbor。
  1. rast, gridx, gridy, algorithm=NearestNeighbor, maxerr=0.125, scalex=DEFAULT 0, scaley=DEFAULT 0
  2. rast, gridx, gridy, scalex, scaley, algorithm=NearestNeighbor, maxerr=0.125
  3. rast, gridx, gridy, scalexy, algorithm=NearestNeighbor, maxerr=0.125
ST_Resize    將柵格調整為新的寬度/高度。
  1. rast, width, height, algorithm=NearestNeighbor, maxerr=0.125
  2. rast, percentwidth, percentheight, algorithm=NearestNeighbor, maxerr=0.125
  3. rast, width, height, algorithm=NearestNeighbor, maxerr=0.125
ST_Transform    使用指定的重採樣演算法，將已知空間參考系統中的柵格重新投影到另一個已知的空間參考系統。選項包括 NearestNeighbor、Bilinear、Cubic、CubicSpline、Lanczos，預設為 NearestNeighbor。
  1. rast, srid, algorithm=NearestNeighbor, maxerr=0.125, scalex, scaley
  2. rast, srid, scalex, scaley, algorithm=NearestNeighbor, maxerr=0.125
  3. rast, alignto, algorithm=NearestNeighbor, maxerr=0.125

柵格波段編輯器
ST_SetBandNoDataValue    設定指定波段中代表無資料的值。如果未指定波段，則假設為波段 1。若要將波段標記為沒有無資料值，請將無資料值設為 NULL。
  1. rast, nodatavalue
  2. rast, band, nodatavalue, forcechecking=false
ST_SetBandIsNoData (rast, band=1)    將波段的 isnodata 旗標設為 TRUE。
ST_SetBandPath (rast, band, outdbpath, outdbindex, force=false)    更新外部資料庫波段的外部路徑和波段編號。
ST_SetBandIndex (rast, band, outdbindex, force=false)    更新外部資料庫波段的外部波段編號。

柵格波段統計與分析
ST_Count    傳回柵格或柵格涵蓋範圍的指定波段中的像素數量。如果未指定波段，則預設為波段 1。如果 exclude_nodata_value 設定為 true，則只會計算不等於無資料值的像素。
  1. rast, nband=1, exclude_nodata_value=true
  2. rast, exclude_nodata_value
ST_CountAgg    聚合函數。傳回一組柵格的指定波段中的像素數量。如果未指定波段，則預設為波段 1。如果 exclude_nodata_value 設定為 true，則只會計算不等於 NODATA 值的像素。
  1. rast, nband, exclude_nodata_value, sample_percent
  2. rast, nband, exclude_nodata_value
  3. rast, exclude_nodata_value
ST_Histogram    傳回一組記錄，總結柵格或柵格涵蓋範圍資料分佈的獨立區間範圍。如果未指定，則會自動計算區間數量。
  1. rast, nband=1, exclude_nodata_value=true, bins=autocomputed, width=NULL, right=false
  2. rast, nband, bins, width=NULL, right=false
  3. rast, nband, exclude_nodata_value, bins, right
  4. rast, nband, bins, right
ST_Quantile    在樣本或母體的上下文中，計算柵格或柵格表格涵蓋範圍的分位數。因此，可以檢查一個值是否在柵格的第 25%、50%、75% 百分位數。
  1. rast, nband=1, exclude_nodata_value=true, quantiles=NULL
  2. rast, quantiles
  3. rast, nband, quantiles
  4. rast, quantile
  5. rast, exclude_nodata_value, quantile=NULL
  6. rast, nband, quantile
  7. rast, nband, exclude_nodata_value, quantile
  8. rast, nband, quantile
ST_SummaryStats    傳回 summarystats，包括柵格或柵格涵蓋範圍的指定柵格波段的計數、總和、平均值、標準差、最小值、最大值。如果未指定波段，則假設為波段 1。
  1. rast, exclude_nodata_value
  2. rast, nband, exclude_nodata_value
ST_SummaryStatsAgg    聚合函數。傳回 summarystats，包括一組柵格的指定柵格波段的計數、總和、平均值、標準差、最小值、最大值。如果未指定波段，則假設為波段 1。
  1. rast, nband, exclude_nodata_value, sample_percent
  2. rast, exclude_nodata_value, sample_percent
  3. rast, nband, exclude_nodata_value
ST_ValueCount    傳回一組記錄，其中包含像素波段值，以及柵格（或柵格涵蓋範圍）的指定波段中具有指定值集之像素的計數。如果未指定波段，則預設為波段 1。預設情況下，不會計算無資料值的像素。會輸出像素中的所有其他值，像素波段值會四捨五入為最接近的整數。
  1. rast, nband=1, exclude_nodata_value=true, searchvalues=NULL, roundto=0,
  2. rast, nband, searchvalues, roundto=0,
  3. rast, searchvalues, roundto=0,
  4. rast, searchvalue, roundto=0
  5. rast, nband, exclude_nodata_value, searchvalue, roundto=0
  6. rast, nband, searchvalue, roundto=0
  7. rastertable, rastercolumn, nband=1, exclude_nodata_value=true, searchvalues=NULL, roundto=0,
  8. rastertable, rastercolumn, searchvalues, roundto=0,
  9. rastertable, rastercolumn, nband, searchvalues, roundto=0,
  10. rastertable, rastercolumn, nband, exclude_nodata_value, searchvalue, roundto=0
  11. rastertable, rastercolumn, searchvalue, roundto=0
  12. rastertable, rastercolumn, nband, searchvalue, roundto=0

柵格輸入
ST_RastFromWKB (wkb)    從 Well-Known Binary (WKB) 柵格傳回柵格值。
ST_RastFromHexWKB (wkb)    從 Well-Known Binary (WKB) 柵格的十六進位表示法傳回柵格值。

柵格輸出
ST_AsBinary/ST_AsWKB    傳回柵格的 Well-Known Binary (WKB) 表示法。
  1. rast, outasin=FALSE
  2. rast, outasin=FALSE
ST_AsHexWKB (rast, outasin=FALSE)    傳回柵格的 Well-Known Binary (WKB) 的十六進位表示法。
ST_AsGDALRaster (rast, format, options=NULL, srid=sameassource)    以指定的 GDAL 柵格格式傳回柵格圖磚。柵格格式是您編譯程式庫支援的其中一種格式。使用 ST_GDALDrivers() 取得您的程式庫支援的格式清單。
ST_AsJPEG    將選取的柵格圖磚波段傳回為單一聯合圖像專家組 (JPEG) 圖像（位元組陣列）。如果未指定波段且有 1 個或 3 個以上的波段，則只會使用第一個波段。如果只有 3 個波段，則會使用所有 3 個波段並對應到 RGB。
  1. rast, options=NULL
  2. rast, nband, quality
  3. rast, nband, options=NULL
  4. rast, nbands, options=NULL
  5. rast, nbands, quality
ST_AsPNG    將選取的柵格圖磚波段傳回為單一可攜式網路圖形 (PNG) 圖像（位元組陣列）。如果柵格中有 1、3 或 4 個波段且未指定波段，則會使用所有波段。如果超過 2 個或 4 個以上的波段且未指定波段，則只會使用波段 1。波段會對應到 RGB 或 RGBA 空間。
  1. rast, options=NULL
  2. rast, nband, compression
  3. rast, nband, options=NULL
  4. rast, nbands, compression
  5. rast, nbands, options=NULL
ST_AsTIFF    將選取的柵格波段傳回為單一 TIFF 影像（位元組陣列）。如果未指定波段或任何指定的波段不存在於柵格中，則會嘗試使用所有波段。
  1. rast, options='', srid=sameassource
  2. rast, compression='', srid=sameassource
  3. rast, nbands, compression='', srid=sameassource
  4. rast, nbands, options, srid=sameassource

柵格處理：地圖代數
ST_Clip  2    傳回以輸入幾何圖形剪裁的柵格。如果未指定波段編號，則會處理所有波段。如果未指定 crop 或 TRUE，則會裁剪輸出柵格。如果將 touched 設定為 TRUE，則會包含接觸到的像素，否則只有當像素的中心位於幾何圖形中時，才會包含像素。
  1. rast, nband, geom, nodataval=NULL, crop=TRUE, touched=FALSE
  2. rast, nband, geom, nodataval, crop=TRUE, touched=FALSE
  3. rast, nband, geom, crop, touched=FALSE
  4. rast, geom, nodataval=NULL, crop=TRUE, touched=FALSE
  5. rast, geom, nodataval, crop=TRUE, touched=FALSE
  6. rast, geom, crop, touched=FALSE
ST_ColorMap    從來源柵格和指定的波段建立最多四個 8BUI 波段（灰階、RGB、RGBA）的新柵格。如果未指定，則假設為波段 1。
  1. rast, nband=1, colormap=grayscale, method=INTERPOLATE
  2. rast, colormap, method=INTERPOLATE
ST_Grayscale    從來源柵格和指定的紅、綠、藍波段建立新的單一 8 位元無符號整數 (8BUI) 波段柵格。
  1. rast, redband=1, greenband=2, blueband=3, extenttype=INTERSECTION
  2. rastbandargset, extenttype=INTERSECTION
ST_Intersection    傳回柵格或一組幾何-像素值對，表示兩個柵格的共用部分，或是柵格向量化與幾何的幾何交集。
  1. geom, rast, band_num=1
  2. rast, geom
  3. rast, band, geomin
  4. rast1, rast2, nodataval
  5. rast1, rast2, returnband, nodataval
  6. rast1, band1, rast2, band2, nodataval
  7. rast1, band1, rast2, band2, returnband, nodataval
ST_MapAlgebra (回呼函式版本)    回呼函式版本 - 傳回單波段柵格，該柵格由一個或多個輸入柵格、波段索引和一個使用者指定的回呼函式產生。
  1. rastbandargset, callbackfunc, pixeltype=NULL, extenttype=INTERSECTION, customextent=NULL, distancex=0, distancey=0, VARIADIC userargs=NULL
  2. rast, nband, callbackfunc, pixeltype=NULL, extenttype=FIRST, customextent=NULL, distancex=0, distancey=0, VARIADIC userargs=NULL
  3. rast, nband, callbackfunc, pixeltype=NULL, extenttype=FIRST, customextent=NULL, distancex=0, distancey=0, VARIADIC userargs=NULL
  4. rast1, nband1, rast2, nband2, callbackfunc, pixeltype=NULL, extenttype=INTERSECTION, customextent=NULL, distancex=0, distancey=0, VARIADIC userargs=NULL
  5. rast, nband, callbackfunc, mask, weighted, pixeltype=NULL, extenttype=INTERSECTION, customextent=NULL, VARIADIC userargs=NULL
ST_MapAlgebra (表達式版本)    表達式版本 - 傳回單波段柵格，該柵格由一個或兩個輸入柵格、波段索引和一個或多個使用者指定的 SQL 表達式產生。
  1. rast, nband, pixeltype, expression, nodataval=NULL
  2. rast, pixeltype, expression, nodataval=NULL
  3. rast1, nband1, rast2, nband2, expression, pixeltype=NULL, extenttype=INTERSECTION, nodata1expr=NULL, nodata2expr=NULL, nodatanodataval=NULL
  4. rast1, rast2, expression, pixeltype=NULL, extenttype=INTERSECTION, nodata1expr=NULL, nodata2expr=NULL, nodatanodataval=NULL
ST_MapAlgebraExpr    單波段柵格版本：建立一個新的單波段柵格，該柵格是透過在輸入柵格波段上套用有效的 PostgreSQL 代數運算，並使用提供的像素類型形成。如果未指定波段，則假設為波段 1。
  1. rast, band, pixeltype, expression, nodataval=NULL
  2. rast, pixeltype, expression, nodataval=NULL
ST_MapAlgebraExpr    雙波段柵格版本：建立一個新的單波段柵格，該柵格是透過在兩個輸入柵格波段上套用有效的 PostgreSQL 代數運算，並使用提供的像素類型形成。如果未指定波段號碼，則假設為每個柵格的波段 1。結果柵格將根據第一個柵格定義的格線對齊（比例、傾斜和像素角），並且其範圍由 "extenttype" 參數定義。"extenttype" 的值可以是：INTERSECTION、UNION、FIRST、SECOND。
  1. rast1, rast2, expression, pixeltype=same_as_rast1_band, extenttype=INTERSECTION, nodata1expr=NULL, nodata2expr=NULL, nodatanodataval=NULL
  2. rast1, band1, rast2, band2, expression, pixeltype=same_as_rast1_band, extenttype=INTERSECTION, nodata1expr=NULL, nodata2expr=NULL, nodatanodataval=NULL
ST_MapAlgebraFct    單波段版本 - 建立一個新的單波段柵格，該柵格是透過在輸入柵格波段上套用有效的 PostgreSQL 函式，並使用提供的像素類型形成。如果未指定波段，則假設為波段 1。
  1. rast, onerasteruserfunc
  2. rast, onerasteruserfunc, VARIADIC args
  3. rast, pixeltype, onerasteruserfunc
  4. rast, pixeltype, onerasteruserfunc, VARIADIC args
  5. rast, band, onerasteruserfunc
  6. rast, band, onerasteruserfunc, VARIADIC args
  7. rast, band, pixeltype, onerasteruserfunc
  8. rast, band, pixeltype, onerasteruserfunc, VARIADIC args
ST_MapAlgebraFct    雙波段版本 - 建立一個新的單波段柵格，該柵格是透過在兩個輸入柵格波段上套用有效的 PostgreSQL 函式，並使用提供的像素類型形成。如果未指定波段，則假設為波段 1。如果未指定，範圍類型預設為 INTERSECTION。
  1. rast1, rast2, tworastuserfunc, pixeltype=same_as_rast1, extenttype=INTERSECTION, VARIADIC userargs
  2. rast1, band1, rast2, band2, tworastuserfunc, pixeltype=same_as_rast1, extenttype=INTERSECTION, VARIADIC userargs
ST_MapAlgebraFctNgb (rast, band, pixeltype, ngbwidth, ngbheight, onerastngbuserfunc, nodatamode, VARIADIC args)    單波段版本：使用使用者定義的 PostgreSQL 函式進行地圖代數最近鄰分析。傳回柵格，該柵格的值是 PLPGSQL 使用者函式的結果，該函式涉及輸入柵格波段的值的鄰近範圍。
ST_Reclass    建立一個新的柵格，其中包含從原始柵格重新分類的波段類型。nband 是要變更的波段。如果未指定 nband，則假設為 1。所有其他波段都保持不變。使用案例：將 16BUI 波段轉換為 8BUI 等等，以便更簡單地呈現為可檢視的格式。
  1. rast, nband, reclassexpr, pixeltype, nodataval=NULL
  2. rast, VARIADIC reclassargset
  3. rast, reclassexpr, pixeltype
ST_Union    傳回一組柵格圖塊的聯集，形成一個由一個或多個波段組成的單一柵格。
  1. rast
  2. rast, unionargset
  3. rast, nband
  4. rast, uniontype
  5. rast, nband, uniontype

內建地圖代數回呼函式
ST_Distinct4ma    柵格處理函式，計算鄰近範圍內唯一像素值的數量。
  1. matrix, nodatamode, VARIADIC args
  2. value, pos, VARIADIC userargs
ST_InvDistWeight4ma (value, pos, VARIADIC userargs)    柵格處理函式，根據像素的鄰近範圍內插像素的值。
ST_Max4ma    柵格處理函式，計算鄰近範圍內的最大像素值。
  1. matrix, nodatamode, VARIADIC args
  2. value, pos, VARIADIC userargs
ST_Mean4ma    柵格處理函式，計算鄰近範圍內的平均像素值。
  1. matrix, nodatamode, VARIADIC args
  2. value, pos, VARIADIC userargs
ST_Min4ma    柵格處理函式，計算鄰近範圍內的最小像素值。
  1. matrix, nodatamode, VARIADIC args
  2. value, pos, VARIADIC userargs
ST_MinDist4ma (value, pos, VARIADIC userargs)    柵格處理函式，傳回目標像素與具有值的相鄰像素之間的最小距離（以像素數量為單位）。
ST_Range4ma    柵格處理函式，計算鄰近範圍內像素值的範圍。
  1. matrix, nodatamode, VARIADIC args
  2. value, pos, VARIADIC userargs
ST_StdDev4ma    柵格處理函式，計算鄰近範圍內像素值的標準差。
  1. matrix, nodatamode, VARIADIC args
  2. value, pos, VARIADIC userargs
ST_Sum4ma    柵格處理函式，計算鄰近範圍內所有像素值的總和。
  1. matrix, nodatamode, VARIADIC args
  2. value, pos, VARIADIC userargs

柵格處理：DEM（高程）
ST_Aspect    傳回高程柵格波段的方位角（預設為度）。適用於分析地形。
  1. rast, band=1, pixeltype=32BF, units=DEGREES, interpolate_nodata=FALSE
  2. rast, band, customextent, pixeltype=32BF, units=DEGREES, interpolate_nodata=FALSE
ST_HillShade    使用提供的方位角、高度、亮度和比例輸入，傳回高程柵格波段的假設照明。
  1. rast, band=1, pixeltype=32BF, azimuth=315, altitude=45, max_bright=255, scale=1.0, interpolate_nodata=FALSE
  2. 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    傳回高程柵格波段的坡度（預設為度）。適用於分析地形。
  1. rast, nband=1, pixeltype=32BF, units=DEGREES, scale=1.0, interpolate_nodata=FALSE
  2. 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 )    傳回一個柵格，其中包含計算出的地形粗糙度指數。

柵格處理：柵格至幾何
Box3D (rast)    傳回柵格的包圍盒的 3D 包圍盒表示。
ST_ConvexHull (rast)    傳回柵格的凸包幾何，包括等於 BandNoDataValue 的像素值。對於規則形狀且未傾斜的柵格，這會產生與 ST_Envelope 相同的結果，因此僅適用於不規則形狀或傾斜的柵格。
ST_DumpAsPolygons (rast, band_num=1, exclude_nodata_value=TRUE)    從給定的柵格波段傳回一組 geomval (geom,val) 列。如果未指定波段號碼，波段號碼預設為 1。
ST_Envelope (rast)    傳回柵格範圍的多邊形表示。
ST_MinConvexHull (rast, nband=NULL)    傳回柵格的凸包幾何，不包括 NODATA 像素。
ST_Polygon (rast, band_num=1)    傳回一個由像素聯集形成的多元多邊形幾何，這些像素的像素值不是無資料值。如果未指定波段號碼，波段號碼預設為 1。

柵格運算子
&&    如果 A 的邊界框與 B 的邊界框相交，則傳回 TRUE。
  1. A, B
  2. A, B
  3. B, A
&< (A, B)    如果 A 的邊界框位於 B 的左側，則傳回 TRUE。
&> (A, B)    如果 A 的邊界框位於 B 的右側，則傳回 TRUE。
= (A, B)    如果 A 的邊界框與 B 的邊界框相同，則傳回 TRUE。使用雙精度邊界框。
@    如果 A 的邊界框包含在 B 的邊界框中，則傳回 TRUE。使用雙精度邊界框。
  1. A, B
  2. A, B
  3. B, A
~= (A, B)    如果 A 的邊界框與 B 的邊界框相同，則傳回 TRUE。
~    若 A 的邊界盒包含 B 的邊界盒，則返回 TRUE。 使用雙精度邊界盒。
  1. A, B
  2. A, B
  3. B, A

網格與網格波段空間關係
ST_Contains    若網格 rastB 的任何點都不在網格 rastA 的外部，且 rastB 內部至少有一個點位於 rastA 的內部，則返回 true。
  1. rastA, nbandA, rastB, nbandB
  2. rastA, rastB
ST_ContainsProperly    若 rastB 與 rastA 的內部相交，但不與 rastA 的邊界或外部相交，則返回 true。
  1. rastA, nbandA, rastB, nbandB
  2. rastA, rastB
ST_Covers    若網格 rastB 的任何點都不在網格 rastA 之外，則返回 true。
  1. rastA, nbandA, rastB, nbandB
  2. rastA, rastB
ST_CoveredBy    若網格 rastA 的任何點都不在網格 rastB 之外，則返回 true。
  1. rastA, nbandA, rastB, nbandB
  2. rastA, rastB
ST_Disjoint    若網格 rastA 在空間上不與 rastB 相交，則返回 true。
  1. rastA, nbandA, rastB, nbandB
  2. rastA, rastB
ST_Intersects    若網格 rastA 在空間上與網格 rastB 相交，則返回 true。
  1. rastA, nbandA, rastB, nbandB
  2. rastA, rastB
  3. rast, nband, geommin
  4. rast, geommin, nband=NULL
  5. geommin, rast, nband=NULL
ST_Overlaps    若網格 rastA 和 rastB 相交，但其中一個不完全包含另一個，則返回 true。
  1. rastA, nbandA, rastB, nbandB
  2. rastA, rastB
ST_Touches    若網格 rastA 和 rastB 至少有一個共同點，但它們的內部不相交，則返回 true。
  1. rastA, nbandA, rastB, nbandB
  2. rastA, rastB
ST_SameAlignment    如果網格具有相同的傾斜度、比例、空間參考和偏移量（像素可以放置在同一個網格上而不會切割到像素），則返回 true，如果它們沒有，則返回 false，並提供詳細說明問題的通知。
  1. rastA, rastB
  2. ulx1, uly1, scalex1, scaley1, skewx1, skewy1, ulx2, uly2, scalex2, scaley2, skewx2, skewy2
  3. rastfield agg
ST_NotSameAlignmentReason (rastA, rastB)    返回文本說明網格是否對齊，如果未對齊，則說明原因。
ST_Within    若網格 rastA 的任何點都不在網格 rastB 的外部，且 rastA 內部至少有一個點位於 rastB 的內部，則返回 true。
  1. rastA, nbandA, rastB, nbandB
  2. rastA, rastB
ST_DWithin    若網格 rastA 和 rastB 在彼此指定的距離內，則返回 true。
  1. rastA, nbandA, rastB, nbandB, distance_of_srid
  2. rastA, rastB, distance_of_srid
ST_DFullyWithin    若網格 rastA 和 rastB 完全在彼此指定的距離內，則返回 true。
  1. rastA, nbandA, rastB, nbandB, distance_of_srid
  2. rastA, rastB, distance_of_srid

網格提示