获取raster对象的某一个波段的统计信息，或根据一个multipoint获取对应的统计信息。

语法

  • 语法1：
    TEXT ST_Statistics(raster raster_obj, integer band);
  • 语法2：
    SETOF RECORD ST_Statistics(raster raster_object,
    geometry multipoint,
    integer band default 0,
    cstring statics_range default '',
    out cstring name,
    out integer band,
    out float8 min,
    out float8 max,
    out float8 mean,
    out float8 sum,
    out float8 count,
    out float8 std,
    out float8 median,
    out float8 mode);

参数

参数名称 描述
raster_obj Raster对象。
band 波段序号，从0开始。
multipoint 几何对象，必须为MultiPoint类型，Point中x和y分别表示栅格中的列号和行号。如果有M值则表示对应的权重。
stats_range 用于描述统计区段，表示原始像素值范围，可以有一个或多个数值构成，中间用英文逗号（,）进行分隔 。
起始和结束支持指定开闭域关系，例如[300,400,500)， (300,400,500]，边界符号含义如下：
  • (表示大于。
  • )表示小于。
  • [表示大于等于。
  • ]表示小于等于。

默认值：(]，表示空区间。

name 范围名称。
  • 表示全部像素：full。
  • 区间范围：(300, 400]。
min 最小值。
max 最大值。
mean 平均值。
sum 和。
count 数量。
std 标准差。
median 中位数。
mode 众数。

描述

  • 语法1：获取raster对象的某一个波段的统计信息的JSON格式。如果不存在统计值，则返回空值。
  • 语法2：根据一个multipoint获取对应的统计信息，其中，X表示列号，Y表示行号，如果有M值表示对应的权重信息。

示例

select ST_Statistics(raster_obj, 0) from raster_table where id=1;

__________________________________
'{    "min" : 0.00, "max" : 255.00,"mean" : 125.00,"std" : 23.123,"approx" : false}'


-- No range
select (ST_Statistics(raster_obj, 'MultiPoint((0 0 10), (100 100 50), (199 199 100))'::geometry, 0)).*
from raster_table where id=1;

name | band | min | max | mean     | sum   | count |        std       | median | mode
--------------------------------------------------------------------------------------
full |    2 |  47 | 196 | 140.3125 | 22450 |   160 | 71.8955133770529 |     47 |  196

-- with range
select (ST_Statistics(raster_obj, 'MultiPoint((0 0 10), (100 100 50), (199 199 100))'::geometry, 0, '(0, 10, 20,100,1000]')).*
from raster_table
where id=1;

    name    | band | min | max | mean             | sum | count |        std       | median | mode
--------------------------------------------------------------------------------------
 full       |    0 |   1 | 202 |               82 | 246 |     3 | 86.5678924313166 |    202 |    1
 (0-10]     |    0 |   1 |   1 |                1 |   1 |     1 |                0 |      1 |    1
 (10-20]    |    0 |     |     |                  |     |       |                  |        |
 (20-100]   |    0 |  43 |  43 |               43 |  43 |     1 |                0 |     43 |   43
 (100-1000] |    0 | 202 | 202 |              202 | 202 |     1 |                0 |    202 |  202