Mengonversi piksel pada posisi tertentu dalam suatu raster menjadi objek geometri, masing-masing direpresentasikan oleh satu titik pada posisi referensi di dalam objek geometri tersebut.
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 | Type | Default | Description |
|---|---|---|---|
raster_obj | raster | — | Raster yang akan dikueri. |
band | integer | 0 | ID band yang akan dikueri. ID band yang valid dimulai dari 0. |
pyramid | integer | 0 | ID level piramida yang akan dikueri. |
exclude_nodata_value | boolean | true | Menentukan apakah piksel NoData akan dikecualikan. |
ref_point | cstring | 'UPPERLEFT' | Posisi referensi titik di dalam objek geometri. Nilai yang valid: UPPERLEFT (sudut kiri atas) dan CENTER (tengah). |
rowsn | out integer | — | Nomor baris piksel. |
columnsn | out integer | — | Nomor kolom piksel. |
bandsn | out integer | — | ID band piksel. |
value | out double | — | Nilai piksel. |
geom | out geometry | — | Cakupan spasial piksel. |
Deskripsi
ST_PixelAsPoints mengonversi piksel pada posisi tertentu dalam suatu raster menjadi objek geometri. Setiap objek geometri direpresentasikan oleh satu titik yang diposisikan sesuai dengan parameter ref_point—baik pada sudut kiri atas (UPPERLEFT) maupun pusat (CENTER) geometri piksel.
Contoh
Contoh berikut mengambil semua piksel pada band 1 dari raster dengan id = 10, memfilter piksel yang memiliki nilai lebih besar dari 38.0, serta mengembalikan nomor baris, kolom, band, nilai, dan geometri setiap piksel dalam format Extended WKT.
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;Output:
rowsn | columnsn | bandsn | value | st_asewkt
-------+----------+--------+-------+---------------------------
100 | 100 | 0 | 43 | SRID=4326;POINT(-90 0)