文档

ST_BuildPercentiles

更新时间:

计算raster对象中指定波段集的百分比信息。

语法

raster ST_BuildPercentiles(raster raster_obj,
                            cstring sampleOption default '{}')
raster ST_BuildPercentiles(raster raster_obj,
                            cstring bands,
                            cstring sampleOption default '{}',
                            cstring parallelOption default '{}')

参数

参数名称

描述

raster_obj

Raster对象。

sampleOption

基于JSON字符串的采样选项。更多信息,请参见sampleOption

bands

指定的波段序号,从0开始,格式类似'0,1-3,6,8'的形式, ''表示所有的波段。

parallelOption

基于JSON字符串的并行操作选项。更多信息,请参见parallelOption

sampleOption说明:

参数名称

类型

默认值

描述

approx

boolean

false

是否使用采样方式计算。取值:[true|false]

说明

如果为true,则采用采样方式计算统计值,结果可能会不精确。

factor

integer

4

采样方式计算时使用的采样因子。取值为正整数。表示将n个象元作为一个采样单元。

说明

仅在approx为true时有效。

exclusive_nodata

boolean

true

是否不统计nodata数据。取值:[true|false]

parallelOptions是基于JSON格式的字符串,用于描述操作选项。支持的参数如下:

参数名称

描述

类型

默认值

说明

parallel

操作并行度。

integer

ganos.parallel.degree

并行度范围为1~64。

示例

-- 默认方式
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(raster_obj) WHERE id = 1;

-- 指定波段和采样方式
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(rast,'0-2','{"approx":false}') WHERE id = 1;

-- 指定采样方式
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(rast,'{"approx":false}') WHERE id = 1;

-- 指定波段、采样率和并行度
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(raster_obj,'0-2','{"approx":true, "factor":5}', '{"parallel":4}') WHERE id = 1;