Menampilkan nilai piksel pada kuantil tertentu untuk objek raster.
Jalankan ST_StatsQuantile pada objek raster sebelum memanggil ST_Quantile. Fungsi ST_Quantile membaca statistik yang telah dihitung sebelumnya alih-alih menghitung ulang.
Sintaksis
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 | Type | Default | Description |
|---|---|---|---|
raster_obj | raster | — | Objek raster yang akan ditanyakan. |
quantiles | float8[] | NULL | Kuantil yang akan dihitung. Nilai yang valid: 0.25, 0.5, dan 0.75. Tentukan satu atau beberapa nilai sebagai array. Jika NULL, ketiga kuantil tersebut (0.25, 0.5, 0.75) dikembalikan. |
bands | cstring | '' | Band yang akan disertakan. Gunakan '0-2' untuk rentang atau '1,2,3' untuk band individual. Nomor seri band dimulai dari 0. String kosong memilih semua band. |
exclude_nodata_value | boolean | true | Menentukan apakah piksel NoData dikecualikan dari perhitungan. |
band (out) | integer | — | Nomor seri band. |
quantile (out) | float8 | — | Nilai kuantil. |
value (out) | float8 | — | Nilai piksel pada kuantil tersebut. |
Contoh
Semua contoh menggunakan tabel rat_quantile dan mengekspansi hasil setof record dengan .*.
Menampilkan nilai piksel pada kuantil 0,25 di semua band.
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)Menampilkan nilai piksel pada kuantil 0,25; 0,5; dan 0,75 untuk band 0.
Meneruskan NULL ke parameter quantiles akan mengembalikan ketiga kuantil umum tersebut.
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)