計(jì)算一個(gè)raster對(duì)象的所有統(tǒng)計(jì)值信息，包括直方圖和百分比。

語(yǔ)法

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

參數(shù)

參數(shù)名稱(chēng) 描述
raster_obj Raster對(duì)象。
sampleOption 基于JSON字符串的采樣選項(xiàng)。更多信息，請(qǐng)參見(jiàn)sampleOption。
bands 指定的波段序號(hào)，從0開(kāi)始，格式類(lèi)似'0,1-3,6,8'的形式, ''表示所有的波段。
parallelOption 基于JSON字符串的并行操作選項(xiàng)。更多信息，請(qǐng)參見(jiàn)parallelOption。
sampleOption說(shuō)明：
參數(shù)名稱(chēng) 類(lèi)型 默認(rèn)值 描述
approx boolean false 是否使用采樣方式計(jì)算。取值：[true|false]
說(shuō)明 如果為true，則采用采樣方式計(jì)算統(tǒng)計(jì)值，結(jié)果可能會(huì)不精確。
factor integer 4 采樣方式計(jì)算時(shí)使用的采樣因子。取值為正整數(shù)。表示將n個(gè)象元作為一個(gè)采樣單元。
說(shuō)明 僅在approx為true時(shí)有效。
exclusive_nodata boolean true 是否不統(tǒng)計(jì)nodata數(shù)據(jù)。取值：[true|false]

parallelOptions是基于JSON格式的字符串，用于描述操作選項(xiàng)。支持的參數(shù)如下：

參數(shù)名稱(chēng) 描述 類(lèi)型 默認(rèn)值 說(shuō)明
parallel 操作并行度。 integer ganos.parallel.degree 并行度范圍為1~64。

示例

-- 默認(rèn)方式
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(raster_obj) WHERE id = 1;

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

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

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