計(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;