栅格管理 |
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 返回 PostGIS 支持的栅格格式列表。 ST_AsGDALRaster 仅可使用 can_write=True 的格式 |
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 维点集插值网格表面,使用 X 和 Y 值在网格上定位点,并使用点的 Z 值作为表面高程。 |
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
返回一个空白栅格(不包含波段),其具有给定的尺寸(宽度和高度)、左上角 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
返回指定列 x、行 y 像素或特定几何点处给定波段的值。波段编号从 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
返回给定波段像素周围非 NODATA 值的二维双精度数组,该给定波段像素由 columnX 和 rowY 或以与栅格相同的空间参考坐标系表示的几何点指定。
- 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
返回修改后的栅格,其结果是将给定波段中的值设置为指定列x、行y像素或与特定几何图形相交的像素。波段编号从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
获取指定 band(波段) 的值作为二维数组。
- rast, nband=NULL, exclude_nodata_value=true
- rast, nband, exclude_nodata_value=true
|
ST_PixelOfValue
获取值等于搜索值的像素的列x、行y坐标。
- 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
在一次调用中设置 Georeference 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 表中定义的特定整数 srid。 |
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、Cubic、CubicSpline、 Lanczos、Max或Min重采样算法计算的。 默认为NearestNeighbor。
- rast, scalexy, algorithm=NearestNeighbor, maxerr=0.125
- rast, scalex, scaley, algorithm=NearestNeighbor, maxerr=0.125
|
ST_Reskew
通过仅调整栅格的倾斜(或旋转参数)来重采样栅格。 新的像素值是使用 NearestNeighbor(英语或美式拼写)、Bilinear、Cubic、CubicSpline或 Lanczos 重采样算法计算的。 默认为NearestNeighbor。
- rast, skewxy, algorithm=NearestNeighbor, maxerr=0.125
- rast, skewx, skewy, algorithm=NearestNeighbor, maxerr=0.125
|
ST_SnapToGrid
通过将栅格捕捉到网格来重采样栅格。 新的像素值是使用NearestNeighbor(英语或美式拼写)、Bilinear, Cubic, CubicSpline 或 Lanczos 重采样算法计算的。 默认为NearestNeighbor。
- 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、Cubic、CubicSpline、Lanczos(默认为 NearestNeighbor)。
- 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
返回栅格或栅格覆盖范围的给定波段中的像素数。 如果未指定 band,则默认为 band 1。如果 except_nodata_value 设置为 true,则仅计算不等于 nodata 值的像素。
- rast, nband=1, exclude_nodata_value=true
- rast, exclude_nodata_value
|
ST_CountAgg
总计的。 返回一组栅格的给定波段中的像素数。 如果未指定 band,则默认为 band 1。如果 except_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。默认情况下,不计算节点数据值像素。 输出像素中的所有其他值,并将像素带值四舍五入到最接近的整数。
- 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
返回栅格的熟知的二进制 (WKB) 表示形式。
- rast, outasin=FALSE
- rast, outasin=FALSE
|
ST_AsHexWKB
(rast, outasin=FALSE)
返回栅格的十六进制表示形式的熟知的二进制 (WKB)。 |
ST_AsGDALRaster
(rast, format, options=NULL, srid=sameassource)
以指定的 GDAL 栅格格式返回栅格图块。 栅格格式是编译库支持的格式之一。 使用 ST_GDALDrivers() 获取您的库支持的格式列表。 |
ST_AsJPEG
将栅格图块选定的波段作为单个联合摄影导出组 (JPEG) 图像(字节数组)返回。 如果未指定波段且有 1 个或 3 个以上波段,则仅使用第一个波段。 如果只有 3 个波段,则使用所有 3 个波段并将其映射到 RGB。
- rast, options=NULL
- rast, nband, quality
- rast, nband, options=NULL
- rast, nbands, options=NULL
- rast, nbands, quality
|
ST_AsPNG
将栅格图块选定的波段作为单个便携式网络图形 (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
Returns the raster clipped by the input geometry. If band number is not specified, all bands are processed. If crop is not specified or TRUE, the output raster is cropped. If touched is set to TRUE, then touched pixels are included, otherwise only if the center of the pixel is in the geometry it is included.
- 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
根据源栅格和指定波段创建最多四个 8BUI 波段(灰度、RGB、RGBA)的新栅格。 如果未指定,则假定为波段 1。
- rast, nband=1, colormap=grayscale, method=INTERPOLATE
- rast, colormap, method=INTERPOLATE
|
ST_Grayscale
根据源栅格和代表红色、绿色和蓝色的指定波段创建新的 1-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。
- rast, band, pixeltype, expression, nodataval=NULL
- rast, pixeltype, expression, nodataval=NULL
|
ST_MapAlgebraExpr
2 栅格波段版本:通过对提供的两个输入栅格波段和像素类型应用有效的 PostgreSQL 代数运算来创建新的单波段栅格。 如果未指定波段编号,则假定每个栅格的波段 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。
- 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 波段版本 - 通过在提供的 2 个输入栅格波段和像素类型上应用有效的 PostgreSQL 函数来创建新的单波段栅格。 如果未指定波段,则假定为波段 1。 如果未指定,范围类型默认为 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 函数映射代数最近邻。 返回一个栅格,其值是涉及输入栅格波段值的邻域的 PLPGSQL 用户函数的结果。 |
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 )
返回一个计算出的地形位置指数(Topographic Position Index)的栅格。 |
ST_TRI
(rast, nband, customextent, pixeltype="32BF", interpolate_nodata=FALSE )
返回具有计算的地形坚固性指数的栅格。 |
栅格和栅格波段空间关系 |
ST_Contains
如果栅格 rastB 中没有点位于栅格 rastA 的外部且 rastB 的内部至少有一个点位于 rastA 的内部,则返回 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
|