ST_SetValue - PolarDB

Topik ini menjelaskan fungsi ST_SetValue, yang mengubah nilai piksel berdasarkan geometri atau baris dan kolom dari raster.

Sintaksis

raster ST_SetValue(raster raster_obj,
                   integer baris,
                   integer kolom,
                   double nilai,
                   integer band);

raster ST_SetValue(raster raster_obj,
         geometry geom,
                double nilai,
            integer band default 0,
                 boolean rebuild_pyd default true,
            cstring setvalueOptions default '');

Parameter

Parameter	Deskripsi
raster_obj	Objek raster yang ditentukan.
baris	Nomor baris dari nilai piksel yang diubah.
kolom	Nomor kolom dari nilai piksel yang diubah.
nilai	Nilai piksel baru.
band	Nomor band dari nilai piksel yang diubah.
rebuild_pyd	Menentukan apakah akan membangun ulang piramida.
setvalueOptions	Opsi perubahan nilai piksel. Nilai parameter ini adalah string JSON. Untuk informasi lebih lanjut, lihat Bidang dalam parameter setvalueOptions.

Tabel 1. Bidang dalam parameter setvalueOptions

Bidang	Tipe	Nilai default	Deskripsi
window_clip	bool	false	Menentukan apakah menggunakan kotak pembatas objek geometri untuk memotong objek raster. true: menggunakan persegi panjang pembatas minimum (MBR) dari objek geometri sebagai wilayah untuk mengubah nilai piksel. false: menggunakan objek geometri sebagai wilayah untuk mengubah nilai piksel.
rast_coord	bool	false	Menentukan apakah geometri input menggunakan koordinat piksel. true: Koordinat piksel digunakan. Koordinat x menentukan nomor kolom piksel dan koordinat y menentukan nomor baris piksel. Nilai valid koordinat x dan y dimulai dari 0. false: Koordinat piksel tidak digunakan.

Contoh

select st_value(rast, 0, 2, 1) from raster_table order by id;

update raster_table set rast=st_setvalue(rast, ST_geomfromtext('MULTIPOINT(0 0, 2 2, 10 10)', 4326),250.0, 0, true);

update raster_table set rast=st_setvalue(rast, ST_geomfromtext('LINESTRING(211 77, 233 100)', 4326), 10.0, 0, false, '{"rast_coord":true}');