名称

ST_SetM — 返回一个几何图形,其 X/Y 坐标与输入几何图形相同,并且使用请求的重采样算法将栅格中的值复制到 M 维度。

语法

geometry ST_SetM(raster rast, geometry geom, text resample=nearest, integer band=1);

说明

返回一个几何图形,其 X/Y 坐标与输入几何图形相同,并且使用请求的重采样算法将栅格中的值复制到 M 维度。

可以将 resample 参数设置为“nearest”,以复制每个顶点所在的单元格中的值,或设置为“bilinear”,以使用双线性插值计算一个同时考虑相邻单元格的值。

可用性:3.2.0

示例

--
-- 2x2 test raster with values
--
-- 10 50
-- 40 20
--
WITH test_raster AS (
SELECT
ST_SetValues(
  ST_AddBand(
    ST_MakeEmptyRaster(width => 2, height => 2,
      upperleftx => 0, upperlefty => 2,
      scalex => 1.0, scaley => -1.0,
      skewx => 0, skewy => 0, srid => 4326),
    index => 1, pixeltype => '16BSI',
    initialvalue => 0,
    nodataval => -999),
  1,1,1,
  newvalueset =>ARRAY[ARRAY[10.0::float8, 50.0::float8], ARRAY[40.0::float8, 20.0::float8]]) AS rast
)
SELECT
ST_AsText(
  ST_SetM(
    rast,
    band => 1,
    geom => 'SRID=4326;LINESTRING(1.0 1.9, 1.0 0.2)'::geometry,
    resample => 'bilinear'
))
FROM test_raster

            st_astext
----------------------------------
 LINESTRING M (1 1.9 38,1 0.2 27)

另请参见

ST_ValueST_SetZ