名称

ST_Reclass — 创建一个新的光栅,其中包含从原始光栅重新分类的波段类型。nband 是要更改的波段。如果未指定 nband,则假定为 1。所有其他波段将保持不变。用例:将 16BUI 波段转换为 8BUI,依此类推,以便以可视格式进行更简单的渲染。

语法

光栅 ST_Reclass(光栅 rast,整数 nband,文本 reclassexpr,文本 pixeltype,双精度 nodataval=NULL);

光栅 ST_Reclass(光栅 rast,reclassarg[] VARIADIC reclassargset);

光栅 ST_Reclass(光栅 rast,文本 reclassexpr,文本 pixeltype);

描述

创建一个新的光栅,方法是对输入光栅 (rast) 应用由 reclassexpr 定义的有效 PostgreSQL 代数运算。如果未指定 band,则假定为波段 1。新光栅将具有与原始光栅相同的地理参考、宽度和高度。未指定的波段将保持不变。有关有效重分类表达式的说明,请参阅 reclassarg

新光栅的波段将具有 pixeltype 的像素类型。如果传入 reclassargset,则每个 reclassarg 定义生成的每个波段的行为。

可用性:2.0.0

示例基本

从原始光栅创建一个新的光栅,其中波段 2 从 8BUI 转换为 4BUI,并且所有值从 101-254 设置为 nodata 值。

ALTER TABLE dummy_rast ADD COLUMN reclass_rast raster;
UPDATE dummy_rast SET reclass_rast = ST_Reclass(rast,2,'0-87:1-10, 88-100:11-15, 101-254:0-0', '4BUI',0) WHERE rid = 2;

SELECT i as col, j as row, ST_Value(rast,2,i,j) As origval,
    ST_Value(reclass_rast, 2, i, j) As reclassval,
    ST_Value(reclass_rast, 2, i, j, false) As reclassval_include_nodata
FROM dummy_rast CROSS JOIN generate_series(1, 3) AS i CROSS JOIN generate_series(1,3) AS j
WHERE rid = 2;

 col | row | origval | reclassval | reclassval_include_nodata
-----+-----+---------+------------+---------------------------
   1 |   1 |      78 |          9 |                         9
   2 |   1 |      98 |         14 |                        14
   3 |   1 |     122 |            |                         0
   1 |   2 |      96 |         14 |                        14
   2 |   2 |     118 |            |                         0
   3 |   2 |     180 |            |                         0
   1 |   3 |      99 |         15 |                        15
   2 |   3 |     112 |            |                         0
   3 |   3 |     169 |            |                         0
                    

示例:使用多个 reclassarg 进行高级操作

从原始光栅创建一个新的光栅,其中波段 1、2、3 分别转换为 1BB、4BUI、4BUI 并进行重新分类。请注意,这使用了可变 reclassarg 参数,该参数可以接受无限数量的 reclassarg 作为输入(理论上与您拥有的波段一样多)

UPDATE dummy_rast SET reclass_rast =
    ST_Reclass(rast,
        ROW(2,'0-87]:1-10, (87-100]:11-15, (101-254]:0-0', '4BUI',NULL)::reclassarg,
        ROW(1,'0-253]:1, 254:0', '1BB', NULL)::reclassarg,
        ROW(3,'0-70]:1, (70-86:2, [86-150):3, [150-255:4', '4BUI', NULL)::reclassarg
        ) WHERE rid = 2;

SELECT i as col, j as row,ST_Value(rast,1,i,j) As ov1,  ST_Value(reclass_rast, 1, i, j) As rv1,
    ST_Value(rast,2,i,j) As ov2, ST_Value(reclass_rast, 2, i, j) As rv2,
    ST_Value(rast,3,i,j) As ov3, ST_Value(reclass_rast, 3, i, j) As rv3
FROM dummy_rast CROSS JOIN generate_series(1, 3) AS i CROSS JOIN generate_series(1,3) AS j
WHERE rid = 2;

col | row | ov1 | rv1 | ov2 | rv2 | ov3 | rv3
----+-----+-----+-----+-----+-----+-----+-----
  1 |   1 | 253 |   1 |  78 |   9 |  70 |   1
  2 |   1 | 254 |   0 |  98 |  14 |  86 |   3
  3 |   1 | 253 |   1 | 122 |   0 | 100 |   3
  1 |   2 | 253 |   1 |  96 |  14 |  80 |   2
  2 |   2 | 254 |   0 | 118 |   0 | 108 |   3
  3 |   2 | 254 |   0 | 180 |   0 | 162 |   4
  1 |   3 | 250 |   1 |  99 |  15 |  90 |   3
  2 |   3 | 254 |   0 | 112 |   0 | 108 |   3
  3 |   3 | 254 |   0 | 169 |   0 | 175 |   4
                    

示例:高级将单个波段 32BF 光栅映射到多个可视波段

从仅具有一个 32bf 波段的光栅创建一个新的 3 波段(8BUI、8BUI、8BUI 可视光栅)

ALTER TABLE wind ADD COLUMN rast_view raster;
UPDATE wind
    set rast_view = ST_AddBand( NULL,
        ARRAY[
    ST_Reclass(rast, 1,'0.1-10]:1-10,9-10]:11,(11-33:0'::text, '8BUI'::text,0),
    ST_Reclass(rast,1, '11-33):0-255,[0-32:0,(34-1000:0'::text, '8BUI'::text,0),
    ST_Reclass(rast,1,'0-32]:0,(32-100:100-255'::text, '8BUI'::text,0)
    ]
    );
                    

另请参阅

ST_AddBandST_BandST_BandPixelTypeST_MakeEmptyRasterreclassargST_Value