Mengembalikan geometri titik untuk setiap piksel raster, lengkap dengan nilai piksel, baris, kolom, dan band. Secara default, koordinat titik sesuai dengan pojok kiri atas (upper-left corner) setiap piksel.
Sintaksis
setof record ST_PixelAsPoints(raster raster_obj,
integer band default 0,
integer pyramid default 0,
boolean exclude_nodata_value default true,
cstring ref_point default 'UPPERLEFT',
out integer rowsn,
out integer columnsn,
out integer bandsn,
out double value,
out geometry geom);Parameter
| Parameter | Tipe | Default | Deskripsi |
|---|---|---|---|
raster_obj | raster | — | Raster yang akan dikueri. |
band | integer | 0 | Band yang akan dikueri. ID band dimulai dari 0. |
pyramid | integer | 0 | Level piramida yang akan dikueri. |
exclude_nodata_value | boolean | true | Menentukan apakah piksel NoData dikecualikan atau tidak. |
ref_point | cstring | 'UPPERLEFT' | Pojok piksel yang direpresentasikan oleh geometri titik yang dikembalikan. Nilai yang valid: UPPERLEFT (pojok kiri atas) dan CENTER (pusat). |
rowsn | integer | — | Output. Nomor baris piksel. |
columnsn | integer | — | Output. Nomor kolom piksel. |
bandsn | integer | — | Output. ID band piksel. |
value | double | — | Output. Nilai piksel. |
geom | geometry | — | Output. Luasan spasial piksel. |
Deskripsi
ST_PixelAsPoints mengonversi setiap piksel dalam raster menjadi catatan yang berisi rowsn (baris), columnsn (kolom), bandsn (ID band), value (nilai piksel), dan geom (geometri titik). Parameter ref_point menentukan pojok piksel mana yang direpresentasikan oleh geometri titik—UPPERLEFT atau CENTER.
Contoh
Contoh berikut mengambil semua piksel dari band 1 raster dengan id = 10, lalu memfilter piksel yang nilainya lebih besar dari 38.0.
WITH tmp AS (
SELECT (ST_PixelAsPoints(rast, 1)).*
FROM rast_table
WHERE id = 10 )
SELECT rowsn, columnsn, bandsn, value, ST_AsEWKT(geom) FROM tmp WHERE value > 38.0;
----------------------------------------------------
100 | 100 | 0 | 43 | SRID=4326;POINT(-90 0)Pola (ST_PixelAsPoints(...)).* memperluas setof record yang dikembalikan menjadi kolom-kolom individual, sehingga dapat difilter dan dipilih dalam query luar.