Mengembalikan nilai piksel pada kuantil yang ditentukan untuk objek raster.
Prasyarat
Jalankan ST_StatsQuantile untuk menghitung kuantil objek raster sebelum memanggil ST_Quantile.
Sintaks
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)Parameter
Parameter input
| Parameter | Tipe | Bawaan | Deskripsi |
|---|---|---|---|
raster_obj | raster | — | Objek raster yang akan dikueri. |
quantiles | float8[] | NULL | Kuantil yang akan dikembalikan. Nilai yang valid: 0.25, 0.5, dan 0.75. Berikan NULL untuk mengembalikan ketiga kuantil tersebut. |
bands | cstring | '' | Nomor seri band yang akan disertakan. Format yang didukung: '0-2' (rentang) dan '1,2,3' (daftar). Nomor seri dimulai dari 0. String kosong (bawaan) menyertakan semua band. |
exclude_nodata_value | boolean | true | Menentukan apakah nilai NoData dikecualikan dari kueri. |
Parameter output
| Parameter | Tipe | Deskripsi |
|---|---|---|
band | integer | Nomor seri band. |
quantile | float8 | Nilai kuantil. |
value | float8 | Nilai piksel pada kuantil tersebut. |
Contoh
Contoh 1: Mengembalikan nilai piksel pada kuantil 0,25 untuk semua band (band 0–2).
SELECT (ST_Quantile(rast, ARRAY[0.25], '0-2', true)).* FROM rat_quantile WHERE id = 1;Output:
band | quantile | value
------+----------+-------
0 | 0.25 | 11
1 | 0.25 | 10
2 | 0.25 | 50
(3 rows)Contoh 2: Mengembalikan nilai piksel pada semua kuantil (0,25; 0,5; 0,75) untuk band 0.
SELECT (ST_Quantile(rast, NULL, '0', true)).* FROM rat_quantile WHERE id = 1;Output:
band | quantile | value
------+----------+-------
0 | 0.25 | 11
0 | 0.5 | 11
0 | 0.75 | 65
(3 rows)