ST_Quantile - PolarDB - Alibaba Cloud ドキュメントセンター

ラスタオブジェクトの分位数のピクセル値を照会します。

前提条件

ラスタオブジェクトの分位数は、ST_StatsQuantile関数を使用して計算されます。

構文

setof record ST_Quantile(raster raster_obj,
         float8[] quantiles default NULL,
         cstring bands default '',
         boolean exclude_nodata_value default true,
          out integer band,
         out float8 quantile,
         out float8 value)

パラメーター

パラメーター	説明
raster_obj	ラスターオブジェクトの名前です。
quantiles	ピクセル値を計算する分位数。有効な値: 0.25、0.5、0.75 1つ以上の分位数を指定できます。
bands	バンドのシリアル番号に基づいて、分位数のピクセル値が計算されます。サポートされている形式は、`「0-2」`と`「1、2,3」`です。シリアル番号は0から始まります。デフォルト値: empty string (`''`) 。デフォルト値はすべてのバンドを指定します。
exclude_nodata_value	計算中にNoData値を含めるかどうかを指定します。
band	バンドのシリアル番号を返すように指定します。
quantile	分位数を返すように指定します。
value	ピクセル値を返すように指定します。

例

-- Calculate the pixel value of the 0.25 quantile based on all bands.
SELECT  (ST_Quantile(rast, ARRAY[0.25], '0-2', true)). * FROM rat_quantile WHERE id = 1;
 band | quantile | value 
------+----------+-------
    0 |     0.25 |    11
    1 |     0.25 |    10
    2 |     0.25 |    50
(3 rows)

-- Calculate the pixel values of the 0.25, 0.5, and 0.75 quantiles based on band 0.
SELECT  (ST_Quantile(rast, NULL, '0', true)). * FROM rat_quantile WHERE id = 1;
 band | quantile | value 
------+----------+-------
    0 |     0.25 |    11
    0 |      0.5 |    11
    0 |     0.75 |    65
(3 rows)